Deploying IBM Sametime 9 on AIX 7.1 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 single node of Sametime 9 on AIX® 7.1 systems, including: • Preparing the environment prior to installation • Screen shots of the user interface during the configuration of each component • Common problems encountered during deployment
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Deploying IBM Sametime 9 on AIX 7.1
Table of ContentsIntroduction............................................................................................................................1Prerequisites..........................................................................................................................2Using SMIT (System Manager Interface Tool) ....................................................................... 2
Changing Logical partition sizes ........................................................................................ 2Increasing Paging Space (Swap Space) ........................................................................... 3Install all latest AIXupdates ................................................................................................ 4
AIX Network Tuning ............................................................................................................... 4Install UltraVNC on AIX .......................................................................................................... 4Install IBM Installation Manager, on AIX ................................................................................ 5Launch IBM Installation Manager .......................................................................................... 5Deployment............................................................................................................................6Install DB2 .............................................................................................................................. 6
Validation of DB2 installation ........................................................................................... 14Install Sametime Systems Console (SSC) .......................................................................... 14Install Domino 9.0.1 ............................................................................................................. 19Install Community Server ..................................................................................................... 29
Post Checks ..................................................................................................................... 35Install Proxy Server .............................................................................................................. 37Install Advanced Server ....................................................................................................... 47Install Meetings Server ........................................................................................................ 57Configure Single Sign-On (SSO) ......................................................................................... 67Extending the Sametime environment for HA and Failover ................................................. 76
Clustering Domino and Community Server ..................................................................... 76Clustering WebSphere Components (Proxy, Meetings, Advanced) ................................ 79
Common Problems..............................................................................................................85Installation Manager will not launch ..................................................................................... 85A Sametime9 build wont upload due to lack of space ......................................................... 85DB2 database create script fails .......................................................................................... 85AIDSC1352E: Unable to access the Sametime System Console database. ...................... 86Install of SSC fails : error=12, Not enough space (versionInfo.sh) ..................................... 86Install Domino9, InstallShield Wizard wont start up ............................................................. 87Domino9 server setup wizard wont initialize , with 'unlocked terminal' message ................ 88Specification of WebSphere folder in IBM Installation Manager (Recommendation) .......... 89References...........................................................................................................................89
IntroductionThis document describes the steps to deploy a single node of Sametime 9 on AIX®
7.1 systems, including:
• Preparing the environment prior to installation
• Screen shots of the user interface during the configuration of each component
• Common problems encountered during deployment
Note that this document supplements but does not replace the official Sametime 9technical documentation.
Prerequisites
Using SMIT (System Manager Interface Tool)Before deploying Sametime 9 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 indeployment 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.
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 -aPage Space Physical Volume Volume Group Size %Used Active Auto Type Chksumhd6 hdisk0 rootvg 512MB 66 yes yes lv 0
To display the information for the logical volume enter the following command:
STALE PPs: 0 BB POLICY: non-relocatableINTER-POLICY: minimum RELOCATABLE: yesINTRA-POLICY: middle UPPER BOUND: 32MOUNT POINT: N/A LABEL: NoneMIRROR WRITE CONSISTENCY: offEACH LP COPY ON A SEPARATE PV ?: yesSerialize IO ?: NOINFINITE 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 proceedThis 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:
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:
e..g ares-lpar10.mul.ie.ibm.com:1and enter the vnc password that was set from above.
Install IBM Installation Manager, on AIXThe 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 ManagerWhen 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 canbe 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):
Before proceeding to install Sametime 9 components on AIX refer to the pre-Installationplanning documentation in the Infocentre. This section illustrates the installation stepsundertaken to deploy a single node environment in AIX. The documentation in theSametime 9 Infocentre should be followed while performing this procedure. The logicalpartitions on the AIX system should be sized accordingly for uploading of Sametime builds.
Install DB2Upload DB2 (v10.1) build to AIX system and begin installation. See Reference [5].
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.1See References [6] & [7]. (Refer to Common Problems)./install
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).
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 and
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.
Click View Servers
Open names.nsf
Edit SSO configuration
Import the key.(above)
Edit SSO configuration.
Enter password for LTPA Token, Result: Successfully Imported WebSphere LTPA Keys
In the SSC, specify federated repository for user information.
LDAP DN can be modified (above)
Now 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.
Now 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
• 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.
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/dominoand 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
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 AIX System Management Interface Tool (SMIT)
[2] Installing IBM Installation Manager on AIX
[3] Installing Installation Manager
[4] Required gtk libraries for installation of Installation 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: Installing Domino
[8] Sametime 9: Installing the Sametime Community Server on AIX
[9] Sametime 9: Install Proxy on AIX, Linux, Windows
[10] Installing a Sametime Advanced Server on AIX, Linux, or Windows
[11] Sametime 9: Installing Sametime Meeting Server
[12] Expanding the deployment for high availability and failover