Deployment of Sametime9 for Advanced Interactive

eXecutive (AIX® 7.1) systems

Table of Contents
Introduction............................................................................................................................1
Prerequisites..........................................................................................................................2
Using SMIT (System Manager Interface Tool).......................................................................2
Changing Logical partition sizes........................................................................................2
Increasing Paging Space (Swap Space)...........................................................................3
Install all latest AIXupdates................................................................................................4
AIX Network Tuning............................................................................................................... 4
Install UltraVNC on AIX..........................................................................................................4
Install IBM Installation Manager, on AIX................................................................................ 5
Launch IBM Installation Manager.......................................................................................... 5
Deployment............................................................................................................................6
Install DB2..............................................................................................................................6
Validation of DB2 installation...........................................................................................14
Install Sametime Systems Console (SSC).......................................................................... 14
Install Domino 9.0.1............................................................................................................. 19
Install Community Server.....................................................................................................29
Post Checks.....................................................................................................................35
Install Proxy Server..............................................................................................................37
Install Advanced Server....................................................................................................... 47
Install Meetings Server........................................................................................................ 57
Configure Single Sign-On (SSO).........................................................................................67
Extending the Sametime environment for HA and Failover .................................................76
Clustering Domino and Community Server.....................................................................76
Clustering WebSphere Components (Proxy, Meetings, Advanced) ................................79
Common Problems..............................................................................................................85
Installation Manager will not launch.....................................................................................85
A Sametime9 build wont upload due to lack of space......................................................... 85
DB2 database create script fails..........................................................................................85
AIDSC1352E: Unable to access the Sametime System Console database. ......................86
Install of SSC fails : error=12, Not enough space (versionInfo.sh) ..................................... 86
Install Domino9, InstallShield Wizard wont start up.............................................................87
Domino9 server setup wizard wont initialize , with 'unlocked terminal' message ................88
Specification of WebSphere folder in IBM Installation Manager (Recommendation) ..........89
References...........................................................................................................................89

Introduction
This document describes the steps to deploy a Sametime9 (single node)
deployment on AIX® 7.1 systems showing the GUI content during the configuration phase
for each of the components. It also provides information on the preparation of the
environment prior to installation of Sametime and information on common problems
encountered during the deployment process.
Prerequisites
Using SMIT (System Manager Interface Tool)
Before deploying Sametime9 on AIX there are various administrative tasks that may
be necessary such as alterations to memory, or installation of certain packages or fixes
that may be needed in AIX. SMIT is an administrative application that can be used to alter
the sizes of the logical partitions and volumes in the AIX file system, and also to change
the paging space on the AIX system. An example of where SMIT has been used in
deployment of AIX is where the sizes of logical partitions need to be modified to create
sufficient memory on the file system for Sametime server builds and for installations.

Changing Logical partition sizes

Login to the AIX server (LPAR) using Putty as root user, type smit (this presents a menu system shown
below):

# smit
System Management

Move cursor to desired item and press Enter.

Software Installation and Maintenance

Software License Management
Manage Editions
Devices
System Storage Management (Physical & Logical Storage)
Security & Users
Communications Applications and Services
Workload Partition Administration
Print Spooling
Advanced Accounting
Problem Determination
Manage the AIX Cryptographic Framework
Performance & Resource Scheduling
System Environments
Processes & Subsystems
Applications
Installation Assistant
Electronic Service Agent
Using SMIT (information only)

To change the size of logical partitions follow this path:

System Storage Management (Physical & Logical Storage) -> File Systems -> Add / Change / Show /
Delete File Systems -> Enhanced Journal File Systems
-> Change / Show Characteristics of an Enhanced Journaled File System

Select the desired item to change from the menu system...and hit enter.

+--------------------------------------------------------------------------+
| File System Name |
| |
| Move cursor to desired item and press Enter. |
| |
| / |
| /home |
| /usr |
| /var |
| /tmp |
| /admin |
| /opt |
| /var/adm/ras/livedump |
| |
 | F1=Help F2=Refresh F3=Cancel |
| F8=Image F10=Exit Enter=Do |
| /=Find n=Find Next |
|---------------------------------------------------------------------------+

tab down to the mount point e.g. /tmp and hit enter.
This will display a field showing the number of units of 512 byte blocks.
Increase/decrease this number accordingly to increase/decrease the size of the partition.
Update the figure for the number of units and hit enter to apply the changes.
Then hit F10.

On the command line observer the size of the partition has changed with
# df -g
This will display all the file system sizes conveniently in GigByte blocks.

For more information on SMIT see Reference [1].

Increasing Paging Space (Swap Space)

The logical volume for paging space in AIX is usually 'hd6'. To see the paging space that is
available enter the following command:

# lsps -a

An example is given below:

# lsps -a
Page Space Physical Volume Volume Group Size %Used Active Auto Type Chksum
hd6 hdisk0 rootvg 512MB 66 yes yes lv 0

To display the information for the logical volume enter the following command:

# lslv hd6
LOGICAL VOLUME: hd6 VOLUME GROUP: rootvg
LV IDENTIFIER: 00c50f7700004c0000000142c87bd924.2 PERMISSION: read/write
VG STATE: active/complete LV STATE: opened/syncd
TYPE: paging WRITE VERIFY: of

MAX LPs: 512 PP SIZE: 256 megabyte(s)

COPIES: 1 SCHED POLICY: parallel
LPs: 2 PPs: 2

STALE PPs: 0 BB POLICY: non-relocatable

INTER-POLICY: minimum RELOCATABLE: yes
INTRA-POLICY: middle UPPER BOUND: 32
MOUNT POINT: N/A LABEL: None
MIRROR WRITE CONSISTENCY: of
EACH LP COPY ON A SEPARATE PV ?: yes
Serialize IO ?: NO
INFINITE RETRY: no
#
Here the size is calculated as the logical partition number times the size of each partition.
i.e. LP * PP SIZE (2 * 256 MB) = 512 MB

To increase the size of swap space, increase the value for the logical partition number, LP.
e.g. to increase LP by 8.
chps -s 8 hd6
To reduce the size of paging space, decrease the value for the logical partition number, LP.
chps -d 2 hd6

To reduce the size of a mount point:

chfs -a size=-5G /tmp

To increase the size of a mount point:

chfs -a size=+5G /tmp

Install all latest AIX updates

Obtain the latest AIX updates:
>smitty suma

Service Update Management Assistant (SUMA)

Move cursor to desired item and press Enter.

Download Updates Now (Easy)

Custom/Automated Downloads (Advanced)
Configure SUMA

Select "Download Updates Now (Easy)" -> "Download All Latest Fixes"
then enter yes to proceed
This downloads the .bff files to /usr/sys/inst.images/installp/ppc by default.

Install UltraVNC on AIX

Retrieve the vncserver (rpm) software from the following location:

ftp://ftp.software.ibm.com/aix/freeSoftware/aixtoolbox/RPMS/ppc/vnc/vnc-3.3.3r2-6.aix5.1.ppc.rpm
Upload the rpm to the AIX server using WinScp or other software.
Login using Putty (root/<password>) and install the package:
# rpm -ivh vnc-3.3.3r2-6.aix5.1.ppc.rpm

Set the VNC password:

# vncpasswd

Note: if this does not work responding with a response such as "Cannot write password file /.vnc/passwd"
then try:

# mkdir /.vnc
# /opt/freeware/bin/vncpasswd /.vnc/passwd
Password:
Verify:
#

Start the VNCServer:

/opt/freeware/bin/vncserver

List vnc processes to see what port to access using your vnc client..
e.g.
ps -ef | grep vnc
root 4587530 1 0 11:46:52 pts/0 0:00 Xvnc :1 -deskt

Login to the LPAR using UltraVNC (or other VNC) specifying server at port 1.
e..g ares-lpar10.mul.ie.ibm.com:1
and enter the vnc password that was set from above.

Install IBM Installation Manager, on AIX

The IM package to install is typically agent.installer.aix.gtk.ppc_1.6.2000.zip .
The procedure to install Installation Manager from IBM Infocentre can be found in Reference [2].
An unzip package is also required for use of an unzip command to extract the Installation Manager
package itself:
unzip-5.51-1.aix5.1.ppc.rpm

The latest verions of these can be obtained from IBM. Upload these packages to the AIX server.

Install the unzip package:

# rpm -ivh unzip-5.51-1.aix5.1.ppc.rpm

Once the size of the logical partitions are ok (from SMIT procedure above) extract the IBM Installation
package:
# unzip agent.installer.aix.gtk.ppc_1.6.2000.zip

Installing IBM Installation Manager can be done using console mode Reference [2] and Reference [3].
Install IBM Installation Manager in all AIX servers where it is required.

Launch IBM Installation Manager

When IBM Installation Manager is successfully installed it must be launched. Before it can be launched
succesfully however without error the following libraries are required to be installed on the AIX system.
This is a type of error that can be observed when attempting to launch IM if these libraries are NOT
installed.

java.lang.UnsatisfiedLinkError: Could not load SWT library.

To launch IM successfully install the GTK libraries (see Reference [4]), verify any verisons of these
packages that already exist are uninstalled. Here is the list of libraries (run them in the order below):

rpm -ivh zlib-1.2.3-3.aix5.1.ppc.rpm

rpm -ivh xrender-0.9.1-3.aix5.2.ppc.rpm
rpm -ivh freetype2-2.3.9-1.aix5.2.ppc.rpm
rpm -ivh expat-2.0.1-1.aix5.2.ppc.rpm
rpm -ivh fontconfig-2.4.2-1.aix5.2.ppc.rpm
rpm -ivh xft-2.1.6-5.aix5.1.ppc.rpm
rpm -ivh xcursor-1.1.7-3.aix5.2.ppc.rpm
rpm -ivh pixman-0.12.0-3.aix5.2.ppc.rpm
rpm -ivh gettext-0.10.40-6.aix5.1.ppc.rpm
rpm -ivh glib2-2.12.4-2.aix5.2.ppc.rpm
rpm -ivh libpng-1.2.32-2.aix5.2.ppc.rpm
rpm -ivh cairo-1.8.8-1.aix5.2.ppc.rpm
rpm -ivh libtif-3.8.2-1.aix5.2.ppc.rpm
rpm -ivh libjpeg-6b-6.aix5.1.ppc.rpm
rpm -ivh atk-1.12.3-2.aix5.2.ppc.rpm
rpm -ivh pango-1.14.5-4.aix5.2.ppc.rpm
rpm -ivh gtk2-2.10.6-4.aix5.2.ppc.rpm

Upload the rpms to the server and install using rpm *.rpm (Reference [4])

# cd /opt/IBM/InstallationManager/eclipse
# ./launcher

Installation Manager GUI should install successfully.

Deployment

Before proceeding to install Sametime 9 components on AIX refer to the pre-Installation

planning documentation in the Infocentre. This section illustrates the installation steps
undertaken to deploy a single node environment in AIX. The documentation in the
Sametime 9 Infocentre should be followed while performing this procedure. The logical
partitions on the AIX system should be sized accordingly for uploading of Sametime builds.

Install DB2
Upload DB2 (v10.1) build to AIX system and begin installation. See Reference [5].
Start setup.
./db2setup
Click Install New

Click Next
Accept license agreement and click Next.

Select Typical and click Next

Check option above and click Next.

Accept default directory and click Next.

Enter credentials for DAS user.
Select option above and click Next.
Select option above and click Next.

Enter credentials for Instance owner.

Enter credentials for fenced user

Select above and click Next.

Enter information above, instance user, are email (containing hostname).
Finally Click Finish and follow any on screen post-install instructions that are presented
see next section.

Validation of DB2 installation

When DB2 installation has been completed you should verify that DB2 has been
successful installed in the post installatons steps. You should run the db2val script to
check the status of the installation, /opt/IBM/db2/V10.1_01/bin/db2val (see below).
Check the log file mentioned also for any errors/warnings.

Install Sametime Systems Console (SSC)

Launch Installation Manager Preferences and select the repository.config
Click OK.
Check the boxes and click Next.
Accept license aggreement and click Next.
Click Next
Click Next
Specify WAS path as shown, validate and click Next.
Enter admin username and click Next.
Validate with db2 instance user, and click Next.
Install, and check installation logs.
Install Domino 9.0.1
See References [6] & [7]. (Refer to Common Problems)
./install
Next

Accept and click Next

click Next
Next

Click Next

Click Next

Accept default and click Next

click Next.

Setup Domino:

Select option and click Next.

Enter server name and title.

Enter password information for organisation.

Enter Admin ID. Here it is “Admin notes”, for “Admin” insert Admin in Last name field and
leave First name and Middle 'blank'. Check the option highlighted also.

Click Finish.

Install Community Server

Run setupaix.bin (from the installation package)

See Reference [8], and section Common Problems for chmod (below).

launches...
click Next

Accept license aggreement and click Next.

Next
Next

Yes and Next

Enter SSC admin credentials and click Next

See if deployment plan is found and click Next
Click Install

Click Finish.

Post Checks

Are Sametime Services running?

Login to Community Server

Check the status of the Deployment plan in ISC:

====================================================================

Install Proxy Server

See Reference [9]

In ISC add database that was created running the scripts in DB2, i.e. STPS.

Create a Deployment Plan

Select database

Finish..
Launch Installation Manager
Navigate to repository and Click Ok
Click Next

Accept license agreement, and click Next.

Next

Next

Validate WAS path and click Next.

Note diskinfo, if ok, click Next

Enter hostname and admin credentials

Verify deployment plan and click Next

Validate and Next

Install

Check installation logs when install is complete and follow all post-install steps
see Reference [9].
Install Advanced Server
See Reference [10]
In SSC ISC:

Specify hostname for Advanced and enter SSC admin credentials.

Chat room admin credentials.

Select database that was created in DB2.

Click Finish

Verify status of Deployment Plan.

Launch IM, navigate to repository and click OK.

Click Next.
Accept license agreement and click Next
Next

Next

Validate and Next

Validate and Next.

Verify deployment Plan exists.

Validate and click Next then Install

Install Meetings Server
See Reference [11]
In Sametime System Console.

In Installation Manager:
Next
Accept license agreement and click ok

Next

Validate and Next

Validate and click Next

Validate then Install

Check installation logs. See Reference [11]

Configure Single Sign-On (SSO)

Create a new LTPA Token in SSC:

Click LTPA

Specify a key file with username and password.

Export keys, this will create the LTPA key file at the specified location on the SSC.

Note: To import the LTPA Token one can use an IBM Domino Administrator client on
another machine e.g. a windows machine. To do this the admin.id file is copied over from
the AIX machine to that windows machine. This is the admin.id file that was saved during
the Domino server setup. It is located in /local/notesdata/.

If the primary Domino server does not have an IBM Admin client installed it may therefore be
desirable to use an IBM Admin client on another platform like windows for example. This can be
done to configure SSO and to register a secondary domino server. To do this:
1. Logon to a windows box that has IBM Domino Admin client installed.
2. Launch IBM Domino Admin and login as Admin user.
3. Copy over the admin.id file from the primary domino server (/local/notesdata) and store it on
the file system of the windows box hosting Domino Admin. Place it on the desktop for
convenience.
4. In Domino Admin choose File → Security → Switch ID
5. Navigate to the admin.id file on the desktop and click Open.
6. Now go to File → Open Server and under Select a server to administer, enter in the ipaddress
of the primary (AIX) Domino server. Click OK. The server is now added to the list of
administered servers in Domino Admin.

Open names.nsf

Edit SSO configuration

Import the key.(above)

LDAP DN can be modified (above)

Verify Single Sign On works as expected.

Extending the Sametime environment for HA and Failover

Failover and load balancing can be implemented in a Sametime deployment by creating a

cluster of multiple IBM® Sametime® servers of the same type. All Sametime servers can
be clustered except for the Sametime System Console, and the Video MCU and TURN
Server components of the Sametime Media Manager.

Clustering Domino and Community Server

Register the new secondary Domino server

1. Login to IBM Domino Admin client as Admin user.

2. Select the Configuration tab and choose File → Open Server
3. Select the primary Domino server that was configured earlier (Ensure Domino is started first)

4. Copy over the cert.id from the same location on the primary domino server (local/notesdata)
and store it on the windows desktop.
5. On the right hand side select Registration dropdown list and choose server. Enter in the Server
<primary server>/ibm and path to the Certifier ID on the desktop. Click OK.

6. Enter in the certifier password. It was defined during the Domino setup for the primary node.
Click OK.

7. On Register servers window, Click Continue.

8. Enter the secondary Domino server hostname. Uncheck 'In Domino Directory'. Check 'In File'
and click on the 'Set ID File' button, speciifying the path to the id file for the secondary node.
Specify desktop. Then click green tick button in screenshot below.

9. Select the new server and click Register.

Install Domino on the secondary node as an additional server.

Create cluster in Domino Admin.
Create a deployment plan for the new Community server
Bring down Domino and Install Community server on the secondary node

Clustering WebSphere Components (Proxy, Meetings, Advanced)

• Ensure system clocks for two nodes are synchronized.

• Create a deployment plan for the secondary node in the cluster e.g. PS2.
• Install the application software.
• Create the cluster.

The procedure for clustering WebSphere based Sametime components is generic.

See Reference [12]. Here we will give an example of how this is achieved for Sametime
Proxy.

Click Next

Click Next

Create a new cluster if one does not exist, or select an existing one.

Click Next

Click Next

Click Next
Wait a few minutes for the status for secondary node to update.

Click Finish

Common Problems

Installation Manager will not launch

On AIX navigate to /opt/IBM/INstallationManager/eclipse.
Launch IM as follows by running the launcher script.
# ./launcher
Result: fails to Launch with error:
java.lang.UnsatisfiedLinkError: Could not load SWT library.
Soln: Ensure all GTK library files are installed as described in section,
“Launch IBM Installation Manager”, see Reference [4].

A Sametime9 build wont upload due to lack of space

Run df -g to see the size of the various mount points.
Check the amount of memory used where the build is being uploaded, e.g. /tmp, /home.
If it is a high percentage figure ~80/90% then use smit to alter the size of the logical partitions.
See “Changing Logical Partition sizes” above.
Reference [1] or information.

DB2 database create script fails

./createSCDB.sh STSC db2admin
Processing...
./createSCDB.sh[62]: db2: not found
Database creation failed
Soln:
Edited the .profile for db2admin
adding the following lines:
if [ -f /home/db2inst2/sqllib/db2profile ]; then
. /home/db2inst2/sqllib/db2profile
fi
The DB2 script needs to be run as instance user,
in this case it is db2inst2
./createSCDB.sh STSC db2inst2

AIDSC1352E: Unable to access the Sametime System Console database.

Problem connecting to DB2 database for SSC when using the Sametime System Console
This is a comment in relation to connecting to the DB2 database that was created when
the
SSC script was run on the DB2 machine.

IF a db2inst (instance user)is used to run the script... ./createSCDb.sh STSC db2inst2
AND during the SSC installion (at the Common Configurations phase "Configure DB for
the
System Console" user DB2ADMIN (default)is specified for Application User Id, the install
will succeed..but
Problem:
1. Try to connect to SSC database.. Sametime Prerequisites -> Connect to DB2 databases
as db2admin or db2instX (instance user) results in:
AIDSC1352E: Unable to access the Sametime System Console database.
Solution:
Go to Resources -> JDBC -> Data Sources.
Test the connections for the resources that are availble. if ok then
Select each data Source e.g. sscScheduler and select JAAS - J2C authentication data.
 Click on the resource and change the database alias to instance user.
Repeat for all relevant Data Sources.
Finally: restart the node agent and App server for SSC.
Login again and it should be possible to connect to the database as instance user.
For more info:
see http://www-01.ibm.com/support/docview.wss?uid=swg21611878

Install of SSC fails : error=12, Not enough space (versionInfo.sh)

On AIX 7.1 an install of SSC may fail with a typical error:
This is the script being run the installation fails: i.e.
/opt/IBM/WebSphere/AppServer/bin/versionInfo.sh"
(in directory "/opt/IBM/WebSphere/AppServer/bin"): error=12, Not enough space

if the /opt directory has sufficient space, check the swap space also:
e.g.
# lsps -a
Page Space Physical Volume Volume Group Size %Used Active Auto Type Chksum
hd6 hdisk0 rootvg 512MB 66 yes yes lv 0

increase swap space (probably hd6 as above). See Increasing Paging Space (Swap
Space)
e.g. chps -s 8 hd6
if you receive an error:
0516-404 allocp: This system cannot fulfill the allocation request.
then you may need to decrease some other volume in rootvg to free up space for hd6.

For example chfs -a size=-10G /tmp (/tmp or other mountpoint with free space)
then try chps -s <nof_PPs> hd6
and it should create more swap space.
http://aixdoc.wordpress.com/2012/02/20/increase-paging-space-logical-volume-size/
retry installation of SSC, (may also need to uninstall WAS first)

Installing Domino: I/O completion ports error

If the installation of Domino fails with the above error then follow the procedure in
Reference [12].

Install Domino9, InstallShield Wizard wont start up

The script used to install Domino9 on AIX was in this location below
/tmp/Domino/Domino9-AIX/aix/domino
and the command

./install starts the installation for Domino9. ( as root)

Problem: Installshield wizard fails to start..

Solution:

The ./install script makes calls to setupAix.bin and setup.jar in the ./tools
subdirectory.. The permissions on these files was -rw-------
when I turned on the executable bit on these files it works then..
-rwx------ 1 root system 31240115 Mar 9 2013 setupAix.bin
-rwx------ 1 root system 742213540 Mar 9 2013 setup.jar

Domino9 server setup wizard wont initialize , with 'unlocked terminal'

message

When using a Graphical Desktop to logon to the Domino server, the following
steps are required to set up Domino:
1. Change to user 'notes', su notes
2. cd /local/notesdata where the notes.ini is located.
3. Start Domino9 setup: /opt/ibm/domino/bin/server

Problem:

When attempting to start Domino after installation the following error message
may appear:
”Please edit your shell's DISPLAY environment variable to reflect an
unlocked terminal that you would like to launch the Domino Setup
Program on”.

Solution:
1. Logon as root
2. Add server to the ACL: /usr/lpp/X11/bin/xhost ares-lpar28.mul.ie.ibm.com
 Response: ares-lpar28.mul.ie.ibm.com being added to access control list
3. Switch to user notes and then cd /local/notesdata
4. Export display: export DISPLAY=ares-lpar28.mul.ie.ibm.com:1
5. /opt/ibm/domino/bin/server
Result: Domino server setup wizard should now start up.

Cannot connect to LDAP from SSC

Cannot connect to database from SSC
-SSC install inst user must be specified
-space in /home
installation of WAS Component fails because of space..
/opt/IBM/WebSphere/AppServer/bin/versionInfo.sh" error=12, Not enough space
Sso.
SAMETIME services wont all start up/shut down
- reboot

Specification of WebSphere folder in IBM Installation Manager

(Recommendation)

When installing WebSphere Application Server (for AIX) through the IBM Installation Manager GUI, at the
page "Install Packages" one is required to specify the installation directory for WAS.
Note that it may default to /usr/IBM/Websphere/AppServer. This is acceptable.
But it is nonetheless advisable to modify it to /opt/IBM/Websphere/AppServer if desirable.

References

[1] Introducing SMIT

[2] Installing IBM Installation Manager on AIX
[3] Installing Installation Manager by using console mode
[4] Required gtk libraries for installation of Installaiton Manager on AIX
[5] Installing DB2 on AIX, Linux or Windows
[6] Installing and configuring IBM Lotus Domino 8.5 on AIX
[7] Sametime 9 Infocentre: Installing Domino
[8] Samtime 9 Infocentre: Installing Sametime Community Server on AIX
[9] Sametime9 Infocentre: Install Proxy on AIX, Linux, Windows
[10] Installing a Sametime Advanced Server on AIX, Linux, or Windows
[11] Sametime9 Infocentre: Installing Sametime Meeting Server
[12] Expanding the deployment for high availability and failover
[13] AIX Network option tunable parameters
[14] AIX, Operating systems and network tuning
[15] AIX, Summary of network service options