IBM Lotus Instant Messaging and Web Conferencing for AIX (Sametime 6.5.1) Readme

Last update: March 8, 2004


Sections in this document

Getting Started

CD-ROM Contents

System Requirements

Installation Notes 

Setting Up SSL on AIX 

Known Problems and Recommendations


Getting Started

Note  The information in this Readme file might have been updated since your media was created. Visit the online documentation library for Sametime 6.5.1 to view the latest information. Updates to documentation about early preview or beta releases will be sent directly to those who require them.

Read the following information to get started with IBM Lotus Sametime on AIX:

                     The Sametime 6.5.1 for AIX Installation Guide provides information about installing and configuring a Sametime server. It also includes several AIX-specific Administration topics.
 
The Installation Guide (Stinstall.pdf) is available on the Sametime Volume 1 CD-ROM in the /Docs directory. After you install Sametime on your system, the database version of the Installation Guide (stinstall.nsf) is available in the doc subdirectory of your Sametime server's data directory.
   

                     The Sametime 6.5.1 Release Notes were prepared for Sametime 6.5.1 on Win NT/ Win 2K. Although the Release Notes have not been updated specifically for AIX, many topics are useful and relevant for AIX customers.
 
The Release Notes (Strn651.pdf) are available on the Sametime Volume 1 CD-ROM in the /Docs directory. After you install Sametime on your system, the database version of the Release Notes (strn651.nsf) is available in the doc subdirectory of your Sametime server's data directory.
 

                     The Sametime Administrator's Guide provides information about managing your Sametime server. Consult the Sametime 6.5.1 for AIX Installation Guide and this Readme file for topics that are unique for AIX. You may also go to \CD1\Docs\AdminGuideLocation.txt file for more information.

Note: You can find the administration guide in \Languagepack\<language>\data\doc\sthelpad.nsf.

                    The Lotus Sametime Conversion Services Setup Guide (stconv.pdf) is available on the Sametime Volume 2 CD-ROM in the /STConv directory.
 
Lotus Sametime Conversion Services is an optional component of Lotus Sametime that allows the Sametime server to display meeting attachments on the whiteboard. See the Setup Guide for more information.
 

Note  Many of the documents are provided on the product CD-ROM in Adobe Portable Document Format [PDF). The PDF files can be browsed with an Adobe Acrobat Reader. If you have not already installed Acrobat Reader, you can download the most current version of the reader from the Adobe Web site at www.adobe.com.

back to top


CD-ROM Contents

The contents of each directory on the two Sametime 6.5.1 for AIX CDs is listed below.

Sametime 6.5.1 for AIX, Volume 1

/ (root): this Readme file and install script

/Server: the Sametime 6.5.1 base product

/Languagepack: translated files for language installations

/ReleaseNotes: release notes from the Windows NT Sametime 6.5.1 release (many also apply to the AIX version) and Asia language release notes.

/Docs: contains the following documents:

                     Stinstall.pdf: Sametime 6.5.1 for AIX Installation Guide

                     Strn651.pdf: Sametime 6.5.1 Release Notes

                     AdminGuideLocation.txt:  Reference to the Administrator's Guide  

Sametime 6.5.1 for AIX, Volume 2

/ (root): this Readme file

/Client: language versions of the Sametime Connect client

/CommunityMux: files for installing a Community Services multiplexer on a separate AIX system

/LAP:IBM Licensing tool: Exchange and possibly other Windows installs need the LAP tool to install Sametime properly

/TrueTypeFonts: additional font files for DBCS systems

/Docs: contains the following document:

ConnectReadme_xx.txt: Sametime Client Connect Readme

securedesktop_readme.txt: Sametime Installer for Secure Desktops Readme

/Exchange: installation files for Sametime Meeting Scheduling for Microsoft Exchange

/GSKit: the IBM Global Security Kit needed for managing SSL certificates in an SSL environment

/STConv: contains the following files:

                     stconv.pdf: Lotus Sametime Attachment Conversion Services Setup Guide

                     stconv.exe: Installation package for Sametime Conversion Services

/SecureDesktop: contains the files needed for Secure Desktop

/SIPConnector: contains the files needed for SIP Connector

back to top


System Requirements

See the Sametime 6.5.1 for AIX Installation Guide (stinstall.nsf or Stinstall.pdf) for the basic list of Sametime server and workstation requirements. The following items are additional requirements not listed in the Installation Guide:

         Sametime 6.5.1 for AIX uses a graphical installation program which is based on Java. This program requires a Java Runtime Environment (JRE) of version 1.1.4 or higher.

         Running the installation program requires access to an X Window interface. The installation program will not run from a telnet session.

         To install Sametime 6.5.1 for AIX, you must be logged in as root along with root’s environment settings. To start Sametime properly, you must be logged in as the Notes user, along with the Notes user’s environment settings. If switching from root to the Notes user to start the server, be sure to include the command line switch "-" to switch the environment settings. For example: su - notes

         2GB to 10GB of free disk space is recommended to allow space for converted documents and temp files.

Minimum hardware requirements

         RS/6000 43P Model 260m

         1Gb RAM

         2Gb swap space

In the Sametime 6.5.1 for AIX Installation Guide on page 11, in Table 2 (Operating system and browser support), JVM1.4.2 is only listed to support Redhat Linux, and isn't listed to support Win32 and other Unix platforms.

Since JVM1.4.2 is supported, JVM1.4.2 should be added in the support table for the following:

                     Internet Explore 6 on Windows 2000 Professional

                     Internet Explore 6 on Windows XP Professional.

                     Mozilla 1.4.1 on Solaris 8

                     Mozilla 1.4.1 on Windows 2000 Professional

                     Mozilla 1.4.1 on Windows XP Professional

back to top


Installation Notes

This section contains additional information that you need to know about installing Sametime 6.5.1 for AIX.

Pre-Installation Configuration

The installation does not automatically check to ensure that your computer has the disk space necessary to install Sametime. Before installing Sametime, manually check your system to be sure that it has adequate disk space. See the Sametime 6.5.1 for AIX Installation Guide for the required amount of disk space.

Ensure that Domino 6.5.1 has been installed and successfully started before installing Sametime. Stop Domino before installing Sametime.

Note: Domino 6.0.3 is the minimum version of Domino that may be used.

Command Line Install

Some AIX machines may experience problems with Sametime's graphical java installer. There is a script-based command line install option that can be used if you are not able to complete installation of Sametime using the graphical java installer.

1.                   Copy "/Server/install.res" to some directory on your harddrive. This is the script file to be used during the install process.

2.                   Edit the copy of "install.res" that has been copied to your harddrive. The following values need to be verified or modified:

o                    languagePack - This variable corresponds to the LanguagePack selection. The following choices are valid: SimplifiedChinese, TraditionalChinese, Danish, Dutch, English, Finnish, French, German, Italian, Japanese, Korean, Norwegian, Portuguese, Spanish, Swedish, Thai.

o                    lotusDirectory - This is the Lotus Destination Directory, which is selected during Domino installation. The default is "/opt/lotus/". When changing this value, please note that the value must end with "/".

o                    binDestinationDirectory - This is the Lotus binaries directory, where the Domino and Sametime binaries are installed. The correct value should be the Lotus Destination Directory followed by "/notes/latest/sunspa/". When changing this value, please note that the value must end with "/". For example, If the Lotus Destination Directory was "/opt/lotus", then "binDestinationDirectory=/opt/lotus/notes/latest/sunspa/" If the Lotus Destination Directory was "/usr/domino", then "binDestinationDirectory=/usr/domino/notes/latest/sunspa/"

o                    dataDestinationDirectory - This is the Data Destination Directory, where the Domino and Sametime data files are installed. The default Data Destination Directory during Domino installation is "/local/notesdata/". When changing this value, please note that the value must end with "/".

o                    dataDestDirAIX - This value needs to be identical to the value entered for "dataDestinationDirectory".

o                    dominoUser - This is the UNIX user account used during Domino installation. The Default is "notes".

o                    dominoGroup - This is the UNIX group account used during Domino installation. The Default is "notes".

o                    serverFullyQualifiedName - Enter either the fully-qualified domain name (ex: sametime.company.com) or the IP address if you are using partitioned servers (ex: 192.168.0.1).

o                    directoryType - The default is "Domino". Change to "LDAP" if you are going to run Sametime with an LDAP server.

3.                   Instead of running "./install" to start the install program, go to the "/Server" directory and run "java Installer /p ". For example, if you copied "install.res" to "/tmp", you would change to the "/Server" directory and run "java Installer /p /tmp/install.res".

Please note that while this install method does not create any graphical windows, it will attempt to access certain graphical environment variables. You will need X-Windows access to the machine in order for this install method to execute properly.

Availability of Lotus Notes client

If you received a copy of the Sametime 6.5.1 for AIX CD-ROM media pack, you have received the Domino Designer CD that contains the Lotus Notes client. The Notes client is useful for configuring a Domino server and for some aspects of Sametime server administration. However, it is not required to install and run Domino and Sametime. If you do not have a Notes client, Sametime customers can download a copy from the Passport Advantage Web site: www.lotus.com/passport.

Check the server name in the file/etc/hosts/ before installing Domino

Check the server name in file /etc/hosts/ before install Domino. If it is not a fully qualified domain name, for example aixserver, please modify to fully qualified domain name, for example aixserver.domainname.com.

back to top


Setting Up SSL on AIX

Follow the steps below to set up SSL for Sametime 6.5.1 on AIX.

1.                   Install the Sametime server and start it. To speed up the setup, you might want to open notes.ini and temporarily remove the staddin task from the "ServerTasks=" line before starting the server. Remember to put this task back after you complete the SSL setup. (Removing the staddin task is optional.)

2.                   Create a certificate authority database:

o                    From a Notes client, use the advanced template named "Domino R5 Certificate Authority" to create a database named "ca.nsf." Open ca.nsf in the Notes client.

o                    Click on "1. Create Certificate Authority Key Ring & Certificate." If you receive an error, open the database again and try this step again. Complete the following steps:

                     Accept the default Key Ring File - [CAKey.kyr].

                     Enter the Key Ring Password and verify it.

                     Set the "Key Size" to [1024].

                     Enter the common name (a descriptive name such as "Servername CA"), organization, state/province and country.

                     Click on the "Create Certificate Authority Key Ring" button.

o                    Click on "2. Configure Certificate Authority Profile." Accept all defaults and click on "Save and Close."

o                    Click on "3. Create Server Key Ring & Certificate" and complete the following steps:

                     Accept the default key ring file name [keyfile.kyr].

                     Enter the Key Ring Password and verify it.

                     Accept the default key size.

                     Enter the CA Certificate Label; for example, "servername CA."

                     Enter the common name (the fully-qualified name of the server), organization, state/province and country.

                     Click on the "Create Server Key Ring" button.

                     Enter the password for the authority that you entered when you clicked on "1. Create Certificate Authority Key Ring & Certificate."

3.                   Enable SSL on the Domino server. Using a Notes client, open names.nsf and then open the Server document for the Sametime server. Follow the steps below.

o                    Go to Ports-Internet Ports.

o                    Ensure that the "SSL key file name" matches the default key ring file name listed in step 2 above (keyfile.kyr).

o                    Set the "TCP/IP Port Status" to Disabled.

o                    Set the "SSL Port Status" to Enabled.

o                    Click on "Save and Close."

4.                   Get the certificate authority text from the server. Open a browser and go to http://servername/ca.nsf. (This URL is case sensitive.) Follow the steps below.

o                    On the left, click on "Accept This Authority In Your Server." The certificate text appears on the right.

o                    Copy the certificate text from "BEGIN CERTIFICATE" to "END CERTIFICATE."

o                    Paste this text into a new text document and save it; for example, save the text as ca.txt. When saving the text document, insert a new line after the "END CERTIFICATE" line.

5.                   Transfer files to the server. Ftp the following files from their current locations (listed below) to the data directory of your server (for example, the /local/notesdata directory):

o                    keyfile.kyr and keyfile.sth, both of which are located in the data directory of your client

o                    ca.txt, which is located in the directory you chose when creating this file in step 4 above.

6.                   To create a key file, run the program Ikeyman on the server. To run Ikeyman:

o                    Open the file ikeyman.sh. This file is located in the server's binary directory; for example, /opt/lotus/notes/latest/ibmpow.

o                    If your Sametime location is different than /opt/lotus/notes/latest/ibmpow, set the variable SAMETIME_HOME to the correct value. Otherwise, do not modify the ikeyman.sh file.

o                    Change your directory to the server's binary directory and run ikeyman.sh (ensure that the file has execute privileges).

o                    When ikeyman starts, choose Key Database File-New.

o                    Accept the default setting for the key database type; for example, "Key database type" = JKS.

o                    Enter File Name = key.jks.

o                    Enter Location = /local/notesdata (the server's data directory).

o                    Click OK.

o                    When prompted, enter a password for the key file. Reenter the password to verify it. The key file is created and some information about the file appears. Do not close the ikeyman program.

o                    Import the server certificate authority into the key file as follows:

                     Click on the Add button on the right.

                     In the dialog box that appears, make sure that the "Data Type" field is set to "BAse64-encoded ASCII data."

                     Set the "Certificate file name" to the name of the text file you created in step 4 (ca.txt).

                     Set the "Location" to the location where ca.txt was transferred in step 5 (for example, /local/notesdata).

                     Click OK.

                     Enter a label such as "servername CA" for the certificate.

                     Click OK.

                     Close ikeyman after the program finishes importing the certificate.`

7.                   Stop the server.

8.                   Modify the Sametime.ini file.

Open the Sametime.ini file (located in the server's data directory) and make the following changes under the [Config] section of the file. If a setting is already in the file, change the value as indicated below.

o                    ConfigurationPort=443

o                    ConfigurationSSLEnabled=true

o                    SSLManagerClassName=com.lotus.sametime.configuration.IBMJSSE12Manager

o                    javax.net.ssl.keyStore=/local/notesdata/key.jks

o                    javax.net.ssl.trustStore=/local/notesdata/key.jks

o                    javax.net.ssl.keyStorePassword=PASSWORD (where PASSWORD is the password for the key file you created in step 6)

o                    javax.net.ssl.trustStorePassword=PASSWORD (where PASSWORD is the password for the key file you created in step 6)

o                    javax.net.ssl.trustStoreType=JKS

o                    javax.net.ssl.keyStoreType=JKS

9.                   Restart the server. If you removed staddin from the notes.ini task list in step 1, make sure you reinsert staddin before restarting.

 

back to top


Known Problems and Recommendations

Problems when shutting down the server

When shutting down the Sametime server, the Domino console might report a fatal error and freeze all threads. If this problem occurs, follow the steps below to continue the shut-down.

1.                   Log in as the root user. Run the following command: $ /opt/lotus/bin/nsd -kill [-nolog]
The optional -nolog flag prevents an nsd kill log file from being created.

2.                   If the Domino console is still frozen, run the following set of commands: $ ps -u notes | tail +2 | awk '{print $2;}' | xargs kill -9

 

SSL for LDAP and SSL for SIP is not supported in Sametime AIX

You cannot use SSL for LDAP or SSL for SIP with this version of Sametime.

Problem with server deinstallation

You cannot deinstall Sametime while leaving Domino installed on the server. To deinstall Sametime, remove the directories which contain Domino and Sametime.

Must enable chat logging

If you want to use chat logging with Sametime 6.5.1 for AIX, you must enable the chat logging flag in stconfig.nsf:

1.                   Open the stconfig.nsf databased in your Notes client.

2.                   Change the "chat logging" flag under the "Community Services" heading from "off" to "relax" or "strict".

3.                   Save your change and close the stconfig.nsf database.

4.                   Restart the server.

Issue with writing server log information to a text file

The Sametime Administration Tool allows you to control where log events are recorded. If the administrator enables logging to a text file, the “Path to log text file” field should also include a filename (for example: “/logfiles/log.txt”). This configuration generates a log file with a name such as “log_07_Dec_2002.txt”. If no filename is specified with the path, the resulting file would be named “_07_Dec_2002”.

Error in the LDAP section of the Sametime Administrator's Guide

The topic "Where to start searching for people" in the "Using LDAP with the Sametime server" section of the Sametime Administrator's Guide contains an error. This topic gives an example value of "o=servername" for the "Scope for searching for a person" setting when using a Domino directory. This example value should read "o=organizational" instead of "o=servername."

Problem with chat text in "Sametime Connect for browsers"

When using "Sametime Connect for browsers," a user might not see his or her own chat text in the "Type your text" area of the chat window. However, the text will still be sent correctly.

This problem, which is common in Java applications, arises when the foreground color is not specified and the background is set to white. To correct this problem, modify the source code to include specifications for foreground colors.

Japanese text unreadable

Japanese text for Sametime 6.5.1 for AIX is unreadable or displays as "garbage text" because the Japanese font properties file, font.properties.ja, does not include any definition for JIS X 0201. To fix this problem, install a TrueType JIS X 0201 font and modify the font.properties.ja file accordingly.

Screen sharing buttons disabled after installing SmartUpdate

If you are using a Netscape browser and you install SmartUpdate, the screen-sharing buttons in the Sametime Meeting Room are sometimes disabled when you attend your first meeting after installing SmartUpdate. To fix this problem, leave the meeting and reattend. The screen-sharing buttons should be enabled.

Sametime services fail when configuring LDAP for AIX

When configuring Sametime 6.5.1 for AIX to work with LDAP, you will see several messages indicating that Sametime services have failed. These messages are normal, and will not impede the LDAP configuration. To ensure that Sametime for AIX works with LDAP directories, install Sametime and start the Sametime server. When you see the failure messages, ignore them and continue with the steps outlined in Chapter 4 of the Sametime 6.5.1 for AIX Installation Guide, "Using LDAP Directories with Sametime," then restart the Sametime server.

If the Sametime failures cause a problem (for example, if you are unable to create the Directory Assistance database),follow the steps below to start the necessary portions of the Domino server and complete the LDAP configuration:

1.                   Stop the Sametime server.

2.                   Remove "staddin" from the "Tasks" list in notes.ini.

3.                   Start the server.

4.                   Make all necessary configuration changes, outlined in Chapter 4 of the Sametime 6.5.1 for AIX Installation Guide.

5.                   Stop the server.

6.                   Put "staddin" back in the "Tasks" list in notes.ini.

7.                   Start the server.

Environment variables associated with "ststart" script file

The "ststart" script file sets some important environment variables before launching the server executable (/opt/lotus/bin/server). If you want to launch the server automatically, add the "ststart" environment variables to the Domino user's profile before launching the executable. You must add these variables to the user's profile for Sametime to work correctly.

Using the Domino "bin" directory in the PATH variable causes installation problem

Do not include the Domino "bin" directory (/opt/lotus/bin, by default) in the PATH environment variable. Doing so may cause the connector initialization to fail with an error code of 0x1007.

Option to limit recorded meetings not available

In the Meeting Services settings of the Sametime Administration Tool, there is an option to "Stop Recording when this much space is left (MBytes)." Although this option appears in the user interface, AIX does not support it. Implementation of this option would have a detrimental effect on Sametime performance.

Using the Sametime Administration Tool to Set up Invited Servers (Meeting Servers that Are Connected)

You can use the Sametime Administration Tool to allow a Sametime server to "invite" another server to a meeting. When you set up invited servers, a meeting can be active on more than one server at a time. To set up invited servers for AIX:

1.                   Install two or more servers in the same Domino domain.

2.                   Log into the Sametime Administration Tool on the server that you want to use as the "inviting" server. (The server which will connect to the "invited" server through a connection document.)

3.                   Choose Configuration-Connectivity. Click on the "Servers in this Community" tab.

4.                   Enter the name of the server that you want to invite in the "Destination server" field. For example, enter charon/tostada.

5.                   Enter the fully-qualified domain name in the "Destination server IP address" field. For example, enter charon.lab.databeam.com.

6.                   Click on Add.

7.                   Make sure names.nsf is replicated.

8.                   Restart the server.

9.                   To verify that a meeting is active on both servers, create a meeting on the first server. When creating the meeting, select the invited server on the Locations tab of the New Meeting page. Save the meeting and then verify that you can attend it on both servers.

Error when exporting a recorded meeting

If the administrator changes the default location for recorded meetings, anyone who attempts to export a recorded meeting will receive the following error: HTTP Web Server: Item Not Found Exception. To solve this problem, the person who is exporting the file (either the Moderator or the administrator) must add the recorded file name to the URL that appears during the export attempt. The recorded file name is the file name that the administrator entered when changing the default location for recorded meetings.

In the example below, the Moderator must add the file name "record" to the URL for the exported meeting:

1.                   The administrator chooses Administer the Server-Configuration-Meeting Services, then clicks on the General tab.

2.                   In the field labeled "Save recorded meetings in the following location," the administrator enters: &ltdata directory path>/all_recorded_meetings/record. All recorded meetings will be saved in the "all_recorded_meetings" folder, under the data directory. Meeting names will be saved in the following format: record(meeting_ID)_recorded.rap

3.                   When the Moderator tries to export the .rap file, the following error appears: HTTP Web Server: Item Not Found Exception. The URL in the browser is http://&ltserver>/stconf.nsf/(ExportRecodingArchives)/(id)/$file/(meeting_id)_recorded.rap?OpenElement&login.

4.                   To export the file, the Moderator must add the file name to the URL: http://&ltserver>/stconf.nsf/($ExportRecodingArchives)/(id)/$file/record(meeting_id)_recorded.rap?OpenElement&login.
Note: The administrator must supply the Moderator with the file name before the Moderator can enter the file name in the URL.

5.                   A "File Download" dialog box appears, and the Moderator can save the .rap file to his or her local machine.

Cannot install Sametime and Quickplace on the same machine

Sametime 6.5.1 for AIX does not support a configuration in which Sametime and Quickplace are installed on the same machine.

Sametime 6.5.1 for AIX not supported for Turkish locale

Installing Sametime for AIX on a server set to a Turkish locale is not currently supported in the 6.5.1 release.

Sametime Administration Tool might display status incorrectly for non-English locales

If you are using a non-English locale browser to administer the Sametime server, the Server Overview feature in the Sametime Administration Tool might display the status of the first Sametime service incorrectly.

Install the latest version of Java Virtual Machine (JVM)

Sametime makes use of the Java Virtual Machine (JVM) on the AIX operating system. It is highly recommended that administrators install the latest J2SE patches from Sun for their JVM.

back to top