User manual | Lotus Sametime 7.5

Lotus Sametime 7.5 for i5/OS
®
Version 7.5
Installing and Managing Sametime 7.5 for i5/OS
G210-2405-00
Note
Before using this information and the product it supports, read the information in “Notices."
First Edition (July 2006)
This edition applies to version 7.5 of IBM Lotus Sametime for i5/OS (product number L-GHUS-6LTVFK) and to all
subsequent releases and modifications until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 2006. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Notices
This information was developed for products and services offered in the U.S.A.
IBM may not offer the products, services, or features discussed in this document in
other countries. Consult your local IBM representative for information on the
products and services currently available in your area. Any reference to an IBM
product, program, or service is not intended to state or imply that only that IBM
product, program, or service may be used. Any functionally equivalent product,
program, or service that does not infringe any IBM intellectual property right may
be used instead. However, it is the user’s responsibility to evaluate and verify the
operation of any non-IBM product, program, or service.
IBM may have patents or pending patent applications covering subject matter
described in this document. The furnishing of this document does not grant you
any license to these patents. You can send license inquiries, in writing, to:
IBM Director of Licensing
IBM Corporation
North Castle Drive
Armonk, NY 10504-1785
U.S.A.
The following paragraph does not apply to the United Kingdom or any other
country where such provisions are inconsistent with local law:
INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS
PUBLICATION “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS
FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or
implied warranties in certain transactions, therefore, this statement may not apply
to you.
This information could include technical inaccuracies or typographical errors.
Changes are periodically made to the information herein; these changes will be
incorporated in new editions of the publication. IBM may make improvements
and/or changes in the product(s) and/or the program(s) described in this
publication at any time without notice.
Any references in this information to non-IBM Web sites are provided for
convenience only and do not in any manner serve as an endorsement of those Web
sites. The materials at those Web sites are not part of the materials for this IBM
product and use of those Web sites is at your own risk.
IBM may use or distribute any of the information you supply in any way it
believes appropriate without incurring any obligation to you.
Licensees of this program who wish to have information about it for the purpose
of enabling: (i) the exchange of information between independently created
programs and other programs (including this one) and (ii) the mutual use of the
information which has been exchanged, should contact:
© Copyright IBM Corp. 2006
IBM Corporation
Office 4360
One Rogers Street
Cambridge, MA 02142
U.S.A.
Such information may be available, subject to appropriate terms and conditions,
including in some cases, payment of a fee.
The licensed program described in this information and all licensed material
available for it are provided by IBM under terms of the IBM Customer Agreement,
IBM International Program License Agreement, or any equivalent agreement
between us.
Information concerning non-IBM products was obtained from the suppliers of
those products, their published announcements or other publicly available sources.
IBM has not tested those products and cannot confirm the accuracy of
performance, compatibility or any other claims related to non-IBM products.
Questions on the capabilities of non-IBM products should be addressed to the
suppliers of those products.
Trademarks
The following terms are trademarks of International Business Machines
Corporation in the United States, other countries, or both:
Domino
eServer
IBM
i5/OS
iSeries
iSeries Client Access Express
Lotus
Lotus Notes
Operating System/400
PowerPC
QuickPlace
Sametime
Sametime Connect
Pentium is a registered trademark of Intel Corporation in the United States, other
countries, or both.
Microsoft, NetMeeting, Outlook, Windows, Windows NT, and the Windows logo
are trademarks of Microsoft Corporation in the United States, other countries, or
both.
Java and all Java-based trademarks are trademarks of Sun Microsystems, Inc. in the
United States, other countries, or both.
MeetingPlace is a trademark of Latitude Communications, Inc.
Other company, product, or service names may be trademarks or service marks of
others.
Contents
1 Getting started with IBM Lotus
Sametime . . . . . . . . . . . . . . . . . . . . . . 1
About this guide
4 Preparing to upgrade an existing
Sametime environment . . . . . . . . . . . 35
....................
1
Summary of upgrade considerations by release
..............
2
Preparing to upgrade your servers
....
3
Backing up your data
......
4
Upgrading from Instant Messaging Limited Use
to the full version of Lotus Sametime . . . 40
.....
6
...........
7
What is Lotus Sametime?
What is Instant Messaging Limited Use?
What's new in Sametime 7.5 for i5/OS
About Sametime on the i5/OS platform
Lotus Sametime requirements
i5/OS authorities required to install and set up
Sametime . . . . . . . . . . . . . . . . . . .
Where to find more information
.
7
..........
13
2 Preparing the TCP/IP environment 15
36
........
37
................
39
...........
43
.........
45
..............
46
.....
47
......
49
5 Installing Sametime
Installing or upgrading Sametime
Verifying your library list
Installing the Sametime Language Pack
Adding Sametime to a Domino Server
16
6 Deploying the Sametime client
software . . . . . . . . . . . . . . . . . . . . . . . 57
16
Summary of the types of Sametime clients
.
17
7 Managing Sametime . . . . . . . . . . . 59
.............
18
Starting a Sametime server
.............
60
...............
18
Ending a Sametime server
.............
61
.......
19
Starting the Sametime components on a Domino
server that is already running . . . . . . . 62
Updating the configuration of existing Domino
servers . . . . . . . . . . . . . . . . . . . . . . 20
Ending the Sametime components on a Domino
server that is already running . . . . . . . 62
Verifying host table entries
.............
Verifying configuration of existing Domino
servers . . . . . . . . . . . . . . . . . . .
...
Selecting a TCP/IP address for your Sametime
server . . . . . . . . . . . . . . . . . . . . . .
Adding a TCP/IP address
Updating the host table
Updating the Domain Name Server
Updating the IBM HTTP server configuration
.
...
58
23
Changing the IP address
..............
63
3 Preparing a new Sametime
environment . . . . . . . . . . . . . . . . . . . . 25
Changing the host name
...............
64
Sametime configuration options
..........
25
....
33
Verifying the Domino server is accessible
Updating the host names when using HTTP
Tunneling with multiple IP addresses
..
65
8 Optional Configurations for
Sametime . . . . . . . . . . . . . . . . . . . . . . 67
Using Sametime Conversion Services for
meeting attachments . . . . . . . .
.....
Enabling the capability to save whiteboard
contents . . . . . . . . . . . . . . . . . .
...
67
68
Using the limited use version of Sametime in an
environment that includes full Sametime
servers . . . . . . . . . . . . . . . . . . . . . . 69
Installing Sametime toolkits
............
70
....
70
Using a Community Services multiplexer
Appendix A Sametime Installation
and Configuration Checklists . . . . . 73
..............
74
...................
75
New installation checklist
Upgrade checklist
Appendix B Preparing the TCP/IP
Environment Using Commands . . . . 77
.
77
...
78
Verifying host table entries using commands
Verifying configuration of existing Domino
servers using commands . . . . . . .
Selecting a TCP/IP address for your Sametime
server using commands . . . . . . . . . .
.
79
..
80
....
80
.......
82
Adding a TCP/IP address using commands
Updating the host table using commands
Updating the Domain Name Server
Updating the configuration of existing Domino
servers using commands . . . . . . . . . . 83
Updating the IBM HTTP server configuration
using commands . . . . . . . . . . . . . .
.
85
Appendix C Setting up a Domino
server using commands . . . . . . . . . . 87
Setting up a Domino server in a new Domino
domain using commands . . . . . . . .
..
87
Adding a Domino server to an existing Domino
domain using commands . . . . . . . . . . 90
Chapter 1
Getting started with IBM Lotus Sametime
Welcome to IBM® Lotus® Sametime® 7.5 for i5/OSTM! This product
provides instant messaging, Web conferencing and presence awareness
capabilities in one integrated solution, so you can instantly collaborate with
colleagues, clients, customers and business partners. This enhances the
workplace by placing powerful, real-time collaboration tools on the desktop
of every user in a Sametime community.
About this guide
This installation guide provides information on installing and managing
Sametime on the i5/OS operating system. In addition to documenting the
aspects of Sametime that are unique to i5/OS, this guide provides an
administrator with the necessary steps for completing the following tasks:
•
Preparing the TCP/IP environment
•
Preparing a new Sametime environment
•
Preparing to upgrade an existing Sametime environment
•
Installing Sametime
•
Setting up the Sametime client software
•
Managing Sametime
•
Setting up optional configurations for Sametime
This guide includes documentation for both the Instant Messaging Limited
Use version of Sametime, and the full version of Sametime. The term
"Sametime" is used to refer to both versions. When it is necessary to
differentiate between the two versions, the terms "Instant Messaging Limited
Use" and "the full version of Sametime" are used.
Providing documentation feedback
Lotus Sametime User Assistance Feedback is a form posted on the Internet
that allows you to provide feedback pertaining to your experiences with this
installation guide. This form is available at the following Web site:
http://doc.notes.net/feedback/sametime.nsf/Install_iSeries?OpenForm
Chapter 1: Getting started with IBM Lotus Sametime 1
What is Lotus Sametime?
Lotus Sametime consists of client and server applications that enable a
community of users to collaborate in real-time online meetings over an
intranet or the Internet. Members of the Sametime community use
collaborative activities such as presence awareness, instant messaging, screen
sharing, a shared whiteboard, and real-time audio/video capabilities to
meet, converse, and work together in instant or scheduled meetings.
Lotus Sametime for i5/OS consists of two product options. The *BASE
product option includes the instant messaging and awareness capabilities of
Sametime. Product option 1 includes the capability for meetings (Web
conferencing). Users entitled to the full version of Sametime receive and
install both options.
Presence -- Sametime presence technology allows you to see which team
members are online and available. The names of online users display in
"presence lists" in Sametime applications from which you can converse with
others through instant messaging sessions or start instant meetings.
Individuals can control their online availability and visibility through user
privacy features. You can request instant notification as soon as a colleague
comes online or becomes active. Lotus Sametime software also provides the
capability to extend presence awareness beyond your contact list so that it
can be available when and where you need it -- for example, embedded in an
e-mail inbox or Web site.
Instant messaging -- The primary instant messaging (IM) client for
Sametime 7.5 is a completely new version of Sametime Connect for the
Desktop. Once installed on the client desktop, instant messaging with Lotus
Sametime 7.5 Connect lets you chat with other users to exchange text, as well
as files; live Web addresses; links to IBM Lotus Notes® documents, views,
and databases; screen shots; and static or animated emoticons (smileys). You
can select the font, font size and background color, and view saved chat
transcripts. You can use your computer's audio features and VoIP (voice
over IP) technology by clicking a microphone icon to call another user for
instant voice chats over the Internet or intranet. Sametime 7.5 Connect also
provides developers with extensibility features that go far beyond those
available in previous Sametime releases. Developers use these features to
integrate with the client and extend its capabilities.
Meetings -- While presence lists support instant awareness and instant
collaboration with other online users, the Sametime Meeting Center on the
server provides a central meeting place for members of the community. In
the Meeting Center, meetings can be scheduled in advance or started
immediately. Users attend meetings by accessing the Sametime Meeting
Center with Web browsers. The Sametime Meeting Room client is a JavaTM
2 Installing and Managing Sametime 7.5 for i5/OS
applet that automatically loads and runs in the user's Web browser to
support the full range of Sametime meeting capabilities. Users can share
presentations, applications or entire desktops. You can capture
brainstorming sessions or mark up shared slides, allow other meeting
participants to take control of your computer, and even edit your documents.
Meetings can be recorded for playback at a later time. In Sametime 7.5, users
can also create "breakout sessions," sub-meetings of the larger meeting.
Each Sametime server contains an IBM Lotus DominoTM Directory that
maintains information about all users and servers that comprise the
Sametime community. The Sametime server can also be configured to
operate as a client to a Lightweight Directory Access Protocol (LDAP) server
containing an LDAP directory.
What is Instant Messaging Limited Use?
The Instant Messaging Limited Use version of Sametime is a limited version
of the full IBM Sametime product. The full version of Sametime supports
presence, instant messaging, and Web conferencing functionality. Customers
entitled to use the Instant Messaging Limited Use version of Sametime are
licensed to use the integrated instant messaging and presence awareness
functions, but not meetings (Web conferencing).
Also, entitlement to the Instant Messaging Limited Use version of Sametime
only permits access from within the Lotus Notes/Domino environment.
Therefore, the Instant Messaging Limited Use version of Sametime must be
integrated with a Domino server so that Sametime's instant messaging and
presence functionality can be accessed from Domino applications such as the
Lotus Notes client and Domino Web Access. For more information on
integrating Sametime with Domino servers, see the Domino Administration
documentation available at
www.lotus.com/ldd/doc
Instant Messaging Limited Use and the full version of Sametime are separate
offerings of the Lotus Sametime for i5/OS product (5724J23). Customers
entitled to Instant Messaging Limited Use receive and install the *BASE
product option of Lotus Sametime. Customers entitled to the full version of
Sametime receive and install *BASE and Option 1.
With the Instant Messaging Limited Use version of Sametime, client and
server applications interact to enable a community of users to collaborate in
real-time through presence and instant messaging.
Chapter 1: Getting started with IBM Lotus Sametime 3
Sametime presence technology enables members who have logged in to the
Sametime server to see all other members who are online (logged in). The
names of online users display in "presence lists" in the Lotus Notes client or
Domino Web Access. From these presence lists, members of the community
can converse through instant messaging sessions. Instant messaging sessions
can be two-way sessions involving only two users or chat conferences
involving three or more users.
The Lotus Notes client and Domino Web Access interact with the
Community Services on the Sametime server to access presence and instant
messaging functionality. The Community Services support all presence and
instant messaging capabilities of Sametime. The Instant Messaging Limited
Use version of Sametime installs on a Domino server and uses the HTTP
Services, Domino Web Application Services, and Domino directory provided
with the Domino server.
This Sametime server can also be configured to operate as a client to a
Lightweight Directory Access Protocol (LDAP) server containing an LDAP
directory. You can use an LDAP directory as your community user
repository if LDAP directories are used in your environment.
What's new in Sametime 7.5 for i5/OS
This section summarizes some important changes in Sametime 7.5 for i5/OS
that you should be aware of.
New Sametime Connect client
Sametime 7.5 provides a completely new version of Sametime Connect for
the Desktop. Lotus Sametime 7.5 Connect lets you chat with other users to
exchange text, as well as files; live Web addresses; links to IBM Lotus Notes®
documents, views, and databases; screen shots; and static or animated
emoticons (smileys). You can select the font, font size and background color,
and view saved chat transcripts. You can use your computer's audio features
and VoIP (voice over IP) technology by clicking a microphone icon to call
another user for instant voice chats over the Internet or intranet. See the
Sametime 7.5 Release Notes for more detail.
Enhanced Web conferencing
The Sametime Meeting Room and Meeting Room client have been enhanced
for Sametime 7.5. This includes a simpler interface for creating meetings and
a new Slides tab for easier management of multiple presentation files.
Meeting connectivity has been enhanced with better handling of pop-ups
and and connection resilience. See the Sametime 7.5 Release Notes for
more detail.
4 Installing and Managing Sametime 7.5 for i5/OS
Enhanced Conversion Services
Sametime Conversion Services is a feature that takes files of various formats
(slides, images, documents, etc.) and provides a bitmap rendering so they
can be shared in a meeting as slides. Sametime Conversion Services has been
enhanced for Sametime 7.5 to use new conversion technologies that provide
more faithful rendering of slides. Also, Sametime 7.5 provides the capability
to secure communications between the Sametime server and a separate
Conversion Server using SSL.
New parameters have been added to the command for adding Sametime to a
Domino server (ADDLSTDOM) so you can specify connection information
for the system where you plan to run conversion services. The detailed
instructions for setting up Sametime Conversion Services are now included
in the Lotus Sametime 7.5 Administrator's Guide, rather than a separate
guide as in previous releases.
Product Packaging Notes
Sametime 7.5 for i5/OS is packaged and installed the same way as Sametime
7.0. However, if upgrading from a release prior to 7.0, you need to be aware
of several significant changes.
Sametime for i5/OS now uses product identifier 5724J23 rather than
5733LST, which was used for all releases prior to 7.0.
Also, the product has been restructured to support two separate offerings of
Lotus Sametime:
•
Lotus Sametime, Instant Messaging Limited Use
Customers who are entitled to Lotus Sametime, Instant Messaging
Limited Use receive and install only the *BASE product option of Lotus
Sametime (5724J23). This provides the capability to create and configure
Sametime servers that support instant messaging, but not Web
conferencing.
•
Lotus Sametime
Customers who are entitled to Lotus Sametime receive and install *BASE
and Option 1 of Lotus Sametime. This provides the capability to create
and configure Sametime servers that support both instant messaging and
Web conferencing.
Chapter 1: Getting started with IBM Lotus Sametime 5
About Sametime on the i5/OS platform
When deploying Lotus Sametime on the i5/OS platform, you should be
aware of the following:
•
The product ID for Lotus Sametime 7.5 for i5/OS is 5724J23. To enable
only the Instant Messaging Limited Use version of Sametime, install the
*BASE product option. To enable the full version of Sametime, install
both *BASE and Option 1.
•
Lotus Sametime for i5/OS supports "mixed environments" where both
full Sametime servers and Instant Messaging Limited Use servers coexist
on the same i5/OS logical partition (LPAR). For more information, see
"Using the limited use version of Sametime in an environment that
includes full Sametime servers ."
Lotus Sametime for i5/OS also supports conversion of an Instant
Messaging Limited Use server to a full Sametime server, and vice-versa.
For more information, see "Changing an existing server to limited use or
full Sametime."
•
Lotus Sametime for i5/OS supports multiple Sametime servers on the
same LPAR. This is done by creating multiple Domino partitioned
servers and configuring them as Sametime servers. For this environment
to be successful, it is important that TCP/IP is carefully configured. For
more information, see technote 7002647 "Sametime for iSeries: Multiple
Sametime Servers on Same System" at the following Web address:
http://www.ibm.com/support/docview.wss?rs=203&uid=swg27002647
•
You can configure Sametime servers and Lotus QuickPlace servers on
the same LPAR, but they must run on separate partitioned Domino
servers. To avoid port conflicts, ensure that you properly configure the
servers as described in Chapter 2 "Preparing the TCP/IP environment."
For information about enabling QuickPlace integration with Sametime,
see the IBM Lotus QuickPlace Installation and Upgrade Guide.
•
The preferred way to install and manage the Domino server that you use
for Sametime for i5/OS is to use iSeries Navigator. iSeries Navigator is
part of IBM iSeries Client Access Express™ for Windows, and runs on a
workstation connected to your server. All of the software needed for
Client Access Express is included with the i5/OS® software that is
pre-loaded on your system. For detailed information on installing iSeries
Navigator and Client Access Express, see the iSeries Navigator section of
the iSeries Information Center at the following Web address:
http://www.ibm.com/eserver/iseries/infocenter
6 Installing and Managing Sametime 7.5 for i5/OS
•
Sametime 7.5 is supported on Domino 7.0 and later Domino 7.0.x
releases. These versions of Domino are all multi-version capable. This
means that multiple versions of Domino can run on the same LPAR.
However, only one version of Sametime can be installed on a single
LPAR. For more information on multi-version capable releases of
Domino, see "Using Domino for i5/OS multi-version capabilities" in the
Lotus book Installing and Managing Domino 7 for i5/OS.
Lotus Sametime requirements
Before you install Lotus Sametime, ensure your system meets the hardware
and software requirements. Before you install Sametime Connect for the
desktop, install the workstation hardware and software that Sametime
Connect requires.
The following sections describe how to verify that your system meets all of
the Sametime hardware and software requirements for the i5/OS platform.
i5/OS authorities required to install and set up Sametime
i5/OS has extensive security restrictions to prevent unauthorized access to
functions and data. The administrator who installs and sets up Sametime
must sign on to the system with a user profile that has the required authorities.
To install the Sametime software, your user profile must have the
following special authorities:
• All object access (*ALLOBJ)
• Security administration (*SECADM)
To set up a Sametime server, your user profile must have the following
special authorities:
• All object access (*ALLOBJ)
• System configuration (*IOSYSCFG)
• Job control (*JOBCTL)
Chapter 1: Getting started with IBM Lotus Sametime 7
Checking your user profile using iSeries Navigator
The i5/OS security officer has the required authorities to install and set up
Sametime. If you are not the security officer, check to see if your user profile
has the required authorities by following these steps:
Open the system where you will install Sametime.
•
Click Users and Groups.
•
Click All Users.
•
Right-click user-id
where user-id is the name of your user profile.
•
Click Properties.
•
Click Capabilities.
The authorities granted to your user profile are displayed on the
Privileges tab.
If your user profile does not have the required authorities, ask the security
officer to either install and set up the Sametime server or add the required
authorities to your user profile.
Checking your user profile using commands
The i5/OS security officer has the required authorities to install and set up
Sametime. If you are not the security officer, use the Display User Profile
(DSPUSRPRF) command to determine if your user profile has the required
authorities. To check your user profile, follow these steps:
Note You start the i5/OS command interface by signing on to your system,
such as from a 5250 emulator window on a workstation that is
communicating with the system. To enter a command, type the command on
any line following the symbol ===> and press Enter. To have the system
prompt you for details of a command, type the command name (such as
DSPUSRPRF) and press F4 instead of Enter.
1. Type the following OS/400 command and press Enter:
DSPUSRPRF user-id
where user-id is the name of your user profile.
2. Press the PAGE DOWN key and look for the special authority field to
display the special authorities for the user profile.
If your user profile does not have the required authorities, ask the security
officer to either do the installation and setup or to add the required
authorities to your user profile.
8 Installing and Managing Sametime 7.5 for i5/OS
How to check for installed i5/OS software
You can determine what software is installed by using iSeries Navigator (the
Graphical User Interface for i5/OS) or by entering a command.
Checking for installed software using iSeries Navigator
If you are using iSeries Navigator and have the Configuration and Service
plug-in installed, follow these steps:
1. Open the system where you will install Sametime.
2. Click Configuration and Service.
3. Click Software.
4. Click Installed Products.
In the right pane, you will see a list of the products installed on the
system.
To find the release of Domino you are running, follow these steps:
5. Locate 5733LD7 (7.0.x releases), 5733LD6 (6.0.x releases), or 5733L65 (6.5.x
releases) in the Product column.
6. Look under the Description and Option columns to see which release(s)
of Domino are installed (you may have more than one release installed).
For Sametime 7.5, you must have Domino 7.0.x (5733LD7) installed.
Checking for installed Program Temporary Fixes
To check whether a Program Temporary Fix (PTF) has been installed on your
system, follow these steps:
1. Open iSeries Navigator.
2. Open the system where you will install Sametime.
3. Click Configuration and Service.
4. Click Fixes Inventory.
5. Click All Fixes.
The display on the right will show all PTFs that have been installed on
the system.
Checking for installed software using commands
To determine what software is currently installed on the system, type the
following command and press Enter:
DSPSFWRSC
The Resource ID column shows the licensed program number. Press F11 to
see the version and release of the software.
Chapter 1: Getting started with IBM Lotus Sametime 9
One or more releases of Domino, such as 5733LD7, 5733LD65 or 5733LD6,
may be installed on your server. For Sametime 7.5, you must have 5733LD7
installed.
Checking which version of Sametime is installed on your system
The following table lists the product and option numbers for each version of
Lotus Sametime for i5/OS.
Version of Sametime
Product Number Option Number(s) Version/Release/Mod
Lotus Sametime 7.5
5724J23
Lotus Sametime 7.5, 5724J23
Instant Messaging
Limited Use
*BASE and
Option 1
*BASE
V7R5M0
V7R0M0
V7R5M0
Lotus Sametime 7.0
5724J23
Lotus Sametime 7.0,
Instant Messaging
Limited Use
Lotus Instant
Messaging and Web
Conferencing 6.5.1
Lotus Sametime 3.1
Earlier releases
5724J23
*BASE and
Option 1
*BASE
5733LST
*BASE
V6R5M1
5733LST
5733LST
*BASE
*BASE
V3R1M0
V3R0M0 or V2R5M0
V7R0M0
Sametime server requirements
Lotus Sametime for i5/OS requires the following hardware and software.
Unless otherwise noted, these requirements apply to both the full version of
Sametime and Instant Messaging Limited Use.
When new releases of Domino and i5/OS become available, there may be
additional updates to these requirements. For the latest information, see the
Lotus Software for i5/OS Compatibility Guide on the Web at
http://www.ibm.com/servers/eserver/iseries/domino/domino6/relea
sesupport.pdf
Hardware
• IBM eServer iSeriesTM, IBM eServerTM i5, or IBM System i5TM server
models capable of running IBM i5/OS V5R3
•
Minimum 1GB memory for each Sametime and Domino server
•
Minimum 500MB free disk space, 1GB recommended
•
Minimum of 4 Disk Drives (arms)
10 Installing and Managing Sametime 7.5 for i5/OS
•
If you plan to use Sametime in a language other than English, your
server must have an additional 150MB of free disk space.
Note Use these values as general guidelines. The requirements for your
environment may be different. For more information about recommended
models and system sizing, see the Sametime for i5/OS Web site at the
following address:
http://www.ibm.com/eserver/iseries/sametime/sysreq.html
Software
• IBM i5/OS, 5722SS1, Version 5 Release 3 or later
•
OS/400 - Host servers, 5722SS1 option 12
•
TCP/IP Connectivity Utilities for iSeries, 5722TC1
•
IBM Developer Kit for Java, 5722JV1, *BASE plus option 6, 1.4 JDK
•
OS/400 - QShell Interpreter, 5722SS1 option 30
•
OS/400 - Portable Application Solutions Environment (PASE), 5722SS1
option 33
This product option is required if you are installing the full version of
Sametime and plan to enable the capability to save whiteboard contents.
w Cryptographic Access Provider 128-bit for iSeries, 5722AC3
This product option is required if you plan to enable the Secure Sockets Layer
(SSL) protocol to encrypt connections with your Sametime server. It is
recommended for all Sametime server installations. 5722AC3 is included
with all orders for V5R3 and later i5/OS releases. Install or upgrade to
the version of 5722AC3 that matches your i5/OS level.
•
All required system PTFs, including the latest Java Group PTF
For the latest detailed information about the required PTFs, see technote
1089996 "Sametime for iSeries: What System Fixes are Required?" at the
following Web address:
http://www.ibm.com/support/docview.wss?rs=203&uid=swg21089996
The technote advises you to install the latest Java Group PTF. It is
important that you install or reinstall the Java Group PTF after installing
or upgrading all of the prerequisite software listed in this section,
especially 5722JV1, option 6, and 5722AC3.
See Chapter 8 "Optional Configurations for Sametime" for additional
requirements for other Sametime configurations such as implementing
Sametime Conversion Services.
Chapter 1: Getting started with IBM Lotus Sametime 11
Domino software
• Sametime 7.5 for i5/OS requires Domino for i5/OS release 7.0 or a later
Domino 7.0.x release.
Note See "How to check for installed i5/OS software" for instructions
on checking which release of Domino you have installed.
Domino considerations for languages other than English
You should install the language version of Domino for i5/OS that
corresponds to the language version of Sametime you plan to install. For
example, if you plan to install the French version of Sametime, you should
install the English version of Domino, plus the French language files from
the Domino Language Pack.
Additional requirements for iSeries Navigator
If you want to use iSeries Navigator to manage your Sametime server, make
sure you have the following software installed on your system:
•
Client Access Express for Windows, 5722XE1
•
Client Access Windows Family - Base, 5722XW1
•
Lotus Domino plug-in for iSeries Navigator
For more information, see the IBM eServer iSeries Information Center at the
following Web address:
http://www.ibm.com/eserver/iseries/infocenter
Server compatibility considerations
• If you plan to run multiple Sametime servers in the same community, all
of the servers should be running Sametime 7.5, Sametime 7 or Sametime
6.5.1. Interoperability with Sametime 3.1 is supported only during the
upgrade process. For more information, see "About upgrading to
Sametime 7.5."
•
If you plan to integrate a Domino server with your Sametime server
(required for accessing instant messaging and presence functionality
with the Instant Messaging Limited Use version of Sametime), your
Domino server must be running Domino 6.5.1 or later.
•
If you plan to integrate a QuickPlace server with your Sametime 7.5
server, the QuickPlace server should be running version 7. QuickPlace
6.5.1 does not support interoperability with Sametime 7.5. For more
information, see the IBM Lotus QuickPlace Installation and Upgrade Guide.
Replication issues
If you plan to use replication functions in your Sametime environment, do
not replicate the Sametime Configuration Database (stconfig.nsf) from one
server to another.
12 Installing and Managing Sametime 7.5 for i5/OS
Sametime client requirements
For the most recent Sametime client requirements, see the release notes that
shipped with this product.
Where to find more information
Your primary source of information about getting started with Lotus
Sametime is the Lotus Sametime 7.5 Quick Start Guide which is available on the
Quick Start CD. It describes the contents of each CD and will help you locate
other important documentation.
Before installing and configuring your Sametime server, be sure to review the
information in the Readme file located on your CD-ROM. You should also visit
the IBM Lotus Sametime for i5/OS Web site where additional information
will be posted as it becomes available, including installation tips and sizing
recommendations. The Web site is located at the following address
http://www.ibm.com/eserver/iseries/sametime
You may find the following resources helpful:
•
All of the Sametime documentation is available online. Visit the
developerWorks product page for Lotus Sametime to access the
documentation and additional information that developers and
administrators will find helpful, such as articles, downloads, toolkit
information, and access to the Sametime Forum. You can access the
product page for Lotus Sametime from the following Web page:
http://www.ibm.com/developerworks/lotus/products
Scroll down to Documentation. For information specific to Sametime on
the i5/OS platform, select "Lotus Sametime for i5/OS product
documentation." For general information that pertains to all platforms,
select "Lotus Sametime product documentation." A link is also available
for Sametime Toolkit documentation.
•
Most of the documentation for Sametime is also available on the Lotus
Sametime for i5/OS Components CD in the /Docs directory.
•
The Lotus Sametime home page contains the latest Sametime product
and developer information. The Web site is located at:
http://www.ibm.com/lotus/sametime
Chapter 1: Getting started with IBM Lotus Sametime 13
•
The Lotus book, Installing and Managing Domino 7 for i5/OS has details on
setting up and controlling Domino 7 servers on i5/OS. This book
includes instructions on how to verify that TCP/IP is set up and running
on your system. It also provides a basic introduction to i5/OS for those
who are new to platform. This book is available on the Domino product
CD, or you can view or download it from the Notes/Domino product
page available from:
http://www.ibm.com/developerworks/lotus/products/
You can find other Domino for i5/OS information on the IBM Domino
for i5/OS Web site at:
http://www.ibm.com/eserver/iseries/domino
•
The IBM eServer iSeries Information Center has details about installing,
setting up, and using TCP/IP. It also includes an overview of Client
Access Express and iSeries Navigator. The latest version of the
Information Center is available at the following Web site:
http://www.ibm.com/eserver/iseries/infocenter
•
Lotus technotes provide up to date information that was unavailable at
the time this book was published. You can find specific technotes by
searching for the technote number, or you can search for technotes by
entering keywords. Technotes can be accessed from the following Web
address:
http://www.ibm.com/software/lotus/support
14 Installing and Managing Sametime 7.5 for i5/OS
Chapter 2
Preparing the TCP/IP environment
Your Sametime server must be configured to use one or more specific
TCP/IP addresses so that it will not attempt to share TCP/IP ports with any
other tasks on your system. This chapter guides you through the process of
verifying your TCP/IP configuration, making changes if necessary to resolve
conflicts between servers, and gathering the TCP/IP information that you
will need to configure your Sametime server. For detailed information about
connectivity issues, see “Configuring Sametime Connectivity” in the IBM
Lotus Sametime Administrator’s Guide (sthelpad.nsf).
Preparing your TCP/IP environment for Sametime involves the following tasks:
•
Verify host table entries.
•
Verify configuration of existing Domino servers.
•
Select a TCP/IP address for your Sametime server.
•
Add a TCP/IP address.
•
Update your host table.
•
Update the Domain Name Server.
•
Update the configuration of existing Domino servers.
•
Update the IBM HTTP server configuration.
For the same steps using only commands, see Appendix B "Preparing the
TCP/IP Environment Using Commands."
Chapter 2: Preparing the TCP/IP environment 15
Verifying host table entries
To verify your host table entries, follow these steps:
1. Locate your server's host table.
• Open iSeries Navigator.
• Open the system where you plan to install Sametime.
• Click Network.
• Right-click TCP/IP Configuration and select Properties.
• On the TCP/IP Configuration properties panel, click Host Table.
2. Record each host name and the corresponding TCP/IP address as you
may need this information later.
Verifying configuration of existing Domino servers
Note If you do not have any Domino servers configured on your system,
you can skip this section.
To determine which TCP/IP addresses are currently being used by your
Domino servers, follow these steps:
1. From an i5/OS command interface, sign on to your system.
Note The following steps assume that your Domino servers are already
started.
2. Verify the current TCP/IP addresses for each Domino server by entering
the following command:
WRKDOMCSL servername
where servername is the name of your Domino server.
3. From the Domino Console display, type the following command and
press Enter:
sh port tcpip
4. Press F5 to refresh the screen.
The 'show port TCP/IP' command displays the TCP/IP address that the
Domino server is using.
• If the server is using only one TCP/IP address, you will see a specific
TCP/IP Local Address listed along with a port number, which is
typically port 1352. For example, 10.1.2.3:1352.
• If the server is using all active TCP/IP addresses, you will see *:1352
displayed as the Local Address rather than a particular TCP/IP address.
16 Installing and Managing Sametime 7.5 for i5/OS
5. Record the results for each Domino server, as you will use this
information later.
Selecting a TCP/IP address for your Sametime server
In this section you will determine which TCP/IP addresses are already
defined on your system and decide which address you will use for your
Sametime server. You will also determine whether you will need to define
additional TCP/IP addresses in order to avoid conflicts between servers.
1. Open the list of TCP/IP interfaces.
• If necessary, open iSeries Navigator.
• Open the system where you will add Sametime.
• Click Network.
• Click TCP/IP Configuration.
• Click Interfaces.
The right pane shows information about each TCP/IP address on
your server.
2. Verify that each of the TCP/IP addresses that you recorded earlier
(when you looked at the host table or ran the 'sh port tcpip' command) is
currently defined.
3. Verify that the system has enough TCP/IP addresses defined so that you
can assign at least one for the exclusive use of each of the following:
• Your Sametime server.
• Each existing Domino server.
• Each instance of the IBM HTTP server running on your system.
Note Do not attempt to use Domino port mapping.
4. Contact your network administrator to assign additional TCP/IP
addresses and host names if needed.
5. Ensure that the new host names are also added to your Domain Name
Server (DNS).
6. Select the TCP/IP address you will assign to your Sametime server.
7. Decide which TCP/IP addresses should be assigned to each existing
Domino server and each instance of the IBM HTTP server.
8. Record this information, as you will use it later to ensure that existing
servers are properly bound to specific IP addresses. This ensures that
their port usage will not conflict with your Sametime server.
Chapter 2: Preparing the TCP/IP environment 17
If you did not need to have additional TCP/IP addresses defined, skip to
"Updating the host table."
Adding a TCP/IP address
Note If you did not need to assign additional TCP/IP addresses, you can
skip this section.
To add a TCP/IP address to your server, follow these steps:
1. If necessary, open iSeries Navigator.
2. Open the system where you will add Sametime.
3. Click Network.
4. Click TCP/IP Configuration.
5. Right-click Interfaces and select New Interface.
6. Select Local Area Network.
7. Follow the wizard's instructions to configure the TCP/IP interface. If you
need assistance in any window of the wizard, click Help.
Updating the host table
In this section, you will add an entry in the host table for your Sametime
server. If necessary, you will also update the entries for your existing
Domino servers.
To add a host table entry for your Sametime server, follow these steps:
1. Open the host table.
• Open iSeries Navigator.
• Open the system where you plan to install Sametime.
• Click Network.
• Right-click TCP/IP Configuration and select Properties.
• On the TCP/IP Configuration properties display, click the Host Table
tab.
2. Click Add.
3. In the IP Address field enter the TCP/IP address you have chosen to use
for your Sametime server. For example, enter 10.1.2.4.
18 Installing and Managing Sametime 7.5 for i5/OS
4. In the Host name field, enter the fully qualified name for the Domino
server where you will add Sametime. For example, enter
stdom1.acme.com.
Note Although you can add multiple host names for the same IP
address, make sure you list the fully qualified name first, before any
alternative short names. If the fully qualified name is not first on the list
of names associated with the Sametime server's IP address, you must
delete the entries and recreate them in the correct order.
5. If you choose to, enter a description in the Description field.
6. Click OK to add the entry to your server's host table.
7. Click OK to exit the TCP/IP Configuration Properties Window.
Ensure that the host table entries for any existing Domino servers are
correctly defined and they are associated with the TCP/IP addresses you
decided they should use in "Selecting a TCP/IP address for your
Sametime server."
Updating the Domain Name Server
If you defined any additional host names, work with your TCP/IP
administrator to ensure that the new host names are added to your Domain
Name Server (DNS).
If you have configured TCP/IP to search the DNS before searching the host
table, you may need to make additional changes in your configuration.
Follow these steps to check your TCP/IP Configuration Properties:
1. Open iSeries Navigator.
2. Open the system where you will install Sametime.
3. Click Network.
4. Right-click TCP/IP Configuration and select Properties.
Chapter 2: Preparing the TCP/IP environment 19
5. Note the current value of the "Search order".
• If "Search host table first" is selected, you do not need to take any
further action. You already ensured that the fully qualified host name
was listed first in your local host table in an earlier step.
• If "Search name server first" is selected, you need to verify with your
network administrator that the fully qualified host name is the first
value listed in the DNS for the IP address associated with your
Sametime server. The fully qualified host name must be listed first,
before any short names, in order for your Sametime server to function
correctly. Alternatively, you can change the TCP/IP configuration
properties to "Search host table first."
Caution If you decide to change the "Search order" you must stop and
restart TCP/IP in order for the change to take effect.
6. Click OK.
Updating the configuration of existing Domino servers
Note If you do not have any Domino servers configured on your system,
you can skip this section.
In this section, you will ensure that each existing Domino server is correctly
bound to specific TCP/IP addresses that you have assigned to it. This will
prevent them from conflicting with your Sametime server. If necessary, you
will modify the existing Domino server settings to enable partitioning and
specify unique TCP/IP addresses.
20 Installing and Managing Sametime 7.5 for i5/OS
Even if you changed your server's TCP/IP address by modifying the server's
notes.ini file, the change may not have occurred in the server document. This
procedure updates both the server document and the notes.ini file.
Determining whether you need to modify the server properties
For each existing Domino server, complete the following steps to determine
whether you must modify the server properties:
1. Open the Domino server properties.
• Start iSeries Navigator.
• Click Network.
• Click Servers.
• Click Domino.
• In the right hand pane of the iSeries Navigator main window,
right-click the Domino server and choose Properties.
2. Click Network Configuration.
If SYSTEM is specified in the IP address field, then the server is using all
available TCP/IP addresses on that system and you must modify the
configuration so that the server uses only a single TCP/IP address.
3. Click the Services tab.
Note If you already have more than one Domino server on your
system, you may skip this step.
Verify that Partitioning appears in the list of Enabled services. If
necessary, add Partitioning to the list of Enabled services.
4. Click OK to close the server properties.
Modifying the server properties
For each existing Domino server that needs to be modified, complete the
following steps:
1. If your Domino server is active, you must stop it.
• Start iSeries Navigator.
• Open the system where you will install Sametime.
• Click Network.
• Click Servers.
• Click Domino.
• Right-click your Domino server and select Stop.
Note Stopping a Domino server may take a few minutes.
Chapter 2: Preparing the TCP/IP environment 21
2. In the right hand pane of the iSeries Navigator main window,
right-click the Domino server and select Properties to open the
Domino server properties.
3. If necessary, modify the server so that partitioning is enabled.
Note If you already have more than one Domino server on your
system, you may skip this step.
• Click the Services tab.
• Add Partitioning to the list of Enabled services.
4. If necessary, modify network settings so that the Domino server uses
only the TCP/IP address that you selected earlier.
• Click Network Configuration.
• Click on the line you wish to modify.
• Click Modify.
• In the IP address field, click Specify a server host name.
• Enter the fully qualified host name for the Domino server. This is the
host name that your DNS associates with the TCP/IP address that you
specified earlier. For example, dommail1.acme.com.
Note You should not use a numeric TCP/IP address in this field.
• Click OK.
5. In the right hand pane of the iSeries Navigator main window, right-click
the Domino server and choose Start to start the Domino server.
Note Starting a Domino server may take a few minutes.
6. Using a Domino Administrator client, edit the server settings in the
Server Document so that the Domino HTTP server binds to the specific
host name.
• Select the Configuration tab.
• In the left pane, click Server and select All Server Documents.
• Open the server document for the Domino server and click the Edit
Server button.
• Select the Internet Protocols tab, and then select the HTTP tab.
• In the Bind to host name field, select Enabled.
• Select the Ports tab, then select the Internet Ports tab, then select the
Web tab.
• Verify in the HTTP settings that the TCP/IP port has a port number
specified. The default port number is 80.
• Click Save and Close.
7. Stop and restart the Domino server to make the changes take effect.
22 Installing and Managing Sametime 7.5 for i5/OS
8. When the Domino server has restarted, access it through a Notes client
or a Web browser to make sure it is still accessible using TCP/IP.
Updating the IBM HTTP server configuration
Your Sametime server will use the Domino HTTP server. It is possible that
you may have already configured the IBM HTTP server on your system for
other applications. If so, then you must verify that each instance of the IBM
HTTP server is bound to a specific TCP/IP address. This will prevent it from
conflicting with your Sametime server.
If you are certain that you are not using the IBM HTTP server, skip this
section and proceed to "Preparing a new Sametime Environment."
Complete these steps to verify your IBM HTTP server configuration and
change it if necessary:
1. If the IBM HTTP server is currently running, stop it.
• Open iSeries Navigator.
• Open the system where you plan to install Sametime.
• Click Network.
• Click Servers.
• Click TCP/IP.
• In the right pane, right-click HTTP Administration and select Stop
Instance-->All.
2. Start the HTTP Administration server.
• Click Network.
• Click Servers.
• Click TCP/IP.
• In the right pane, right-click HTTP Administration and select Start.
3. Open the IBM HTTP server configurations page.
• Start your Web browser.
• Enter the following URL:
http://mysystem:2001
where mysystem is the name of your system.
• Click IBM Web Administration for iSeries.
• Select the Manage tab.
• Select the HTTP Servers tab.
Chapter 2: Preparing the TCP/IP environment 23
4. Select a configuration from the menu at the top of the screen, and
complete the following items for each configured instance of the IBM
HTTP server.
• From the list on the left pane, select General Server Configuration.
• In the right pane, find the IP address and port table in the section
called Server IP address and ports to listen on.
• If one of the rows in the table has an asterisk (*) in the IP Address
column, then the server is listening on all IP addresses. Select that
row. Replace the asterisk (*) with the IP address for this server and
click Continue.
• When finished updating the server IP address table, click Apply to
save your changes.
5. When each instance of the IBM HTTP server is configured to use a
specific IP address, restart the HTTP servers.
• Open iSeries Navigator.
• Open the system where you plan to install Sametime.
• Click Network.
• Click Servers.
• Click TCP/IP.
• In the right pane, right-click HTTP Administration and select either
Start Instance-->All, or select the particular server instances you
would like to start.
For more information on managing the IBM HTTP server, see the IBM
eServer iSeries Information Center at
http://www.ibm.com/eserver/iseries/infocenter
You have finished preparing the TCP/IP environment, and can proceed to
Chapter 3 "Preparing a new Sametime environment."
24 Installing and Managing Sametime 7.5 for i5/OS
Chapter 3
Preparing a new Sametime environment
Note If you are upgrading from an earlier Sametime release, skip to
Chapter 4 "Preparing to upgrade an existing Sametime environment."
This chapter helps you prepare a new Sametime environment on your
system. When you set up the Sametime environment, you must always add
Sametime to a Domino server. This chapter covers the following information:
•
Sametime configuration options
•
Setting up a Domino server in a new Domino Domain
•
Setting up a Domino server in an existing Domino Domain
•
Installing and configuring the Notes client and Domino Administrator
client
•
Verifying the Domino server configuration for the addition of Sametime
•
Verifying the Domino server is accessible
Note If you plan to use replication functions in your Sametime
environment, do not replicate the Sametime Configuration Database
(stconfig.nsf) from one server to another.
Sametime configuration options
If you do not have any Domino servers configured in the environment where
you plan to install Sametime, then skip to the next section in this chapter,
"Setting up a Domino server in a new Domino Domain."
If you already have a Domino server configured in the environment where
you will install Sametime, you have the option of setting up the Sametime
environment in one of the following ways:
•
Set up a new Domino server in a new Domino domain (*FIRST), and add
Sametime to that server.
•
Add an additional Domino server to the existing Domino domain
(*ADD), and add Sametime to that server.
Important Note: Adding Sametime to an existing production Domino server
is not supported. Instead, create a new Domino server for running Sametime.
The new Domino server can reside on the same system as your existing
Chapter 3: Preparing a new Sametime environment 25
production server. Using separate servers allows you to tune the servers
individually for optimal performance. In addition, you can stop one of the
servers for maintenance without affecting the other.
The following sections describe the supported Sametime configuration
options.
Setting up a new Domino server and adding Sametime
When you set up a new Domino server in a new Domino domain and
add Sametime:
•
No users are in the Domino Directory at the time the server is created.
•
The server is in its own Domino domain (also known as a Sametime
Community) and cannot access Domino servers outside the Sametime
Community. You cannot establish a connection to any existing Domino
mail or application servers outside of this community.
w You can add new users after initial setup by using the Sametime
Administration tool, connecting to an LDAP directory server, or enabling
self-registration and allowing users to register themselves. Using the
Sametime Administration tool or self-registration will create person
documents in the Domino Directory, but neither of these methods will
create Notes user IDs for the Sametime users. For more information on
using the Sametime Administration tool or allowing self-registration, see
the IBM Lotus Sametime 7.5 Administrator’s Guide (sthelpad.nsf).
•
Users only see other users online if they are registered in the same
community.
w You can create additional Sametime servers and add them to this
Sametime Community to balance the meeting services load and
distribute users among the Sametime servers to balance the community
services load.
Adding a Domino server to an existing Domino domain, and then
adding Sametime
When you add a Domino server to an existing Domino domain and then
add Sametime:
•
Users from the Domino Directory appear in the directory on the
Sametime server. However, before they can use Sametime, you need to
be sure each entry has an Internet password specified. In this case, self
registration should not be enabled as duplicate IDs for the same users
may be created.
26 Installing and Managing Sametime 7.5 for i5/OS
•
The Domino Directory is shared by servers in the Domain. Users can
access the directory from the Sametime Web interface and change
settings. This way of setting up a Domino server poses a greater security
risk than setting up a new Sametime server in its own community.
•
You add new Sametime users after the initial set up by replicating your
directory from the Domino server to the Sametime server. You should
not replicate from the Sametime server to the Domino server.
w Users can see all members registered in the Domino Directory and
determine if they are online.
Setting up a Domino server in a new Domino domain
Follow these steps to set up a Domino server in a new Domino domain.
1. Launch the appropriate setup wizard in iSeries Navigator, depending on
whether or not you have already installed Domino.
If you have not already installed Domino, use the Domino EZ-Setup
wizard to install Domino software on your system, configure the
Domino server, and install the Domino iSeries Navigator plug-in on your
workstation. To launch the EZ-Setup wizard:
• Open iSeries Navigator.
• Open the system where you will install Domino.
• Click Network.
• Right-click Servers and select Install and Configure Domino.
If you have already installed Domino, use iSeries Navigator to configure
the new server. To launch the New Domino server setup wizard:
• Open iSeries Navigator.
• Open the system where you will add Domino.
• Click Network.
• Click Servers.
• Right-click Domino and select New Domino server to launch a Java
based setup wizard.
2. Follow the instructions on each wizard display to configure the new
Domino server. Be sure to specify that you are configuring a Domino
server in a new domain. If you need help with a particular setting,
click Help.
Chapter 3: Preparing a new Sametime environment 27
3. Configure the Domino server with the following settings:
Note This chapter only documents settings that directly apply to this
Sametime installation. For settings that are not documented below, you
can enter your own values.
Display
Description
Server Name
Enter the name of the new Domino server where you
will add Sametime. For example, specify STDOM1.
Advanced server
settings
Specify Yes for Enable server partitioning to allow
multiple Domino servers to run on the same system.
Domain Name
Enter the name of the Domino domain. For example,
enter Acme.
Administrator's
Name and Password
Specify the Domino administrator's name. This
administrator will also be the Sametime server
administrator.
Specify a password for the Domino Administrator.
Internet Services
Select Web Browsers (HTTP services).
Sametime requires that you use the Domino HTTP
server.
Deselect Directory Services (LDAP services).
Even if you plan to use an LDAP directory, you
should not run it on the same server where you run
Sametime.
Domino Network
Settings
Advanced Network
Settings
Click Customize to view the Advanced Network
Settings.
Click the checkbox associated with the IP address for
this server. Ensure that only one checkbox is selected.
You must edit the Host Name field and replace the IP
address with the fully qualified Internet host name for
this server. Type over the IP address displayed in the
Host Name column and replace it with the fully
qualified host name for the server. For example,
STDOM1.ACME.COM. You must press Enter for the
change to take effect.
Also, type the fully qualified host name in the field at
the bottom of the display.
When finished, click OK and continue until Domino
server setup is complete.
4. Start the Domino server if it is not already started.
28 Installing and Managing Sametime 7.5 for i5/OS
You have finished configuring the server. Continue to "Installing and
configuring the Notes client and Domino Administrator" later in this chapter.
Adding a Domino server to an existing Domino domain
To add a Domino server to an existing Domino domain, follow these steps:
1. Register the additional server for your normal operating environment.
You must specify the following settings during registration:
• Store the server ID file that is created during registration somewhere
on the system where you will configure the Sametime server. Record
the path name; you will need to specify it when you configure the
Sametime server.
• Change the owner of the ID file to Qnotes by right-clicking the file in
iSeries Navigator and selecting Permissions.
In the Permissions dialog box, change the owner to Qnotes and make
sure all checkboxes are checked, except Exclude.
• Use the same network name as the first Domino server in the
Domino domain.
For detailed information about registering an additional server, see the
Lotus book, Installing and Managing Domino 7 for i5/OS.
Launch the appropriate setup wizard in iSeries Navigator, depending on
whether or not you have already installed Domino.
If you have not already installed Domino, use the Domino EZ-Setup
wizard to install Domino software on your system, configure the
Domino server, and install the Domino iSeries Navigator plug-in on your
workstation. To launch the EZ-Setup wizard:
• Open iSeries Navigator.
• Open the system where you will install Domino.
• Click Network.
• Right-click Servers and select Install and Configure Domino.
If you have already installed Domino, use iSeries Navigator to configure
the new server. To launch the New Domino server setup wizard:
• Open iSeries Navigator.
• Open the system where you will add Domino.
• Click Network.
• Click Servers.
• Right-click Domino and select New Domino server to launch a Java
based setup wizard.
Chapter 3: Preparing a new Sametime environment 29
2. Follow the instructions on each wizard display to complete the addition
of the new Domino server. Be sure to specify that you are configuring an
additional Domino server in an existing domain. If you need help with a
particular setting, click Help.
3. Configure the Domino server with the following settings:
Note This chapter only documents settings that directly apply to this
Sametime installation. For settings that are not documented below, you
can enter your own values.
Display
Description
Registered Name
Provide the registered name of the additional Domino
server where you will add Sametime. For example,
specify Sales1/Acme.
Advanced server
settings
Specify Yes for Enable server partitioning to allow
multiple Domino servers to run on the same system.
Internet Services
Select Web Browsers (HTTP services).
Sametime requires that you use the Domino HTTP server.
Deselect Directory Services (LDAP services).
Even if you plan to use an LDAP directory, you should
not run it on the same server where you run Sametime.
Domino Network
Settings
Advanced Network
Settings
Click Customize to view the Advanced Network Settings.
Click the checkbox associated with the IP address for this
server. Ensure that only one checkbox is selected.
You must edit the Host Name field and replace the IP
address with the fully qualified Internet host name for
this server. Type over the IP address displayed in the
Host Name column and replace it with the fully qualified
host name for the server. For example,
STDOM1.ACME.COM. You must press Enter for the
change to take effect.
Also, type the fully qualified host name in the field at the
bottom of the display.
When finished, click OK and continue until Domino
server setup is complete.
You have finished configuring the server. Continue to "Installing and
configuring the Notes client and Domino Administrator client" later in this
chapter. If you have already installed and configured the Notes client and
Domino Administrator, continue to "Verifying the Domino server
configuration for the addition of Sametime."
30 Installing and Managing Sametime 7.5 for i5/OS
Installing and configuring the Notes and Domino Administrator clients
If you have not already done so, you must set up at least one workstation as
an Administration workstation for your Domino server. Using the Domino
software that shipped with Sametime, install and configure the Notes Client
and Domino Administrator Client on each workstation you wish to use to
administer the Domino server.
To install and configure the Notes Client and Domino Administrator Client,
follow these steps:
1. Install the Notes Client.
• Insert the Notes Client CD into the Sametime Administrator's workstation.
• Follow the instructions on each display of the Notes installation
wizard, selecting to install the Notes Client and the Domino
Administrator Client.
2. Using FTP or the drag and drop method in iSeries Navigator, copy the
certifier ID and administrator ID files from the Domino data directory on
your system to the Notes data directory on the Administrator workstation.
3. Open Lotus Notes.
4. Follow the instructions in the setup wizard to configure the Notes Client.
When you have completed configuration, continue to "Verifying the Domino
server configuration for the addition of Sametime."
Verifying the Domino server configuration for the addition of Sametime
Before you add Sametime, you must verify that the Domino server document
is correct.
1. If necessary, start the Domino server.
• Open iSeries Navigator.
• Open the system where you will install Sametime.
• Click Network.
• Click Servers.
• Click Domino.
• Right-click the Domino server and select Start.
Note Starting the Domino server may take a few minutes.
2. Using a Domino Administrator client, verify the contents of the Server
document and update it if necessary.
• Select the Configuration tab.
• In the left pane, click Server and select All Server Documents.
Chapter 3: Preparing a new Sametime environment 31
• Open the server document for the Domino server and click the Edit
Server button.
3. Verify the content of the following fields:
Tab
Security
Ports-Notes
Network Ports
Field
Programmability
Restrictions: Run
unrestricted
methods and
operations
Port
Setting
If you have signed agents with a different
signature, then enter that signature here too.
TCPIP
Note This must be specified exactly as
shown or you will not be able to add
Sametime to this server.
The fully qualified host name for the Domino
server.
This must not be an IP address and it should
match the name specified below in the
InternetProtocols-HTTP Host Name field.
Ports-Notes
Network Ports
Net Address
Internet
Protocols-HTTP
Basics: Host
Name(s)
Internet
Protocols HTTP
Basics: Bind to
host name
Enabled
Internet
Protocols-HTTP
Mapping: Home
URL
If running the full version of Sametime, the
Sametime server home page should normally
be the default page for the server so users can
download Sametime Connect and attend
meetings. Specify the following value:
For example, stdom1.acme.com.
The DNS name for the TCP/IP address for
your Sametime server. This should match the
name specified above in the Ports-Notes
Network Ports Net Address field.
For example, stdom1.acme.com.
stcenter.nsf?Open
For the Instant Messaging Limited Use
version of Sametime, only administrators
need to access the Sametime server. Specify
the following value if you want the Sametime
Administration Tool to be the default page
for the server:
http://my.server.com/servlet/auth/admin
where my.server.com is your server's fully
qualified host name.
32 Installing and Managing Sametime 7.5 for i5/OS
4. Click Save and Close.
5. If you made changes to the server document, you must stop and restart the
Domino server for the changes to take effect.
To stop the Domino server:
• Open iSeries Navigator.
• Open the system where you will install Sametime.
• Click Network.
• Click Servers.
• Click Domino.
• Right-click the Domino server and select Stop.
Note Stopping the Domino server may take a few minutes.
To restart the Domino server:
• Click Network.
• Click Servers.
• Click Domino.
• Right-click the Domino server and select Start.
Note Starting the Domino server may take a few minutes.
You have finished configuring the server. Continue to "Verifying the Domino
server is accessible" later in this chapter.
Verifying the Domino server is accessible
Before installing Sametime and adding it to your Domino server, verify that
the Domino server is accessible from client workstations.
To verify that the Domino server is accessible from a client workstation, start
a Web browser on the workstation and attempt to access names.nsf by
entering the following address into the location bar:
http://hostname.yourco.com/names.nsf
where hostname.yourco.com is the host name of the Domino server.
If you can view the contents of names.nsf, the Domino server is accessible
and ready for installation of Sametime.
You have now prepared the Sametime environment on your system.
Continue to Chapter 5 "Installing Sametime."
Chapter 3: Preparing a new Sametime environment 33
34 Installing and Managing Sametime 7.5 for i5/OS
Chapter 4
Preparing to upgrade an existing Sametime environment
Whether you are upgrading your current Sametime installation to IBM Lotus
Sametime 7.5, Instant Messaging Limited Use or to IBM Lotus Sametime 7.5,
this section contains information that you need to know. This chapter
contains the following sections:
•
Summary of upgrade considerations by release
•
Preparing to upgrade your servers
•
Backing up your data
•
Upgrading from Instant Messaging Limited Use to the full version of
Lotus Sametime
Chapter 4: Preparing to upgrade an existing Sametime environment 35
Summary of upgrade considerations by release
The following table summarizes considerations for upgrading to Sametime
7.5 from previous releases.
Upgrading from
release
Sametime 7.0
or earlier
Considerations
w IBM i5/OS V5R3 or V5R4 is required
w Domino 7 is required
w It is now recommended that you always install
w
w
Sametime 6.5.1
or earlier
w
w
Sametime 3.1
or earlier
w
w
Cryptographic Access Provider 128-bit for iSeries (5722AC3)
on your IBM System i server. 5722AC3 is included with all
orders for i5/OS V5R3 and V5R4.
For servers with Web Conferencing capability: If you are
currently using Sametime Conversion Services, you must
uninstall the version you are currently using and install the
7.5 version. Also, the requirements for the Windows system
where you run the conversion services have changed; there
are new options for running it, and how you configure it
has changed. For more information, see "Preparing to
upgrade your servers."
If you have a mixed environment which includes both full
Sametime servers and Instant Messaging Limited Use
servers on the same system, your Instant Messaging
Limited Use Servers will be changed to full Sametime
servers when you upgrade to Sametime 7.5. To change the
servers back to Instant Messaging Limited Use servers after
upgrade, see "Changing an existing server to limited use or
full Sametime."
All considerations listed above.
The format of the Key Store used for SSL changed in
Sametime 7.0. If your Sametime server is configured for
SSL, you must perform some additional steps after
upgrading to Sametime 7.5. See "Completing the upgrade
process" for more information.
All considerations listed above.
For servers with Web Conferencing capability: In order to
save the contents of the meeting room whiteboard,
Sametime no longer requires the use of iSeries Tools for
Developers, 5799PTL. OS/400 - Portable Application
Solutions Environment (PASE), 5722SS1 option 33, is still
required. Configuring this capability is much easier than it
was for Sametime 3.1 and earlier releases. See "Enabling the
capability to save whiteboard contents" for more
information.
36 Installing and Managing Sametime 7.5 for i5/OS
Preparing to upgrade your servers
This section highlights some changes to the required software for this release
that have a significant effect on the upgrade process. This is not a complete
list of the prequisites. You should also review the section "Lotus Sametime
requirements."
•
i5/OS V5R3 or V5R4 is required.
If your system is running OS/400 V5R1 or V5R2, you must upgrade the
operating system before installing Sametime 7.5.
Sametime releases prior to Sametime 3.1 are not supported on i5/OS
V5R3 or later. If you are currently running a release of Sametime prior to
3.1, consider upgrading to Sametime 3.1 or 6.5.1 (on Domino 6.0.3/6.5.0
or later) before upgrading the operating system.
Consider other Domino servers and Domino Extended Products that
may be running on the same system in your upgrade plans. Make sure
that your currently installed server releases are all supported on the new
operating system level.
For the most up to date and detailed information about the combinations
of Domino, Sametime, QuickPlace, and other Domino Extended Product
releases that are supported on i5/OS V5R4 and previous operating
system releases, see the Lotus Software for i5/OS Compatibility Guide on the
Web at
http://www.ibm.com/eserver/iseries/domino/domino6/releasesupport.pdf
•
Domino 7 is required.
If you are currently running Sametime 7, then your Sametime servers are
already running Domino 7. If you are using an earlier release of
Sametime, you must upgrade each of your existing Sametime servers to
Domino 7 using the UPDDOMSVR command before installing Sametime
7.5. If you do not upgrade a server to Domino 7 before installing
Sametime 7.5, the upgrade will fail for that server. To correct this
problem, you must go back and upgrade the server to Domino 7 and
then install Sametime again.
Keep in mind that any Sametime servers that are currently running a
multi-version capable Domino release are not updated automatically
when you install Domino 7. Therefore, if your Sametime servers are
currently using any multi-version release, you can install Domino 7 at
any convenient time. However, you should not update the Sametime
servers to Domino 7 until you are ready to install Sametime 7.
Chapter 4: Preparing to upgrade an existing Sametime environment 37
Once you complete the upgrade process, all of your Sametime servers
will be running Sametime 7.5 and Domino 7. However, Domino
multi-versioning allows you to have other Domino servers running
different releases of Domino in the same LPAR. Therefore, you might
choose to upgrade other Domino servers to 7.0 before upgrading your
Sametime server. For example, you can upgrade your mail server to
Domino 7.0 and continue to run Sametime 6.5.1 on Domino 6.5.x until
you are ready to upgrade to Sametime 7.5.
Finally, when upgrading, be sure to take into consideration the upgrade
requirements of any other Domino servers or Domino Extended
Products that you may have integrated with Sametime. For example,
Lotus QuickPlace recommends that if you have configured QuickPlace
and Sametime integration that you upgrade your QuickPlace server to 7
before upgrading your Sametime server to 7.5.
•
Sametime Conversion Services upgrade is required.
If you have been using Sametime Conversion Services with your current
release of Sametime, there are several changes for Sametime 7.5 that you
need to be aware of. The significant impacts to the upgrade process are
highlighted below but you should consult the Meeting Services section
of the Lotus Sametime 7.5 Administrator's Guide for detailed information.
The requirements for the Windows system where you run the
conversion services have changed. Make sure the system you are
planning to use satisfies the requirements for 7.5.
You must uninstall the version of Sametime Conversion Services you are
currently using and then install the 7.5 version from the Sametime
Components CD. The new version may be installed as a standalone
Windows service but Sametime 7.5 also provides the option to configure
a Domino server on the Windows system and then install the conversion
services as a Domino servlet.
When you upgrade your Sametime server, the conversion server IP
address and port number that were previously stored in the
meetingserver.ini file are migrated to a new file in the server data
directory called stconvservices.properties. You must update this file if
the IP address or port for your Conversion Server have changed.
•
Cryptographic Access Provider 128-bit (5722AC3) is recommended.
It is now recommended that you install Cryptographic Access Provider
128-bit for iSeries (5722AC3) on your system. 5722AC3 is included with
all orders for i5/OS V5R3 and V5R4. Prior to Sametime 7, this product
was recommended only for installations that use the Secure Sockets
Layer (SSL) protocol to encrypt connections with the Sametime server.
Do not upgrade to Sametime 7.5 until you have installed or upgraded
5722AC3.
38 Installing and Managing Sametime 7.5 for i5/OS
•
If you are using the Instant Messaging Limited Use version of Sametime,
you may need to update the Home URL in your server document.
You can no longer specify the Sametime server home page as the default
page for users accessing the server. Instead, you may wish to set the
Sametime Administration Tool as your Home URL. For more
information, see "Verifying the Domino Server configuration for the
addition of Sametime."
Backing up your data
Before installing Sametime 7.5, you should back up important server data in
case an error occurs during the upgrade process.
If you are planning to install the Instant Messaging Limited Use version of
Sametime, back up the following data:
•
names.nsf - This is optional if you can replicate from another Domino server.
•
vpuserinfo.nsf - This contains user storage and privacy information,
such as buddylist.
•
streg.nsf - Back up this file only if self-registration is enabled.
•
da.nsf - Back up this file if you are using directory assistance.
•
notes.ini - Back up this file for possible reference.
•
Any Teamrooms and Discussion databases
•
Any custom templates or applications
If you are planning to install the full version of IBM Lotus Sametime, back up
the following files in addition to all of the files listed above:
•
Files with the extension *.RAP - This will back up the recorded meeting
files, typically found in a subdirectory.
If you have changed any values in the meetingserver.ini file, be aware that
only the following settings are preserved when you upgrade Sametime:
•
Attachment Conversion Services IP address and port settings located in
the following section are moved to the stconvservices.properties file
during upgrade:
[SOFTWARE\Lotus\Sametime\MeetingServer\ConversionServices]
•
-Djava.awt.headless setting
•
StartWaitTime= setting located in the following section:
[SOFTWARE\Lotus\Sametime\MeetingServer\Services]
•
ConfigWaitTime= setting located in the following section:
[SOFTWARE\Lotus\Sametime\MeetingServer]
Chapter 4: Preparing to upgrade an existing Sametime environment 39
Note that it is not necessary to back up the following files, as they are saved
automatically during the upgrade process:
•
meetingserver.ini
•
sametime.ini
•
stconfig.nsf.
For more information, see "Completing the upgrade process" in Chapter 5.
Upgrading from Instant Messaging Limited Use to the full version of
Lotus Sametime
Lotus Sametime for i5/OS allows you to easily upgrade from the Instant
Messaging Limited Use version of Sametime to the full version of Sametime,
provided they are the same release. Because upgrading to the full version of
Sametime merely involves installing an additonal product option (option 1),
you can perform the upgrade with minimal disruption to your existing
environment.
Note If you are upgrading from the Instant Messaging Limited Use version
of Sametime 7.0 to the full version of Sametime 7.5, this section is not
applicable. When upgrading to 7.5 from any previous release, whether
limited use or full Sametime, simply follow the standard upgrade
instructions detailed in this chapter.
If you are already using the Instant Messaging Limited Use version of
Sametime, then you have already performed many of the tasks necessary to
support the full version. This topic provides the remaining steps necessary to
upgrade an existing environment where only the *BASE product option is
installed, to a full Sametime environment featuring the Web Conferencing
capabilities of product option 1.
Notes
•
When upgrading to the full version of Sametime, all existing Instant
Messaging Limited Use servers are automatically upgraded to full
Sametime servers. If you want to change the servers back to Instant
Messaging Limited Use servers, see "Changing an existing server to
limited use or full Sametime."
•
If you installed the Sametime Language Pack for your Instant Messaging
Limited Use environment, you do not need to install the Language Pack
again after upgrading to the full version of Sametime.
40 Installing and Managing Sametime 7.5 for i5/OS
To upgrade to the full version of Sametime:
1. If you plan to enable the capability to save whiteboard contents, install
the following software:
OS/400 - Portable Application Solutions Environment (PASE), 5722SS1
option 33
To configure Sametime to save whiteboard contents, see the topic
"Enabling the capability to save whiteboard contents" in Chapter 8.
2. Install Lotus Sametime, 5724J23, option 1:
• Sign on to your system with a user profile that has the appropriate
i5/OS authorities. For more information, see "i5/OS authorities
required to install and set up Sametime."
• Stop all existing Sametime servers.
• Insert the Lotus Sametime for i5/OS CD in your server's optical drive.
• Enter the following command to install option 1:
RSTLICPGM LICPGM(5724J23) DEV(<OPTICAL>) OPTION(1)
where <OPTICAL> is your server's optical drive (example: OPT01).
3. You may want to update the Home URL in your server document. For
more information, see "Verifying the Domino server configuration for
the addition of Sametime ."
4. Make Lotus Sametime Connect available to your users. For more
information, see "Copying Lotus Sametime Connect to your Sametime
server."
5. Complete the steps in "Validating Sametime Instant Messaging" that
pertain to full Sametime servers.
6. Make sure Sametime Web Conferencing is working as expected. For
more information, see "Validating Sametime Web Conferencing."
Chapter 4: Preparing to upgrade an existing Sametime environment 41
42 Installing and Managing Sametime 7.5 for i5/OS
Chapter 5
Installing Sametime
This chapter describes the following tasks:
•
Pre-accepting the Lotus Sametime software agreements
•
Installing or upgrading Sametime
•
Verifying your library list
•
Installing the Sametime Language Pack
•
Adding Sametime to a Domino server
•
Copying Lotus Sametime Connect to your Sametime server
•
Validating Sametime Instant Messaging
•
Validating Sametime Web Conferencing
•
(Upgrade only) Completing the upgrade process
Pre-accepting the Lotus Sametime software agreements
It is highly recommended that you display and accept the Lotus Sametime
software agreements before installing Sametime. If you do not pre-accept the
software agreements, the installation process will restore the product to the
system, but then stop and wait for you to accept the agreements before
completing the installation.
1. Insert the Lotus Sametime CD into the optical drive of your system.
2. Enter the following command on an i5/OS command line:
GO LICPGM
The Work with Licensed Programs display appears.
3. From the Work with Licensed Programs (LICPGM) menu, select option 5
(Prepare for install) and press Enter. The Prepare for Install display appears.
4. Type 1 in the option field next to Work with software agreements.
Press Enter.
When the Work with Software Agreements display appears, you see all
IBM licensed programs that require software agreement acceptance and
whether the agreement has been accepted. Only licensed programs that
are not yet installed appear on this display. The software agreements for
Lotus Sametime will not appear in the list until you restore them from
the CD in a later step.
Chapter 5: Installing Sametime 43
5. Press F22 (shift-F10) to restore the Software Agreements from the Lotus
Sametime CD.
For the Device parameter, specify the name of your optical drive. For
example, OPT01. Press Enter to restore the Sametime software
agreements to the system.
6. Once the Software agreements are restored from the Sametime CD, the
following message is displayed:
Waiting for reply to message on message queue QSYSOPR.
You can sign on to another session to respond to the message or ask the
system operator to respond.
To view and respond to the message from another session:
• Enter the following command on an i5/OS command line:
WRKMSGQ QSYSOPR
• Select option 5 to display the messages in the QSYSOPR message queue.
• Locate the following message in the queue:
Load the next volume in optical device OPT01. (X G)
The Lotus Sametime software agreements have been restored. If you
want to restore more software agreements from another product CD,
insert the next CD and respond with G. When the sofware agreements
have been restored from the next CD, the message is issued again.
When you are done, respond to the message with X.
7. The Work with software agreements display should now show the
restored licenses for products that are not yet installed.
• If you are using the CD for the Instant Messaging Limited Use version
of Lotus Sametime, you will see an entry for Licensed Program
5724J23, option *BASE.
• If you are using the CD for the full Lotus Sametime product, you will
see two entries for Licensed Program 5724J23: one entry for *BASE
and another entry for Option 1.
8. For each entry for Licensed Program 5724J23, type 5 in the option field
and press Enter to display the Software Agreement. Then press F14
(Accept) to accept the terms of the software agreement.
44 Installing and Managing Sametime 7.5 for i5/OS
Installing or upgrading Sametime
To install Sametime on your system, follow these steps:
1. If you are upgrading from a previous release of Sametime, review the
information in Chapter 4 "Preparing to upgrade an existing Sametime
environment." Make sure you have backed up the recommended files to
a directory outside of your Sametime directory structure or to a physical
media before proceeding.
2. Sign on to your server with a user profile that has the appropriate
i5/OS authorities.
For more information on the proper authorities, see "i5/OS authorities
required to install and set up Sametime" in Chapter 1.
3. Stop the Domino server where you will add Sametime. If you are
upgrading from an earlier Sametime release, you must stop all existing
Sametime servers.
Note If any existing Sametime servers have not yet been upgraded to
Domino 7, run the UPDDOMSVR command to upgrade them now. If
you do not upgrade a server to Domino 7 before upgrading to Sametime
7.5, the upgrade will fail for that server. To correct this problem, you
must go back and upgrade the server to Domino 7 and then install
Sametime again.
4. Insert either the Lotus Sametime CD or the Lotus Sametime, Instant
Messaging Limited Use CD in your server's optical drive.
5. Using the i5/OS command interface, such as a 5250 emulator window,
type the following command and press F4:
LODRUN
6. On the LODRUN panel, type the following value in the Device field and
press Enter:
*opt
7. In the Directory field, type the following value and press Enter:
/os400
The system loads the Sametime programs to the appropriate libraries
and /QIBM directories. You will see status messages as the system
installs the software.
Chapter 5: Installing Sametime 45
If you are upgrading from an earlier Sametime release, all of your existing
Sametime servers are upgraded during the install process. Check the job log
to verify that all of your existing Sametime servers were upgraded
successfully. You should see the following message for each Sametime server
the was successfully upgraded on your system:
Upgrade successful for Lotus Sametime server <servername>
In addition, you may need to refresh the design of your Sametime databases.
Normally the design of each of the databases is refreshed by the nightly
Design server task. Alternatively, you can force an immediate database
design refresh completing this steps:
8. On any i5/OS command line, type the following command and press Enter:
WRKDOMCSL
9. On the Work with Domino Console display, type the name of your
Sametime server and press Enter.
10. At the command prompt, type the following Domino subcommand and
press Enter:
LOAD DESIGN
Verifying your library list
You have just installed the English version of Sametime.
If the primary language of your system is not English, follow these steps to
verify that QSYS2924 is in your library list:
Note If the primary language of your system is English, you do not need to
modify your library list.
1. From an i5/OS command line, type the following command and
press Enter:
WRKSYSVAL QSYSLIBL
2. On the Work with System Values display, type a 2 next to QSYSLIBL
and press Enter.
3. On the Change System Value display, check whether QSYS2924 is
included in the list. If it is listed, press F3 to Exit. If it is not listed,
proceed to step 4.
4. Type QSYS2924 next to Sequence Number 0 and press Enter.
5. Press F3 to Exit.
6. If you changed the library list, sign off the system and sign back on to
activate the new library list.
46 Installing and Managing Sametime 7.5 for i5/OS
If you will only deploy the English version of Sametime, skip to "Adding
Sametime to a Domino Server."
If you plan to deploy Sametime in a language other than English, proceed to
"Installing the Sametime Language Pack."
Installing the Sametime Language Pack
If you prefer that the Sametime Meeting Center use a language other than
English, you should install a Sametime Language Pack. The Meeting Center
is displayed in the same language for all users. Note that each individual
user can always control the language that is displayed when administering a
server, attending a meeting, or using the Sametime Connect Client; these
interfaces are not affected by the Language Pack.
If you do not plan to install a Sametime Language Pack, skip to "Adding
Sametime to a Domino server."
When you install a Sametime Language Pack:
•
You should also install the Domino Language Pack for the same
language. If a Domino Language Pack is not available for your preferred
language, see technote 1242066 "Sametime: Domino language pack
unavailable for some supported languages" for instructions. The
technote is available at
http://www.ibm.com/support/docview.wss?rs=203&uid=swg21242066
•
Only one language can be installed in a Logical Partition (LPAR).
•
The language you select during installation is always used for the
Sametime Meeting Center, the Meeting Center help, and the help text
associated with Sametime clients from releases prior to 7.5.
•
To determine which language is installed, check the following file on
your Sametime server:
<server_data_directory>/domino/html/sametime/buildinfo.txt
Installing the Language Pack
To install the Sametime Language Pack from CD-ROM, follow these steps:
1. Place the Sametime 7.5 Language Pack for i5/OS CD in your server's
optical drive. The translated language files are located in the
Languagepack directory on this CD.
2. Sign on to your system with the same user profile you used to install the
Sametime product.
3. Stop all of the Sametime servers on the system.
Chapter 5: Installing Sametime 47
4. On any i5/OS command line, type the following command and
press Enter:
RSTLSTLNG
5. On the Restore Lotus Sametime Language display, type the following
value in the Device field and press Enter:
*opt
6. Type a 1 next to the language you want to install and press Enter.
The translated files for the language you specified will be copied to the
Sametime product data directory, and the English files will be
overwritten. Any new Sametime servers that you configure in the future
will automatically use the language files that you have just installed.
If you are upgrading from an earlier Sametime release and have existing
Sametime servers, the Language Pack install process automatically
updates the Sametime files on each of your existing Sametime servers.
Note When you display the software installed on your server, the Sametime
English language feature (2924) will still appear to be installed.
You have completed the Language Pack installation. If you are running
Sametime on a DBCS system (Japanese, Korean, Simplified Chinese or
Traditional Chinese), proceed to "Installing additional fonts for double-byte
languages." Otherwise, proceed to "Adding Sametime to a Domino Server."
Installing additional fonts for double-byte languages
By default, four sets of single-byte character fonts are always installed with
Sametime. These fonts are used for displaying characters on the meeting
room whiteboard. If you are running Sametime on a DBCS system (Japanese,
Korean, Simplified Chinese or Traditional Chinese), you should copy two
additional fonts to your server from the Sametime Components CD.
1. Locate the \TrueTypeFonts directory on the Components CD and find
the subdirectory that matches the language of your Sametime server.
2. Copy both of the files from the subdirectory to the following directory
on your server:
/QIBM/ProdData/Lotus/Sametime/Shared/ttfonts
3. Run the Change Owner (CHGOWN) command to change the owner of
both of the files to QNOTES.
Note The Sametime server always uses the font file that matches the CCSID
of the server. For example, suppose that the server CCSID is Korean but one
of the meeting attendees is using a Japanese client. If this meeting attendee
attempts to write Japanese characters on the whiteboard, the server will
48 Installing and Managing Sametime 7.5 for i5/OS
misinterpret the characters and display them for the other attendees as a
meaningless string of Korean characters.
Proceed to "Adding Sametime to a Domino Server."
Removing the Language Pack
To remove a Sametime Language Pack, reinstall the English version of
Sametime 7.5 using the steps described earlier in this chapter. This will
install the English version of the files in the Sametime product's data
directory and the Sametime server's data directory.
Adding Sametime to a Domino Server
Note If you are upgrading from a previous version of Sametime, your
existing Sametime servers were automatically upgraded when you installed
the new release of Sametime. If you do not need to configure a new
Sametime server, skip to "Copying Lotus Sametime Connect to your
Sametime server."
To add Sametime to a Domino server, sign on to your server using an i5/OS
command interface and follow these steps:
1. Stop the Domino server.
2. On any i5/OS command line, type the following command and press F4:
ADDLSTDOM
3. In the Domino server name field, type the name of the Domino server
where you will add Sametime.
4. In the Directory type field, type either *DOMINO or *LDAP and press
Enter to select which type of directory Sametime will use.
• If you chose *DOMINO, skip to step 5.
• If you chose *LDAP, complete the following fields:
Note For more information about using an LDAP directory, see the
Sametime Administrator's Guide (sthelpad.nsf).
Field
Name
Port
Description
Enter the name or TCP/IP address
of the LDAP server that Sametime
will use.
Enter the IP port that Sametime
will use. The default IP port for
LDAP connections is 389.
5. In the Allow HTTP Tunneling field, type either *YES or *NO and press
Enter to display additional parameters.
Chapter 5: Installing Sametime 49
Note This option enables Sametime clients that operate behind
restrictive firewalls to connect to the Sametime server and use the
presence, chat, screen-sharing, whiteboard, and broadcast features of
Sametime.
6. Complete the following fields:
Note You may need to press the Page Down key to view these fields.
Field
Description
HTTP server port
If you chose to allow HTTP tunneling,
specify the port number on which the
HTTP server will listen. The default is
8088.
Event server port
Enter the port on which the Event Server
service for this Sametime server should listen.
Note If you have more than one Sametime
server installed on the same logical partition
(LPAR) of your server, make sure each Event
Server service listens on a different port.
Enter the port on which the Token Server
service for this Sametime server should listen.
Note If you have more than one Sametime
server installed on the same logical partition
(LPAR) of your server, make sure each Token
Server service listens on a different port. Refer
to the technote "Sametime for iSeries: Verifying
Each Server on System Uses Unique Ports" for
information on determining which Sametime
ports are already in use. The technote is
available on the Web at the following address:
Token server port
http://www-1.ibm.com/support/docvie
w.wss?rs=203&uid=swg21212892
Slide conversion
server
Accept the default of *NONE or specify the
fully qualified host name or IP address of a
Windows system where you will install
Sametime Conversion Services. When a file is
attached to a meeting, the Sametime server
will use the conversion server to reformat the
file for display in the Slides section of the
meeting room.
See the Meeting Services section of the
Sametime Administrator's Guide (sthelpad.nsf or
sthelpad.pdf) for more information about
Sametime Conversion Services. If you specify
*NONE, you can manually configure a
conversion server at a later time.
50 Installing and Managing Sametime 7.5 for i5/OS
7. Press F10 for additional parameters, then complete the following fields.
Field
Description
Slide conversion port If you specified the name of a Slide conversion
server, specify the port on which the conversion
server should listen for connections from the
Sametime server.
Start Domino server
Specify whether or not you want to have this
Sametime server start when the set up is complete.
8. Press Enter to run the command.
As Sametime is added to the Domino server, you will see a console
screen that shows the status of adding Sametime to a Domino server.
When you are prompted that the addition of Sametime is complete,
press Enter.
9. If you did not choose to start the Domino server during set up, restart
the Domino server now.
Once the Domino server has started, proceed to the next section, "Validating
Sametime Instant Messaging."
Copying Lotus Sametime Connect to your Sametime server
This step is intended only for customers who are using the full version of
Sametime 7.5. If you are using the Instant Messaging Limited Use version of
Sametime, skip to "Validating Sametime Instant Messaging."
You must complete the followings steps to enable your users to download
and install Lotus Sametime Connect from the Sametime server.
1. Copy the entire contents of the sametimeclient directory from the Lotus
Sametime Connect Client CD to the
domino/html/sametime/sametimeclient subdirectory of the Sametime
server data directory. Replace the files that already exist in that directory.
For example, if your server data directory is called /STserver, copy the
entire contents of the sametimeclient directory from the CD to the
following directory on your system:
/STserver/domino/html/sametime/sametimeclient
2.
Change the owner of each of the copied objects to QNOTES.
Using i5/OS command:
• Run the following command from any i5/OS command line to change
the owner of all objects in the directory:
CHGOWN OBJ('<server data
directory>/domino/html/sametime/sametimeclient/*')
NEWOWN(QNOTES)
Chapter 5: Installing Sametime 51
Using iSeries Navigator:
• Open the system where you added Sametime. Click File Systems Integrated File System - Root and navigate to the
domino/html/sametime/sametimeclient subdirectory of your server
data directory. Complete these steps for each object in the directory
• Right-click on the object and select Permissions.
• Click Owner.
• In the Select new owner field, expand All Users.
• Click Qnotes and make sure the Remove all permission from current
owner box is checked.
• Click OK.
Validating Sametime Instant Messaging
If any of these tasks fail to work, see technote #1108423, "Sametime for
iSeries: Most Common Problems" at the following Web site:
http://www.ibm.com/support/docview.wss?rs=203&uid=swg21108423
For Instant Messaging Limited Use Version of Sametime:
For Instant Messaging Limited Use, your primary means of accessing
Sametime 7.5 is through your Lotus Notes 7.0.x client.
Several settings in your Location document are used to specify the
connection to your Sametime server:
•
Servers tab: IBM Lotus Sametime server (use the fully qualified host name)
•
Instant Messaging tab: Port and protocol (connection method)
When these settings are defined during Lotus Notes installation, the same
settings are written to all Location documents. You can also update
individual Location documents at any point during a Notes session.
For more information on the instant messaging settings, refer to the Notes
Help topic "Connecting to a Lotus Sametime server." For more information
about using the Notes client for Instant Messaging, see the Notes Help
section "Instant Messaging."
For Full Sametime:
Complete the following steps:
1.
Using a Web browser, open the Sametime Welcome page (stcenter.nsf)
on your Sametime server. For example, if the fully qualified host name of
your Sametime server is stserver.acme. com, open
http://stserver.acme.com/stcenter.nsf.
52 Installing and Managing Sametime 7.5 for i5/OS
Note Make sure you specify the server's fully qualified host name. If do
not use the fully qualified host name, you will be able to access the
Sametime Welcome Page, but you will not be able to log in.
2.
Click Download Lotus Sametime Connect 7.5 Client to display the
Lotus Sametime Connect download page.
The download page contains links for downloading two different
versions of Sametime Connect, one for each of the following client
operating systems:
• Microsoft® Windows®
• Linux
3. Click the download link for each version of Sametime Connect to verify
that the links are working correctly. If the links do not work, see
"Copying Lotus Sametime Connect to your Sametime server."
4. Click the Download Lotus Sametime Connect link for your client operating
system to download the client install package to your local drive.
5. Follow the instructions on the Sametime Connect download page to
install the Lotus Sametime Connect client and launch it.
Note The first time you launch Lotus Sametime Connect, you need to
enter the fully qualified host name of your Sametime server. Typically,
this is the name of the server from which you downloaded the files.
6. Use Sametime Connect to verify that instant messaging is working
correctly. View the Sametime Connect Help topics for more information
about using Sametime Connect.
Validating Sametime Web Conferencing
Note This topic applies only to servers with Web Conferencing capability.
The steps are unnecessary for servers that are only running the Instant
Messaging Limited Use version of Sametime.
You can verify Sametime Web Conferencing by accessing the "Welcome to
Sametime" page, creating a New Meeting, and testing the Multimedia Services.
If any of these tasks fail to work, see technote #1108423, "Sametime for
iSeries: Most Common Problems" at the following Web site:
http://www.ibm.com/support/docview.wss?rs=203&uid=swg21108423
Accessing the Welcome to Sametime page
To access the "Welcome to Sametime" page, follow these steps:
1. Start your Web browser.
2. Enter the following URL:
http://hostname/stcenter.nsf
Chapter 5: Installing Sametime 53
where hostname is the fully qualified host name of the Sametime server
you want to access.
Note Make sure you specify the server's fully qualified host name, such as
http://stserver.acme.com/stcenter.nsf. If do not use the fully qualified host
name, you will be able to access the Sametime Welcome Page, but you will
not be able to log in.
Testing your browser
To verify that your browser is set up correctly for running meetings, follow
these steps:
1.
From the Welcome to Sametime page, click Attend a Meeting.
2.
From the Meeting Center, click Test My Browser and follow the
instructions on the screen to verify your browser settings and correct any
problems.
Creating a New Meeting
To create a new meeting, follow these steps:
1. From the Welcome to Sametime page, click Schedule a Meeting.
2. From the New Meeting page, enter a meeting name.
3. Click Start Now.
4. Choose a duration for the meeting.
5. Click Save and wait for the meeting to start.
6. Once the meeting has started, the Meeting Details page is updated. Click
Attend Meeting.
Note If the Meeting Details page displays and the meeting does not begin,
click the Refresh button in your browser. The meeting starts in a separate
browser window.
(Upgrade only) Completing the upgrade process
After upgrading to Sametime 7.5, perform the following tasks as appropriate
for your environment to complete the upgrade process:
•
If you upgraded from a mixed environment that included both full
Sametime servers and Instant Messaging Limited Use servers on the
same system, your Instant Messaging Limited Use servers were changed
to full Sametime servers when you upgraded to Sametime 7.5. To change
these servers back to Instant Messaging Limited Use servers, see
"Changing an existing server to limited use or full Sametime."
54 Installing and Managing Sametime 7.5 for i5/OS
•
The original versions of several files are saved during the upgrade
process in case you need to examine them after the upgrade completes.
The original meetingserver.ini file is saved in the server data directory as
meetingserver.bak. The sametime.ini and stconfig.nsf files are saved in a
subdirectory of the server data directory. The name of the subdirectory
is ST31BU, ST651BU or ST70BU depending on which release of
Sametime was running prior to upgrade.
•
For servers with Web Conferencing capability: If you are currently using
Sametime Conversion Services, you must uninstall Sametime
Conversion Services from your conversion server and install the 7.5
version. For more information, see the Meeting Services section of the
Lotus Sametime 7.5 Administrator's Guide.
•
If your Sametime server uses an LDAP directory, you may need to use
the Sametime Administration Tool to modify your configuration for new
features in Sametime 7.5, such as Policy settings. Refer to the Lotus
Sametime 7.5 Administrator's Guide for additional information about new
features and configuration requirements.
•
If your users have stored privacy information ("who can see me") from
your earlier release of Sametime, then you need to migrate this
information by running a utility after upgrading to Sametime 7.5.
Privacy information from the earlier release will not be used unless it is
migrated. For more information, see technote 1242317 "Migrating privacy
data after upgrading to Sametime 7.5." This technote is available at
http://www.ibm.com/support/docview.wss?rs=203&uid=swg21242317
•
If you have Sametime servers located on different systems or LPARs that
reside in the same community with a Sametime 7.5 server, all of the
servers in the community should eventually be upgraded to Sametime
7.5, Sametime 7, or Sametime 6.5.1. (Interoperability with Sametime 3.1 is
supported only during the upgrade process.)
•
If you had integrated your previous release of Sametime with any of the
following products, you may need to perform additional steps to ensure
your environment continues to function properly.
• Notes and Domino
For more information, see the Lotus Domino 7 Administrator Help
database (HELP7_ADMIN.NSF).
• Domino Web Access
For more information, see the Lotus Domino 7 Administrator Help
database (HELP7_ADMIN.NSF).
• Lotus QuickPlace
Chapter 5: Installing Sametime 55
For more information, see "Setting up Lotus QuickPlace to work with
Lotus Sametime" in the Lotus QuickPlace 7 Installation and Upgrade
Guide.
•
The format of the Key Store used for SSL changed in Sametime 7.0. If
you are upgrading to Sametime 7.5 from a release prior to Sametime 7.0
and your Sametime server is configured for SSL, you will need to
perform some additional steps.
Sametime 6.5.1 and earlier releases used a .pfx file for the key store;
Sametime 7.0 and later releases use a .jks file. After upgrading to
Sametime 7.5, you must import your CA Trusted Root or Server
certficate into StKeys.jks. If you had changed the keystore name or
password, you must also update the sametime.ini file. For more details,
see the information about using SSL with Sametime in the Security
section of the Lotus Sametime Administrator's Guide.
56 Installing and Managing Sametime 7.5 for i5/OS
Chapter 6
Deploying the Sametime client software
Sametime users collaborate through a variety of client applications, which
interact with the services running on the Sametime server. This chapter
provides information on the different types of client applications available
and how to deploy them.
Note This chapter does not include instructions on setting up Sametime
users. For information on setting up Sametime users, see the IBM Lotus
Sametime Administrator's Guide.
.
Chapter 6: Deploying the Sametime client software 57
Summary of the types of Sametime clients
The following table contains information on the different types of Sametime
clients available, which version(s) of Sametime they are supported with, and
where to find additional documentation:
Client type
Available for
use with full
version of
Sametime
Notes client
Y
Domino Web
Access
Y
Available for
use with
Instant
Messaging
Limited Use
Y
Y
Notes
Must enable integration with
Sametime server.
For more information, see
the Lotus Domino 7
Administrator Help database
(HELP7_ADMIN.NSF).
Must enable integration with
Sametime server.
For more information, see
the Lotus Domino 7
Administrator Help database
(HELP7_ADMIN.NSF).
Sametime
Connect clients
Y
N
Separate versions
available for Windows
and Linux clients.
Can be downloaded from
Welcome Page of a full
Sametime server once
administrator has copied
them from the Sametime
Connect CD to the server.
See "Copying Lotus
Sametime Connect to
your Sametime server."
Meeting Room
Clients
Y
58 Installing and Managing Sametime 7.5 for i5/OS
N
Downloaded automatically
when attending meeting.
Chapter 7
Managing Sametime
You can manage a Sametime server in any of the following ways:
Using iSeries Navigator
This chapter explains how to manage your Sametime server using iSeries
Navigator. With iSeries Navigator, you can do the following:
•
Start a Sametime server.
•
End a Sametime server.
Using i5/OS commands
Managing your Sametime server using commands offers a few functions
that are not available using iSeries Navigator. With commands, you can do
the following:
•
Start a Sametime server
•
End a Sametime server
•
Start the Sametime components on a Domino server that is already running
•
End the Sametime components on a Domino server that is already running
•
Change an existing server to limited use or full Sametime
•
Change the IP address and host name settings of a Sametime server
•
Remove Sametime from a Domino server.
Using the Sametime Administration Tool
The Sametime Administration Tool can be accessed from the Server
Administration link on the Welcome to Sametime page after completing the
installation and setup procedures. It allows you to manage a wide variety of
activities related to your Sametime server, including the following:
•
Manage Community Services.
•
Manage Meeting Services.
•
Manage Server activity.
•
Manage users.
•
Control self-registration.
For more information about the Sametime Administration Tool, see the Lotus
Sametime Administrator's Guide (sthelpad.nsf).
Chapter 7: Managing Sametime 59
Starting a Sametime server
The steps for starting a Sametime server are the same as those for starting a
Domino server. You can start a Sametime server using iSeries Navigator or
i5/OS commands.
Starting a Sametime server using iSeries Navigator
To start a Sametime server using iSeries Navigator, follow these steps:
1. Open iSeries Navigator.
2. Start the Sametime server.
• Open the system where you added Sametime.
• Click Network.
• Click Servers.
• Click Domino.
• Right-click the Domino server where you added Sametime and
select Start.
3. Periodically press F5 to refresh and wait for the server status to be Started.
Note Starting the Sametime server may take a few minutes.
To confirm that all Sametime components have started, follow these steps:
4. Open iSeries Navigator.
5. Open the system where you added Sametime.
6. Click Work Management.
7. Click Server Jobs, and look for the STMSACTPRV status to be Running.
Starting a Sametime server using commands
1. To start a Sametime server using commands, follow these steps:
2. On any i5/OS command line, type the following command and
press Enter:
WRKDOMSVR
3. On the Work with Domino Servers display, start the server by typing 1
in the Opt column next to the Domino server where you added
Sametime and press Enter.
4. Press Enter to confirm your server selection.
5. Periodically press F5 to refresh your screen and wait for the Domino
server status to be *STARTED.
To confirm that all Sametime components have started, type 5 in the Opt
column next to the server and press Enter to display the Domino console.
60 Installing and Managing Sametime 7.5 for i5/OS
On the Display Domino Console display, look for the message "Sametime:
Server startup successful" which indicates that all Sametime components
have started. You may need to press F5 periodically to refresh the screen
until this message is displayed.
Ending a Sametime server
The steps for ending a Sametime server are the same as those for ending a
Domino server. You can end a Sametime server using iSeries Navigator or
i5/OS commands.
Ending a Sametime server using iSeries Navigator
To end a Sametime server using iSeries Navigator, follow these steps:
1. Open iSeries Navigator.
2. End the Sametime server.
• Open the system where you will end Sametime.
• Click Network.
• Click Servers.
• Click Domino.
• Right-click the Domino server where you added Sametime and
select Stop.
3. Periodically press F5 to refresh and wait for the server status to be Stopped.
Note Stopping the Sametime server may take a few minutes.
Ending a Sametime server using commands
To end a Sametime server using commands, follow these steps:
1. On any i5/OS command line, type the following command and
press Enter:
WRKDOMSVR
2. On the Work with Domino Servers display, end the server by typing 6 in
the Opt column next to the Domino server where you added Sametime
and press Enter.
3. Press Enter to confirm your server selection.
4. Periodically press F5 to refresh your screen and wait for the Domino
server status to be *ENDED.
Chapter 7: Managing Sametime 61
Starting the Sametime components on a Domino server that is already running
By default, the Sametime components automatically start whenever a
Domino server is started. However, if a Domino server is already running,
and you want to start the Sametime components, then follow these steps:
1. On any i5/OS command line, enter the Work with Domino Console
command and press F4:
WRKDOMCSL
2. Enter the server name and press Enter.
3. On the console command prompt, type the following and press Enter:
load STADDIN2
4. Periodically press F5 to refresh your screen and look for a message that
Sametime has started and is running.
Ending the Sametime components on a Domino server that is already running
If you want to stop the Sametime components but leave the Domino server
running, follow these steps:
Note You cannot stop individual Sametime components on i5/OS.
1. On any i5/OS command line, enter the Work with Domino Console
command and press F4:
WRKDOMCSL
2. Enter the server name and press Enter.
3. On the console command prompt, type the following and press Enter:
tell STADDIN2 quit
4. Periodically press F5 to refresh your screen and look for a message that
says Sametime has ended.
Changing an existing server to limited use or full Sametime
Each Sametime server is either a full Sametime server, or a limited use server
providing only the capability included with Lotus Sametime, Instant
Messaging Limited Use. Lotus Sametime for i5/OS allows you to change an
existing server from Sametime to Instant Messaging Limited Use, and
vice-versa, using the CHGLSTDOM command.
62 Installing and Managing Sametime 7.5 for i5/OS
Note In order to change a server from Instant Messaging Limited Use to
full Sametime, the full version of Sametime (product options *BASE and 1)
must be installed on your system.
To change a server from full Sametime to Instant Messaging Limited Use, or
vice-versa, follow these steps:
1. End the Sametime server.
2. On any i5/OS command line, type the following and press F4:
CHGLSTDOM
3. On the Change Sametime on Domino display, set Web Conferencing to
*YES to change the server into a full Sametime server, or *NO to change
it into an Instant Messaging Limited Use server.
4. Press Enter to run the command.
5. Start the Sametime server.
Changing the IP address
Your Sametime server should be set up so that it uses host names and does
not refer directly to IP addresses. This allows you to change the IP address
for your Sametime server by simply updating the host table and DNS.
To change the IP address for your Sametime server, follow these steps:
1. Update your host table so that the new IP address is associated with the
appropriate host name. Make sure that the fully qualified host name is
listed first among the entries for your Sametime server, before any short
names. For more information, see "Updating the host table" in Chapter 2
or "Updating the host table using commands" in Appendix B.
2. Likewise, update your DNS entries so that the new IP address is
associated with the appropriate host name. Check whether your server is
configured to search the Domain Name Server (DNS) before the host
table. If it is, you must also make sure that the fully qualified host name
of your Sametime server is listed first in the DNS. To check the
configured search order, see "Updating the Domain Name Server" in
Chapter 2 or "Updating the Domain Name Server" in Appendix B.
3. Stop and restart the Sametime server for the changes to take effect.
For detailed information about verifying and changing these values, see
Chapter 2 "Preparing the TCP/IP Environment."
Chapter 7: Managing Sametime 63
Changing the host name
The i5/OS command CHGLSTDOM simplifies the process for changing the
host name setting of a Sametime server. The procedure described in this
section can also be used to correct problems with the configuration of your
Sametime server. For example, if your TCP/IP host table did not correctly
list the fully qualified host name first at the time that you setup your
Sametime server, many elements of your Sametime server configuration may
be incorrect. You can correct this type of server configuration problem by
following this procedure to change the host name.
To change the host name, follow these steps:
1. Update your host table so that the new host name is associated with the
appropriate IP address. Make sure that the fully qualified host name is
listed first among the entries for your Sametime server, before any short
names. For more information, see "Updating the host table" in Chapter 2
or "Updating the host table using commands" in Appendix B.
2. Likewise, update your DNS entries so that the new host name is
associated with the appropriate IP address. Check whether your server is
configured to search the Domain Name Server (DNS) before the host
table. If it is, you must also make sure that the fully qualified host name
of your Sametime server is listed first in the DNS. To check the
configured search order, see "Updating the Domain Name Server" in
Chapter 2 or "Updating the Domain Name Server" in Appendix B.
3. End the Sametime server.
4. Update the host name for the Domino server using the CHGDOMSVR
command. For detailed information on changing the configuration of a
Domino server, refer to "Updating the configuration of existing Domino
servers using commands " in Appendix B.
5. On any i5/OS command line, type the following and press F4:
CHGLSTDOM
6. On the Change Sametime on Domino display, specify the following:
•
The name of the Sametime server where you want to make this change
(for example, stdom1).
•
The new fully qualified host name for the Sametime server (for example,
stdom1.acme.com).
Press Enter to run the command. The CHGLSTDOM command does
the following:
• Updates the Ports - Notes Network Ports - Net Address field in the
Server document.
64 Installing and Managing Sametime 7.5 for i5/OS
• Adds the host name to the Internet Protocols - HTTP - Host name
field in the Server document.
• Updates Sametime files that reference the host name.
7. Start the Sametime server.
8. Open the Domino directory (names.nsf) on your Sametime server and
edit the Server document. Look at the Internet Protocols - HTTP tab in
the Server document and locate the Basics - Host name(s) field.
9. The Basics - Host name(s) field may contain more than one name. If any
of the names are incorrect or not needed, delete them. Make sure that the
correct fully qualified host name is listed first in the field.
10. Save and close the Server document.
11. If you are using HTTP Tunneling with multiple IP addresses, then
additional configuration updates are required. See "Updating the host
names when using HTTP Tunneling with multiple IP addresses."
12. Stop and restart the Sametime server for the changes to take effect.
Updating the host names when using HTTP Tunneling with multiple IP
addresses
If you are using HTTP Tunneling with multiple IP addresses, then you must
update your configuration manually after using the CHGLSTDOM
command. If you are not using HTTP Tunneling with multiple IP addresses
then you can skip this step.
The CHGLSTDOM command placed the new host name to the tunneling
host name fields, but did not preserve the required prefixes, such as
community-, meeting- and broadcast-, in the Sametime configuration. Use
the Sametime Administration tool to update the host names in the following
fields in the "Connectivity" section:
•
Community Services Network settings -> Address for client
connections-Host name should have prefix of community-
•
Community Services Network settings -> Address for HTTP tunneled
client connections-Host name should have prefix of community-
•
Meeting Services Network settings -> Address for HTTP tunneled
client connections-Host name should have prefix of meeting-
•
Broadcast Services Network settings -> Broadcast Gateway address for
HTTP tunneled client should have prefix of broadcast-
Chapter 7: Managing Sametime 65
Removing Sametime from a Domino Server
When you remove Sametime from a Domino server, all files related to
Sametime that were added to the Domino server data directory or were
created while running Sametime components are removed. Updates that
were made to the Domino Directory, including person documents, server
documents and changes to the ACL are not removed. To remove Sametime
from a Domino server, follow these steps:
1. End the Domino server where you plan to remove Sametime.
2. On any i5/OS command line, type the following command and press F4:
RMVLSTDOM
3. Enter the name of the Domino server where you want to remove
Sametime and press Enter.
4. When prompted, type a "g" to complete the Remove Sametime from a
Domino server command.
A message will appear indicating that Sametime has been removed.
5. Using the Domino Administrator Application, modify the Domino
server document by changing the "Is this a Sametime server?" field to No.
6. Delete any Sametime Connection documents between this Sametime
server and other Sametime servers.
The server is once again a Domino server.
66 Installing and Managing Sametime 7.5 for i5/OS
Chapter 8
Optional Configurations for Sametime
This chapter provides information about Sametime components that are not
required for using Sametime. The following sections explain optional
configurations that you may want to implement in your collaborative
environment. The topics covered in this chapter include the following:
•
Using Sametime Conversion Services for meeting attachments
•
Enabling the capability to save whiteboard contents
•
Using the limited use version of Sametime in an environment that
includes full Sametime servers
•
Installing Sametime toolkits
•
Using a Community Services multiplexer
Using Sametime Conversion Services for meeting attachments
Lotus Sametime Conversion Services expands the capability of your
Sametime server to display meeting attachments in the Slides section of your
meetings and improves convenience for your users.
In order to have meeting attachments automatically converted for display in
the Slides section of a Sametime meeting, you must install and configure an
optional component of Sametime called Sametime Conversion Services. If
you choose not to install Sametime Conversion Services, users must use the
Sametime Print Capture Utility to process each meeting attachment for
display in the meeting. For more information on the Sametime Print Capture
Utility, see the Lotus Sametime Administrator's Guide (sthelpad.nsf).
With Sametime Conversion Services, it is not necessary to prepare most
meeting attachments with the Print Capture Utility. Setting it up is
straightforward for the administrator. Your system administrator installs
Sametime Conversion Services on a Windows system (referred to as the
Conversion server). In addition, the administrator provides the Sametime
server with the information necessary to communicate with the
Conversion server.
Chapter 8: Optional Configurations for Sametime 67
Once the administrator completes the setup for Sametime Conversion
Services, using it is transparent to end users. When a document is attached to
a meeting, the Sametime server automatically sends the document to the
Conversion server. The conversion server converts the attachment to the
appropriate format and sends it back to the Sametime server, where it is
attached to the meeting. The attachment is then displayed in the Slides
section of the meeting.
For Sametime 7.5, you can specify connection information for the Conversion
server when you add Sametime to a Domino server (see "Adding Sametime
to a Domino server"). Alternatively, you can configure the connection at a
later time. Detailed information about setting up Lotus Sametime 7.5
Conversion Services is available in the Meeting Services section of the Lotus
Sametime 7.5 Administrator's Guide.
Enabling the capability to save whiteboard contents
The ability to save the contents of the whiteboard allows users to keep
changes that are made to a file displayed during a meeting. The following
product option must be installed on your System i server in order to save the
whiteboard contents:
OS/400 - Portable Application Solutions Environment (PASE), 5722SS1
option 33
If PASE is installed at the time you configure a new Sametime 7.5 server or
upgrade an existing Sametime server to 7.5, then the capability to save the
whiteboard contents is enabled by default. You do not need to make any
additional changes.
If PASE was not installed at the time you configured or upgraded your
Sametime server and you now want to allow your users to save the
whiteboard contents, complete the following steps:
1. Install OS/400 - Portable Application Solutions Environment (PASE),
5722SS1 option 33. See the product documentation for details.
2. Locate the meetingserver.ini file in your Sametime server's data
directory and open it for editing. Use iSeries Navigator or the EDTF
command to open and edit the file.
3. Search for the following setting in the meetingserver.ini file:
-Djava.awt.headless
This setting is located in the
[SOFTWARE\Lotus\Sametime\MeetingServer\Services\MaterialMana
ger] section of the file, in the ArgString keyword value.
68 Installing and Managing Sametime 7.5 for i5/OS
4. If PASE was not installed at the time you configured or upgraded your
Sametime server, this setting is false. Change the setting as shown:
-Djava.awt.headless=true
Caution Do not change this setting to true unless you have installed
PASE. If you change the setting and PASE is not installed, you may
encounter server crashes.
5. Save the file and restart the Sametime server in order for the change to
take effect.
6. If the option to save the contents of the whiteboard does not appear to
be available to meeting room moderators, you must update your server
configuration. From the Sametime server home page, click Administer
the Server. Then click Configuration -> Meeting Services -> General.
Select Allow people to save whiteboard annotations as attachments
to the meeting. Click Update and restart the server for the change to
take effect.
Note If the option to save the contents of the whiteboard appears to be
available to meeting room moderators, but the save operation never
completes, you most likely have PASE installed but have not set
-Djava.awt.headless to true.
Using the limited use version of Sametime in an environment that
includes full Sametime servers
You can deploy the Instant Messaging Limited Use version of the Sametime
server into an environment that includes full Sametime servers, allowing all
of your users to communicate with each other through instant messaging.
However, in this environment, you must take steps to ensure that only users
who are licensed to use the full Sametime servers can create or attend
meetings on those Sametime servers. Also, only full Sametime server users
can use the Sametime Connect for the desktop client available with the full
Sametime server.
Note To deploy Instant Messaging Limited Use servers and full Sametime
servers on the same logical partition (LPAR), you must have *BASE and
Option 1 of the product installed. Because Option 1 is installed, each new
server you create is by default a full Sametime server. To change it to an
Instant Messaging Limited Use server, see "Changing an existing server to
limited use or full Sametime " in Chapter 7.
Chapter 8: Optional Configurations for Sametime 69
To ensure that users of the Instant Messaging Limited Use version of
Sametime do not use features of the full Sametime servers for which they are
not licensed, you must perform the following procedures:
1. Assign users to an appropriate home Sametime server
2. Prevent instant messaging only users from creating or attending
meetings
For detailed information about these procedures, see the Lotus Sametime
Administrator's Guide, Instant Messaging Limited Use Version. The Lotus
Sametime Administrator's Guide, Instant Messaging Limited Use Version also
discusses end user issues that occur in an environment that includes both the
Instant Messaging Limited Use version of the Sametime server and the full
version of the Sametime server.
Installing Sametime toolkits
Sametime toolkits allow you to add Sametime capabilities to other
applications. The toolkits and the toolkit documentation can be downloaded
from the Lotus developerWorks product page for Lotus Sametime. You can
access the Sametime product page from the following Web page:
http://ibm.com/developerworks/lotus/products
Using a Community Services multiplexer
Deploying a Community Services multiplexer can improve the performance
of your Sametime server. The multiplexer component maintains connections
from Sametime clients to the Community Services on a Sametime server.
You can install and configure the community services multiplexer on one or
more Windows servers in order to reduce the client connection load on your
Sametime server.
For more information, see "Deploying separate Community Services
multiplexers" in the Lotus Sametime Administrator's Guide (sthelpad.nsf). This
is located in the section "Setting up a Community Services cluster without clustering
the Meeting Services."
When directed to install the Community Services multiplexer, run the file
Setup.exe located in the CommunityMux directory on the Lotus Sametime
Components CD.
70 Installing and Managing Sametime 7.5 for i5/OS
The minimum system requirements for the Community Services multiplexer
machine are the same as the system requirements for running the Sametime
product on a Windows server. For more information, see the Lotus Sametime
Installation Guide for Windows which is available at the Lotus Developer
Domain Documentation Library at the following Web address:
http://www.ibm.com/lotus/ldd/doc
Chapter 8: Optional Configurations for Sametime 71
72 Installing and Managing Sametime 7.5 for i5/OS
Appendix A
Sametime Installation and Configuration Checklists
This appendix contains checklists to help you complete the installation and
configuration of IBM Lotus Sametime or IBM Lotus Sametime, Instant
Messaging Limited Use. Use the checklist appropriate for your deployment:
•
New installation checklist
•
Upgrade checklist
Appendix A: Sametime Installation and Configuration Checklists 73
New installation checklist
Use the following checklist to help you with a new installation of Lotus
Sametime or Lotus Sametime, Instant Messaging Limited Use.
Task
Review the Readme file on the Sametime 7.5 for i5/OS
CD-ROM and the Sametime 7.5 Release Notes on the
Sametime Components CD for any information not available
at the time this document was published. Any additional
updates will be posted as they become available on the
Sametime for i5/OS Web site at the following address:
http://www.ibm.com/eserver/iseries/sametime
Verify that your server meets the minimum hardware and
software requirements for Sametime.
For more information, see the section, "Lotus Sametime
requirements" in Chapter 1. Note that i5/OS V5R3 or V5R4 is
required for Domino 7 and Sametime 7.5. If you are currently
using OS/400 V5R1 or V5R2, you must upgrade to i5/OS
V5R3 or V5R4 before installing Sametime 7.5.
Prepare the TCP/IP environment.
For more information, see Chapter 2 "Preparing the TCP/IP
Environment."
Prepare the Sametime environment by configuring a Domino
server where you will add Sametime.
See Chapter 3 "Preparing a new Sametime environment."
Install Sametime on your system.
For more information, see Chapter 5 "Installing Sametime."
Add Sametime to the Domino server.
See "Adding Sametime to a Domino Server" in Chapter 5.
Deploy the Sametime client software and add users to the
Sametime server.
If you are using the full version of Sametime, you must copy
Sametime Connect to your server so that users can download
the new version. See "Copying Lotus Sametime Connect to
your Sametime server."
For information on deploying the Sametime client software,
see Chapter 6 "Deploying the Sametime client software."
For information on adding users, see the Lotus Sametime
Administrator's Guide (sthelpad.nsf).
Once your Sametime server is up and running, you may want
to take advantage of the optional configurations detailed in
Chapter 8 "Optional Configurations for Sametime."
74 Installing and Managing Sametime 7.5 for i5/OS
Complete
Upgrade checklist
Use the following checklist to help you upgrade an existing Lotus Sametime
environment to either the full version of Sametime or the Instant Messaging
Limited Use version of Sametime.
Task
Complete
Review the Readme file on the Sametime 7.5 for i5/OS CD-ROM and
the Sametime 7.5 Release Notes on the Sametime Components CD for
any information not available at the time this document was
published. Any additional updates will be posted as they become
available on the Sametime for i5/OS Web site at the following
address:
http://www.ibm.com/eserver/iseries/sametime
Verify that your server meets the minimum hardware and software
requirements for Sametime.
See the section "Lotus Sametime requirements" in Chapter 1.
Note that i5/OS V5R3 or V5R4 is required for Domino 7 and
Sametime 7.5. If you are currently using OS/400 V5R1 or V5R2, you
must upgrade to i5/OS V5R3 or V5R4 before installing Sametime 7.5.
Make sure that all of your Sametime servers are ready to be upgraded.
See Chapter 4 "Preparing to upgrade an existing Sametime
environment."
Install Sametime 7.5 on your system. Your existing Sametime servers
will be upgraded automatically during the installation process.
For more information, see Chapter 5 "Installing Sametime."
Review the client software information for Sametime 7.5 to make sure
existing users can continue to access Sametime.
If you are using the full version of Sametime, you must copy
Sametime Connect to your server so that users can download the new
version. See "Copying Lotus Sametime Connect to your Sametime
server."
See Chapter 6 "Deploying the Sametime client software."
If you have been using Sametime Conversion Services to convert
meeting attachments for display in meetings, you must upgrade it.
See "Preparing to upgrade your servers."
Once your Sametime server is up and running, you may want to take
advantage of the optional configurations detailed in Chapter 8
"Optional configurations for Sametime." Also if you are currently
using certain optional configurations of Sametime, you may need to
upgrade them.
Appendix A: Sametime Installation and Configuration Checklists 75
76 Installing and Managing Sametime 7.5 for i5/OS
Appendix B
Preparing the TCP/IP Environment Using Commands
Your Sametime server must be configured to use one or more specific
TCP/IP addresses so that it will not attempt to share TCP/IP ports with any
other HTTP servers on your system. This appendix guides you through the
process of verifying your TCP/IP configuration, making changes if necessary
to resolve conflicts between servers, and gathering the TCP/IP information
that you will need to configure your Sametime server.
Preparing your TCP/IP environment for Sametime involves the following tasks:
•
Verify host table entries.
•
Verify configuration of existing Domino servers.
•
Select a TCP/IP address for your Sametime server.
•
Add a TCP/IP address if necessary.
•
Update your host table.
•
Update the configuration of existing Domino servers.
•
Update the IBM HTTP server configuration.
Verifying host table entries using commands
To determine the list of host table entries that are already defined on your
server, follow these steps:
To verify your host table entries, follow these steps:
1. From any i5/OS command line, type the following command and
press Enter:
CFGTCP
2. On the Configure TCP/IP display, select option 10 to work with TCP/IP
Host Table entries.
3. Record each host name and the corresponding TCP/IP address as you
may need this information later.
Appendix B: Preparing the TCP/IP Environment Using Commands 77
Verifying configuration of existing Domino servers using commands
Note If you do not have any Domino servers configured on your system,
you can skip this section.
To determine which TCP/IP addresses are currently being used by your
Domino servers, follow these steps:
1. From an i5/OS command interface, sign on to your server.
Note The following steps assume that your Domino servers are already
started.
2. Verify the current TCP/IP addresses for each Domino server by entering
the following command:
WRKDOMCSL servername
where servername is the name of your Domino server.
3. From the Domino Console display, type the following command and
press Enter:
sh port tcpip
4. Press F5 to refresh the screen.
The show port TCP/IP command displays the TCP/IP address that the
Domino server is using.
• If the server is using only one TCP/IP address, you will see a specific
TCP/IP Local Address listed using port 1352. For example,
10.1.2.3:1352.
• If the server is using all active TCP/IP addresses, you will see *:1352
displayed as the Local Address rather than a particular TCP/IP address.
5. Record the results for each Domino server, as you will use this
information later.
78 Installing and Managing Sametime 7.5 for i5/OS
Selecting a TCP/IP address for your Sametime server using commands
In this section you will determine which TCP/IP addresses are already
defined on your system and decide which address you will use for your
Sametime server. You will also determine whether you will need to define
additional TCP/IP addresses in order to avoid conflicts between servers.
1. Determine which TCP/IP addresses are currently defined for your system:
• From any i5/OS command line, type the following command and
press Enter:
CFGTCP
• On the Configure TCP/IP display, select option 1 to Work with
TCP/IP interfaces and display a list of the currently defined
TCP/IP interfaces.
2. Verify that each of the TCP/IP addresses you recorded when you looked
at the Host Table or ran the 'sh port tcpip' command is currently defined.
3. Verify that the system has enough TCP/IP addresses defined so that you
can assign at least one for the exclusive use of each of the following:
• Your Sametime server
• Each existing Domino server
• Each instance of the IBM HTTP server running on your system
4. Contact your network administrator to assign additional TCP/IP
addresses and host names if needed.
5. Ensure that the new host names are also added to your Domain Name
Server (DNS).
6. Select the TCP/IP address you will assign to your Sametime server.
7. Decide which TCP/IP addresses should be assigned to each existing
Domino server and each instance of the IBM HTTP server.
Record this information, as you will use it later to ensure that existing
servers are properly bound to specific IP addresses so that their port
usage does not conflict with your Sametime server.
If you needed to have additional TCP/IP addresses defined, continue to
"Adding a TCP/IP address using commands."
If you did not need to have additional TCP/IP addresses defined, skip to
"Updating the host table."
Appendix B: Preparing the TCP/IP Environment Using Commands 79
Adding a TCP/IP address using commands
If you did not need to assign additional TCP/IP addresses, you can skip
this section.
To add a TCP/IP address to your server, follow these steps:
1. From any i5/OS command line, type the following command and
press Enter:
CFGTCP
2. Select option 1 to work with TCP/IP interfaces.
3. On the Work with TCP/IP Interfaces display, type a 1 in the Opt column
and press Enter to add a TCP/IP interface.
4. On the Add TCP/IP Interface display, enter the following information:
Field
Description
Internet Address
Specify the TCP/IP address you
want to add. For example, enter
10.1.2.4.
Line Description
Specify the name of the line
description for your LAN
adapter. For example, enter
TRNLINE.
Subnet Mask
Specify the subnet mask that is
appropriate for your interface.
For example, enter
255.255.255.0.
5. Press Enter to add the new interface and return to the Work with
TCP/IP Interfaces display.
6. To start an interface, type a 9 beside it and press Enter.
Updating the host table using commands
In this section, you will add an entry in the host table for your Sametime
server. If necessary, you will also update the entries for your existing
Domino servers.
To add a host table entry for your Sametime server, follow these steps:
1. From any i5/OS command line, type the following command and
press Enter:
CFGTCP
80 Installing and Managing Sametime 7.5 for i5/OS
2. Type 10 and press Enter to work with TCP/IP host table entries.
3. If one of the TCP/IP addresses that you selected is not listed in the Host
Table, follow these steps to add a new entry:
• Type a 1 in the Opt column next to the blank Internet Address and
press Enter to add a Host Table Entry.
• When the Add TCP/IP Host Table Entry display appears, enter the
following information:
Field
Description
Internet Address
Enter the TCP/IP address that you assigned to
the Domino server. For example, enter 10.1.2.4.
Host name
Enter the fully qualified name of the Domino
server as the host name. For example, enter
stdom1.acme.com.
Note Although you can add multiple host names for the same IP
address, make sure you list the fully qualified name for your Domino
server first, before any alternative short names.
• Press Enter to create the Host Table Entry.
4. Follow these steps to update an existing Host Table Entry:
Note If the TCP/IP address you want to use is listed in the table, but
the corresponding Domino server is not listed as one of the possible host
names for that address, you must update the existing host table entry to
include the additional host name.
• Type a 2 in the Opt column next to the Internet Address and press
Enter to change the Host Table Entry.
• When the Change TCP/IP Host Table Entry display appears, you may
need to Page Down to view the currently defined list of host names.
• When you have displayed the last host name, enter a '+' in the '+ for
more values' prompt and press Enter.
• When the Specify More Values for Parameter HOSTNAME display
appears, replace an existing host name or one of the *SAME entries
with the fully qualified name of your Domino server. For example,
stdom1.acme.com.
Note The fully qualified name of your Domino server must be listed
first in this table.
• Press Enter to update the host name. Press Enter again to change the
Host Table Entry.
Note You can remove a host name for an Internet Address by following
the above steps to update the Host Table Entry and replacing the host
name with *BLANK.
Appendix B: Preparing the TCP/IP Environment Using Commands 81
Ensure that the host table entries for any existing Domino servers are
correctly defined and they are associated with the TCP/IP addresses you
decided they should use in "Selecting a TCP/IP address for your Sametime
server."
Updating the Domain Name Server
If you defined any additional host names, work with your TCP/IP
administrator to ensure that the new host names are added to your Domain
Name Server (DNS).
If you have configured TCP/IP to search the DNS before searching the host
table, you may need to make additional changes in your configuration.
Follow these steps to check your TCP/IP Configuration Properties:
1. From any i5/OS command line, type the following command and
press Enter:
CFGTCP
2. On the Configure TCP/IP display, type 12 and press Enter to change the
TCP/IP domain information.
3. On the Change TCP/IP Domain (CHGTCPDMN) display, look for the
"Host name search priority" setting.
82 Installing and Managing Sametime 7.5 for i5/OS
If the value is *REMOTE, either change this value to *LOCAL or verify
with your network administrator that the fully qualified host name is the
first value listed in the DNS for the IP address associated with your
Sametime server. The fully qualified host name must be listed before any
short names in order for your Sametime server to function correctly.
If the value of this field is *LOCAL, you do not need to take any further
action. You already ensured that the fully qualified host name was listed
first in your local host table in an earlier step.
Caution If you change the "Search order" you must stop and restart
TCP/IP in order for the change to take effect.
4. Press F3 to exit.
Updating the configuration of existing Domino servers using commands
Note If you do not have any Domino servers configured on your system,
skip this section and proceed to "Updating the IBM HTTP server
configuration using commands."
In this section, you will ensure your existing Domino servers are correctly
bound to the specific fully qualified host names that you have assigned to
them. This will prevent them from conflicting with your Sametime server. If
necessary, you will modify the existing Domino server settings to enable
partitioning and specify a unique fully qualified host name.
Even if you changed your server's fully qualified host name by modifying
the server's notes.ini file, the change may not have occurred in the server
document. This procedure updates both the server document and the
notes.ini file.
1. Using a profile with the authorities listed in Chapter 1, end the Domino
server, if it is active, by typing the following command and pressing Enter:
ENDDOMSVR DOM1
where DOM1 is the name of the Domino server.
Note Ending the Domino server may take a few minutes.
2. Change the Domino server settings by typing the following command
and pressing F4:
CHGDOMSVR DOM1
where DOM1 is the name of the Domino server.
3. In the Advanced services field, you should see *PARTITION or *ALL. If
neither value is specified, then specify *PARTITION.
Appendix B: Preparing the TCP/IP Environment Using Commands 83
4. In the Internet Address Field, enter the fully qualified host name for this
Domino server.
5. Press Enter.
If the changes to the server settings were successful, the following
message is displayed:
Command CHGDOMSVR ended successfully.
6. Restart the Domino server by entering the following commands and
pressing Enter:
STRDOMSVR DOM1
Where DOM1 is the name of the Domino server.
Note Starting the Domino server may take a few minutes.
7. Using a Domino Administrator Client, edit the server settings in the
Server Document so that the Domino HTTP server binds to the specific
host name.
• Select the Configuration tab.
• In the left pane, click Server and select All Server Documents.
• Open the server document for the Domino server and click the Edit
Server button.
• Select the Internet Protocols tab, and then select the HTTP tab.
• In the Host name(s) field, verify the DNS name for the TCP/IP
address that you specified in the Change Domino Server command.
• In the Bind to host name field, select Enabled.
• Select the Ports tab, then select the Internet Ports tab, then select the
Web tab.
• Verify in the HTTP settings that the TCP/IP port has a port number
specified. The default port number is 80.
• Click Save and Close.
8. Stop and restart the Domino server.
9. When the Domino server has restarted, access it through a Notes client
or a Web browser to make sure it is still accessible using TCP/IP.
84 Installing and Managing Sametime 7.5 for i5/OS
Updating the IBM HTTP server configuration using commands
Note If you are not using the IBM HTTP server (either the original version
or the version powered by Apache), skip this section and proceed to Chapter
3 "Preparing a new Sametime environment."
If you are using the IBM HTTP server, then you must verify that each
instance of the server is bound to a specific TCP/IP address. This will
prevent it from conflicting with your Sametime server.
To change the IBM HTTP server settings, follow these steps:
1. If the IBM HTTP server is currently running, type the following
command on any i5/OS command line and press Enter to end it:
ENDTCPSVR SERVER(*HTTP)
2. Start the HTTP Administration server by typing the following command
and pressing Enter:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
3. Open the IBM HTTP server configuration page.
• Start your Web browser.
• Enter the following URL:
http://mysystem:2001
where mysystem is the name of your server.
• Click IBM HTTP Server for AS/400.
• Click Configuration and Administration.
• Select the Configuration tab.
4. Select a configuration from the pull-down menu in the left pane.
Note Complete the following steps for each configured instance of the
IBM HTTP server:
If the Server type field indicates Original, follow these steps:
• From the list on the left pane, select Basic settings.
• In the right pane, enter the IP Address or hostname for this server in
the Host name field.
• Select the option Bind server to host IP address.
• Click Apply.
Appendix B: Preparing the TCP/IP Environment Using Commands 85
If the Server type field indicates Apache, follow these steps:
• From the list on the left pane, select global settings.
• Click General Settings under the Web Site Definition heading.
• Find the IP address and port table in the section called Server IP
address and port to listen on.
• If All is listed as the IP address, select that row.
• Edit this field to replace All with the IP Address for this server.
• Click OK.
5. When each instance of the IBM HTTP server is configured to use a
specific IP address, restart the HTTP servers by typing the following
command and pressing Enter:
STRTCPSVR SERVER(*HTTP)
For further information on managing the IBM HTTP server, see the iSeries
Information Center at the following Web address:
http://www.ibm.com/eserver/iseries/infocenter
You have finished preparing the TCP/IP environment, and can proceed to
Chapter 3 "Preparing a new Sametime Environment."
86 Installing and Managing Sametime 7.5 for i5/OS
Appendix C
Setting up a Domino server using commands
When setting up an additional Domino server on your system, you can:
•
Set up a Domino server in a new Domino domain.
•
Add a Domino server to an existing Domino domain.
Note If you plan to use replication functions in your Sametime
environment, do not replicate the Sametime Configuration Database
(stconfig.nsf) from one server to another.
For more information about the implications of each of these options, see
"Sametime configuration options" in Chapter 3.
Setting up a Domino server in a new Domino domain using commands
The steps to create a new server in a new Domino domain are similar to the
steps that you followed when you set up your first Domino server. However,
there are two differences:
•
When you set up this server, you must specify the host name that you
have chosen for the Sametime server in the Internet Address field. Do
not accept the default value of SYSTEM or leave the Internet Address
field blank.
•
After you configure the server, you must edit the Server Document for
the Domino server to verify several fields before you add Sametime to
the Domino server.
1. Configure the Domino server by typing the following command and
pressing F4:
CFGDOMSVR
Appendix C: Setting up a Domino server using commands 87
2. Configure the Domino server with the following settings:
Note This chapter only documents settings that directly apply to this
Sametime installation. For settings that are not documented below, you
can enter your own values.
Field
Server Name
Option
Data Directory
Description
Enter the name of the Domino server where you
will add Sametime. For example, enter
STDOM1/ACME1.
Specify *FIRST.
Enter the path for the Domino server's data
directory. For example, enter
/LOTUS/DOMINO/stdom1.
Organization Name
Enter the name of the Domino domain. For
example, enter AcmeSametime.
Administrator's Name
Specify the Domino administrator's name. This
administrator will also be the Sametime server
administrator.
Internet Password
Specify an Internet password for the Domino
Administrator. You must specify an Internet
password in order to access the Sametime
components of this server.
Web Browsers
Specify *HTTP.
Sametime requires that you use the Domino
HTTP server.
Internet Mail packages
To reduce overhead, specify *NONE. Sametime
does not require mail packages.
Directory Services
To reduce overhead, specify *NONE. Sametime
does not require Directory services.
Advanced services
Enter *PARTITION, since multiple Domino
servers are running on the same system.
Internet Address
Enter the fully qualified host name for the
Sametime server.
Bind HTTP
Specify *YES.
3. After you have entered the settings, press Enter and wait for the server
configuration to complete.
4. Start the Domino server.
88 Installing and Managing Sametime 7.5 for i5/OS
5. Using a Domino Administrator client, open the server document and
verify the content of the following fields. Update the fields if necessary:
Tab
Security
Ports-Notes Network
Ports
Field
Programmability
Restrictions: Run
unrestricted
methods and
operations
Port
Ports-Notes Network
Ports
Net Address
Internet Protocols-HTTP
Maping: Home
URL
Internet Protocols-HTTP
Basics: Host
Name(s)
Internet Protocols HTTP
Basics: Bind to
host name
Setting
If you have signed
agents with a different
signature, then enter
that signature here
too.
TCPIP
Note This must be
specified exactly as
shown or you will not
be able to add
Sametime to this
server.
The fully qualified
host name for the
Domino server.
This must not be an IP
address and it should
match the name
specified below in the
InternetProtocols-HTT
P Host Name field.
For example,
stdom1.acme.com.
Specify the following
value if you want the
Sametime server home
page to be the default
page for users
accessing the server:
stcenter.nsf?Open
The DNS name for the
TCP/IP address for
your Sametime server.
This should match the
name specified above
in the Ports-Notes
Network Ports --> Net
Address field.
For example,
stdom1.acme.com.
Enabled
Appendix C: Setting up a Domino server using commands 89
6. If you made changes to the Server Document, stop and restart the
Domino server to make the changes take effect.
You have finished configuring the server. Proceed to the section "Verifying
the Domino server is accessible" in Chapter 3.
Adding a Domino server to an existing Domino domain using commands
To add a Domino server to an existing Domino domain, follow these steps:
1. Register the additional server for your normal operating environment.
You must specify the following settings during registration:
• Store the server ID file that is created during registration somewhere
on your server where you will configure the Sametime server. Record
the path name; you will need to specify it when you configure the
Sametime server.
• Change the owner of the ID file to QNOTES by entering the following
command on any i5/OS command line:
CHGOWN IDPATH QNOTES
where IDPATH is the path for the server ID file.
• Use the same network name as the first Domino server in the
Domino domain.
For detailed information about registering an additional server, see the
Lotus book, Installing and Managing Domino 7 for i5/OS.
2. Type the following command and press F4:
CFGDOMSVR
90 Installing and Managing Sametime 7.5 for i5/OS
3. Configure the Domino server with the following settings:
Note This appendix only documents settings that directly apply to this
Sametime installation. For settings that are not documented below, you
can enter your own values.
Field
Server Name
Description
Enter the name of the Domino server where
you will add Sametime. For example, enter
STDOM1/ACME1.
Specify *ADD.
Enter the path for the Domino server's data
directory. For example, enter
/LOTUS/DOMINO/stdom1.
Option
Data Directory
Get Domino Directory From
Enter the name of the Domino server that
has the Domino Directory that this server
will use. For example, enter DOM1.
Domino directory type
Specify *CENTRAL.
ID file
Specify the path of the server ID file that was
created when you registered the Sametime
server. For example, enter
/LOTUS/DOMINO/stdom1.id.
ID file's password
You may specify a password for the ID file if
you want.
Web Browsers
Specify *HTTP.
Sametime requires that you use the Domino
HTTP server.
Internet Mail packages
Specify *NONE.
Directory Services
Specify *NONE to reduce overhead.
Sametime does not require Directory
services.
Connection Services
Specify *NONE.
Advanced services
Enter *PARTITION, since multiple Domino
servers are running on the same server.
Internet Address
Enter the fully qualified host name for the
Sametime server.
Bind HTTP
Specify *YES
4. After you have entered the settings, press Enter and wait for the server
configuration to complete.
Appendix C: Setting up a Domino server using commands 91
5. Before adding Sametime to your new Domino server, you must verify
that several fields in the server document are correct. Depending on how
you manage your servers, you may want to verify the Server Document
in the Domino Directory for the Domain and replicate any changes to the
new server, or start your new server and verify the Server Document
located there.
Using a Domino Administrator client, open the Sametime Server
Document and verify the content of the following fields, updating the
fields if necessary:
Tab
Security
Ports-Notes Network
Ports
Field
Programmability
Restrictions: Run
unrestricted
methods and
operations
Port
Ports-Notes Network
Ports
Net Address
Internet
Protocols-HTTP
Mapping: Home
URL
Internet
Protocols-HTTP
Basics: Host Name(s)
Internet
Protocols-HTTP
Basics: Bind to host
name
92 Installing and Managing Sametime 7.5 for i5/OS
Setting
If you have signed agents
with a different signature,
then enter that signature
here too.
TCPIP
Note This must be specified
exactly as shown or you will
not be able to add Sametime
to this server.
The fully qualified host name
for the Domino server.
This must not be an IP
address and it should match
the name specified below in
the InternetProtocols-HTTP
Host Name field.
For example,
stdom1.acme.com.
Specify the following value if
you want the Sametime
server home page to be the
default page for users
accessing the server:
stcenter.nsf?Open
The DNS name for the
TCP/IP address for your
Sametime server.
This should match the name
specified above in the
Ports-Notes Network Ports
--> Net Address field.
For example,
stdom1.acme.com.
Enabled
6. Click Save and Close.
7. If you made changes to the server document, restart the Domino server
so the changes take effect.
You have finished configuring the server. Proceed to the section "Verifying
the Domino server is accessible" in Chapter 3.
Appendix C: Setting up a Domino server using commands 93
Index
A
Adding Sametime, 31, 49
Additional Domino server, 87
attachments, 67
C
Checking for installed software, 9
Community Services multiplexer, 70
Conversion Services, 67
D
Domino server, 16, 20, 25, 27, 29, 78, 83, 87, 90
E
Ending the Domino server, 31
Ending the Sametime components, 62
Ending the Sametime server
Operations Navigator, 61
Existing Domino Domain, 29, 90
F
Feedback
documentation, 1
H
Host Table, 16, 77
updating, 18, 80
HTTP server, 23, 85
I
Information, 13
Installing Sametime, 43, 45
L
Language Pack, 47, 49
M
Managing Sametime, 59
Multiple servers, 4
multiplexer, 70
O
OS/400 authorities, 7
P
Print Capture Utility, 4, 13
R
Removing Sametime, 66
Requirements, 7, 10
Audio/Video, 13
Browser, 13
Sametime Client, 13
S
Sametime Administration tool, 59
Sametime Conversion Services, 67
Sametime server, 10
Sametime toolkits, 70
Setting up Sametime, 7
Starting the Sametime Components, 62
Starting the Sametime server
Operations Navigator, 60
Starting the server, 31
T
TCP/IP address, 16, 17, 18, 79, 80
TCP/IP configuration, 15, 17, 77
W
Whiteboard, 4, 67, 68
Program Number: 5724-J23
Printed in USA
G210-2405-00

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project