Using the Sun Java Communications Suite 6 VMware Image

Update: This version of the Sun Java Communications Suite VMware image is no longer available. See Communication Suite Virtual Images for information on obtaining a current version.

Using the Sun Java Communications Suite 6 VMware Image

This article contains the following sections:

Overview of the Communications Suite VMware Image

A VMware image is a simple and portable method for demonstrating Communications Suite 6 features without the overhead of installation and configuration. This VMware image is intended only for demonstration or evaluation purposes and not for production use.

The virtual machine contains a fully configured setup of Communications Suite 6 in the example domain varrius.org. The domain varrius.org is a registered domain that belongs to Sun Microsystems, Inc. The VMware image provides the following services:

  • POP3
  • IMAP
  • SMTP
  • Convergence Web Client
  • Calendaring
  • Instant Messaging
  • Communications Express Web Client

These services are provided by the following Communications Suite 6 components:

  • Messaging Server 7.0
  • Instant Messaging 7.3
  • Calendar Server 6.3
  • Convergence 1.0

Supporting infrastructure for these services includes the following components:

  • Sun Java Systems Directory Server Enterprise Edition 6.X
  • Sun Java Systems Application Server 9.1 update 1
  • Sun Java Systems Access Manager 7.X

Image Details

  • Image Name: SunJava_Comms_Suite6_VM
  • Image Format: zip
  • Image Size:Approximately 3.5 GB

System Requirements

  • OS:
    • Windows: XP Professional SP 2 or Windows Vista
    • Linux: Kernel 2.6.15 or better
    • Mac: OS X 10.5 or better
  • Memory: At least 2 GB RAM (Virtual Machine uses 1 GB RAM)
  • Disk Space Required: 12 GB free space.
  • VMPlayer Software:
    • VMPlayer 1.0.5 or better for Linux or for Windows
    • VMWare Workstation 5.5 or better for Linux or for Windows
    • VMWare Fusion 1.1 or better for Mac

Image Contents

  • A zipped copy of the virtual machine
  • Communications Suite 6 distribution
  • VMplayer for Windows
  • VMplayer for Linux

Software Included in the Zip Archive

  • SunJava_Comms_Suite6_VM: This directory contains the latest set of components for the virtual machine.
  • Software: This directory contains a cache of the platform-specific version of VMPlayer.

You can download additional sofware at: http://vmware.com/download/player or select a cached copy provided.

Virtual Machine Details

  • OS:Solaris 10 08/07 (Solaris 10 update 4)
  • Network Address Assignment: DHCP
  • Hostname: chimaera.varrius.org
  • Networking Type: Bridged
  • Solaris 10 Network Interface: pcn0 configured for DHCP
  • A private DNS server to localize varrius.org

Special Note about Network Address Assignment

The virtual machine is configured to obtain its IP address via DHCP. This means that you might need to register the Ethernet address of this machine with your DHCP service.

In cases where a site is not configured to serve out DHCP addresses, there are two options:

  1. Use the DHCP server provided by the VMware software by changing the Virtual Machine to use NAT.
  2. Assign a permanent IP address to the Virtual Machine and modify the Solaris OS 10 operation system to update that information.

Downloading the Image

The VMware image is available on the Communications Suite 6 Download site, in three parts (under Optional Files), named: SunJava_Comms_Suite6_VM-part-#.zip, where '#' is a number from 1 to 3.

  1. Download all three zip files from the following location: TBD.
  2. Unzip the zip files into a target directory for your virtual machine. Each of the three zip archives has the following structure: 
            SunJava_Comms_Suite6_VM

            !
            !-------fileX
            !-------fileY
            !-------fileZ

    where fileX, fileY, and fileZ are component files that store the virtual machine.
    VMware Image Zip-file MD5 Checksums:

        ace2e189eea313777e13fde34985edbf:SunJava_Comms_Suite6_VM-part-1.zip
    ce65ca595265b5f6320bde701e719de3:SunJava_Comms_Suite6_VM-part-2.zip
    4825dafa35b4fd8b05d7a5cda9771786:SunJava_Comms_Suite6_VM-part-3.zip
  3. Are you installing on a UNIX platform?
    If yes, continue with this step. If no, continue with the next step.
    For UNIX platforms, use the unzip command to extract the three zip files into a target subdirectory. This creates a top-level directory for the virtual machine and extract files into that directory. 
            $ mkdir -p /vmware/machines
        $ unzip SunJava_Comms_Suite6_VM-part-1.zip -d /vmware/machines
        $ unzip SunJava_Comms_Suite6_VM-part-2.zip -d /vmware/machines
        $ unzip SunJava_Comms_Suite6_VM-part-3.zip -d /vmware/machines
  4. For Windows platforms, use the unzip command to extract the three zip files into a target subdirectory. This creates a top-level directory for the virtual machine and extract files into that directory. 
            unzip SunJava_Comms_Suite6_VM-part-1.zip
        unzip SunJava_Comms_Suite6_VM-part-2.zip
        unzip SunJava_Comms_Suite6_VM-part-3.zip

How to Use the Virtual Machine

  1. Start the VMware software.
  2. Click File->Open to select and open the newly packed virtual machine.
  3. Log in to the Virtual Machine root without a password.
    You are prompted to set a new root password.
  4. Set the root password to suit your site security policy
  5. Log in again and click the Firefox icon.
  6. The Start page contains more information on accessing the demo software.
    You are now on your way to evaluating your new Communications Suite 6 deployment.

Known Issues

Missing Instant Messaging Panel in Convergence / Convergence IM Panel in Perpetual "Connecting" Mode

In the current version of the Communications Suite 6 VMware image, the Instant Mesaging panel in the three-panel view of Convergence might be missing. Or, if the Instant Messaging panel is present, it might display a perpetual "connecting" status regardless of the logged-in user.

Workaround

To properly activate the Instant Messaging panel, you need to:

  • Assign the user to Instant Messaging services by using the imadmin assign_services command.
  • Use the correct HTTPBIND jid to connect to the Instant Messaging server.

Run the following script to fix both issues.

Note

The first command in the script ensures that the HTTPBIND jid is the same in both the Instant Messaging server's iim.conf file and the Convergence server's httpbind.conf file. The second command assigns Instant Messaging services to users in the domain. 


#!/bin/bash
perl -i.old -p -e \
         's/chimaera\.(.*?).varrius.org/\1.chimaera.varrius.org/g' \
         /opt/sun/comms/iwc/config/httpbind.conf

echo o=varrius.org,dc=varrius,dc=org \
         | /opt/sun/comms/im/sbin/imadmin assign_services
/etc/init.d/SUNWappserver restart

/etc/init.d/xmpp stop
sleep 30
/etc/init.d/xmpp start

Sun_MsgSvr script updates

The /etc/init.d/Sun_MsgSvr script has a special code in it to update the configuration with any new IP addresses assigned to the virtual machine. Portions of that startup script were hardcoded with a specific device name for the interface and as such causes problems when the device name changes for any reason. (For instance after installation of the VMware Tools).

A new release of the init script is avaliable here and corrects this issue.

Labels

installing installing Delete
vmware vmware Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Sign up or Log in to add a comment or watch this page.


The individuals who post here are part of the extended Sun Microsystems community and they might not be employed or in any way formally affiliated with Sun Microsystems. The opinions expressed here are their own, are not necessarily reviewed in advance by anyone but the individual authors, and neither Sun nor any other party necessarily agrees with them.

Copyright 1994-2009 Sun Microsystems, Inc.
Powered by Atlassian Confluence Sun Guidelines on Public Discourse Privacy Policy Terms of Use Trademarks Site Map Employment Investor Relations Contact