IBM Lotus Instant Messaging and Web Conferencing for AIX
(Sametime 6.5.1) Readme
Last update: March 8,
2004
Known Problems and Recommendations
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.
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
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
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.
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 "
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 "
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.
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.
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: <data
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://<server>/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://<server>/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.