Presentation on building Sametime 9.0.1 step by step from Domino server through to SSC, Sametime Proxy and SSL configuration. Given at IBM Connect 2014 with Paul Mooney SHOW401
4. !
Gab Davis - Technical Director
The Turtle Partnership
gabriella@turtlepartnership.com
▪ Administrator / Problem Solver /
System Designer / Optimist
▪ Working with ICS products,
Domino, Sametime, WebSphere,
Connections etc
▪ Also integration with other
systems
▪ Co-Author of Sametime 8.5.2
Admin Guide, Connections
Enterprise RedWiki &
connections101.net
!4
▪ I present a lot globally & blog on
turtleblog.info
5. !
Paul Mooney - Senior Technical
Architect
Bluewave Technology
paul.mooney@bluewavegroup.eu
▪ Administrator, problem solver,
enabler, cynic, pessimist
▪ Working on ICS products,
Salesforce, Google Apps
▪ Also integration with anything!
▪ Co-Author of connections101.net,
blogger, speaker, reviewer
▪ Tries to fit motorbikes around
anything to do with his work
!5
9. Before Installing
▪ Create a db2 account to be used for managing
your server.
▪ On Windows we use a local system account
“db2admin” that is also in the Administrators
group
▪ You can use a domain account but this
often causes more problems if the account
security is changed in any way
▪ Make sure the password you set does not
expire
!9
11. DB2 Installer
▪ Sametime 9 requires DB2 10.1
▪ for this reason doing an upgrade in place isn’t recommended
▪ DB2 10.1 no longer has a Command Center GUI interface
▪ you must install a separate client (we recommend IBM DB2 Data Studio)
Windows 64bit DB2 10.1 server installer
!11
35. Verifying The DB2 Server Is Licensed
▪ From the DB2 Command window type
▪ db2licm -l
Not
enough memory for
Sametime + Connections
databases (20+).
!35
37. Installation Manager Download
▪ Hard to find on IBM’s usual download site
▪ Can be found on fix central
▪ Search Google for ‘installation manager download” to find a technote with FTP links
This is
version 1.7.1. Sametime uses 1.6.2
by default but can use later
!37
46. Installation
Manager’s menu “Install” to
install new software
“Update”
to patch or hotfix already
installed software
“Rollback”
to remove a hotfix or patch
“Modify”
to add new features (we do
this with Connections all the
“Uninstall”
time)
to completely remove installed
Software
!46
47. Installation Manager - Things To Know
▪ Installation Manager keeps a track of all software it installs
▪ You can’t uninstall software that was installed via Installation Manager without going
through the Installation Manager menu
▪ Everything other than Domino and DB2 installs via Installation Manager
▪ Installation Manager must be on every machine where you want to install a WebSphere
component
▪ You can’t uninstall Installation Manager whilst programs it installed still exist
▪ You can’t install multiple Installation Manager’s on the same server
▪ Get the right version
▪ Get it installed in the right place
▪ Leave it alone :-)
!47
53. We Need To Add A New Installation Repository
▪ An installation repository tells Installation
Manager where to look for install files
▪ Choose “File - Preferences” from the
Installation Manager home screen
!53
54. Since
This
this is our first install there
checkbox means that
are no repositories yet, we need to
Installation Manager will ask you
add them
for IBM credentials and will search
online for patches and fixes for
any installed software
!54
56. Confirm The
We
select a repository (in this
case our WebSphere installers) by
selecting the repository.config file in
our extracted WAS directory
!56
62. Installation Manager Shared Directory
▪ This is the first time we have installed anything via Installation Manager so it wants to know
where you want it to store the information it knows about the software it installed
▪ This location cannot be changed or deleted later and should be accessible to any account
running Installation Manager for installs or updates
!62
69. The Sametime System Console Database
▪ To store the configuration settings for all the Sametime servers the SSC must have a DB2
database to write to
▪ Databases are used by several Sametime components
▪ System Console
▪ Meetings
▪ Proxy
▪ Advanced
▪ Bandwidth Manager
▪ Before we can install any of the above components we first need to create their databases,
starting with the Sametime System Console
!69
70. Scripts to
auto create the databases and apply the
schema are in the DatabaseScripts directory of
the extracted SSC install files
!70
71. Running the Create Script For The SSC Database
▪ Go to the directory where the script is located (move it somewhere more convenient if you
want but move the entire directory not just the batch file)
▪ The command syntax is
▪ scriptfile nameofdatabase nameofdb2administrator
e.g. createSCDB STSC db2admin
will create a database called STSC with db2admin as its administrator
!71
72. You May Get A Blank Screen For A Few Minutes
Don’t Panic!
!72
76. As
we did with WebSphere, we have to set
up a repository to tell Installation Manager
where to look for install files
!76
77. Locate Where You Extracted The System Console Files To
There
should be a repository.config
file in the root folder
!77
78. We Still Have The WebSphere Repository Defined
Leave that in place
!78
79. Now We Add The Sametime System Console Repository
!79
80. Now We Have Two Repositories That Installation Manager
Knows About
Leaving
both checkboxes selected tells
Installation Manager to search both
directories for new software
!80
84. Package Groups
Since this
is the first of the Sametime products
Installation Manager has installed, it wants to create
a new package group and location to store all of its
information about the Sametime product
!84
86. The
SSC installs using WebSphere
so we need to tell the installer where
WebSphere is
Selecting
validate tells Installation Manager
to verify the directory and WebSphere
are where you said they were
!86
88. Here
we define our SSC WebSphere
settings including Node name and Cell
name. These are non changeable
once created
This
will be the administrative
credential for all your
Sametime servers
eventually
Avoid
any special password
characters including
! @ { } $ etc
!88
89. Our
final configuration page is
to tell the install where to find the
DB2 database we just created and
how to login to it
Don’t
forget to validate
!89
90. Validated
means the installer was able
to connect to your DB2 server and
access the database you specified
using the credentials given
!90
94. Verify The Two New Profiles Exist
▪ STSCDMgrProfile is the deployment manager which manages all servers in the cell
▪ STSCAppProfile is the application server hosting the Sametime System Console application
!94
95. Sametime 9 On Windows Creates Services For All
Components
▪ STConsoleServer_DM - the deployment manager
▪ STConsoleServer_NA - the node agent
▪ STConsoleServer - the application server
▪ Services should be started in the order listed above
▪ The application server won’t start until the node agent is started
!95
96. Starting Servers Manually
▪ To start servers manually go to the “bin” directory under each profile and type
▪ startServer [servername]
the server name and (on linux) the command itself are case sensitive
▪ The deployment manager can be started using “startManager” instead of startServer dmgr
▪ The node agent can be started using “startNode” instead of startServer nodeagent
!96
97. Log Into The Sametime System Console
URL
https://<hostname>:8701/ibm/console
The
SSC has a certificate
creates by the installer which your
browser won’t recognise
!97
100. Backup Before Making Changes
▪ Since we’re about to change WebSphere security, let’s backup first
▪ from bin directory under the STSCDMgrProfile type backupconfig <nameofzipfile> -nostop
!100
110. LDAP Base Entry
▪ The level within the LDAP hierarchy that should be searched to find and authenticate users
▪ for Domino this is usually empty so non hierarchical entries like groups can be found
!110
111. Advanced LDAP Settings - Optional (1st part)
▪ If you don’t modify Advanced
settings the default values will be
used which will be fine in many
standard installs
Using
Advanced settings you can specify the
attribute to be used for display name as well as
that which contains the home sametime
server
!111
112. Advanced LDAP Settings - Optional (2nd part)
The
attributes users can use to login
and those used when searching for
new contacts
!112
118. Windows 2008 & Later Networking Issues
- Sametime Community Server
▪ Before installing the Community Server there are default networking settings that conflict with
Sametime we need to check for incorrect settings using “netsh in tcp show global”
▪ Chimney Offload should be disabled
▪ Receive-Side Scaling should be disabled
▪ Receive Window Auto-Tuning should be disabled
▪ Add-On Congestion Control Provider Should Be None
!118
119. First Back Up The Registry (To Be On The Safe Side)
▪ Load regedit.exe from the Windows menu
▪ Choose File - Export and save a backup of the registry
!119
124. Name The Deployment Plan Something Meaningful For You
Users Won’t See This Name Ever
!124
125. Choose Which Version Of Community Server To Install
▪ You Can Still Install 8.5.2 In A v9 SSC but would have to use a Domino 8.5.2 server
!125
126. Configuring Domino Server To Use For Community Server
▪ Domino server must be installed and running HTTP
Credentials
should already exist in
Domino Directory
!126
127. Select LDAP Configuration To Use
▪ Your options will only be those you have created under “LDAP Configuation” in the previous
step
!127
137. Since
we have a deployment plan
we use the System Console to
install
!137
138. We tell
the installer how to find the
System Console by hostname and
port
These
are credentials to
login to the System
Console
The
hostname used here must
match the one in the plan we
just created
!138
139. The
hostname matches a plan found in
the System Console and the plan name
is returned
!139
146. ▪ Any server that will need to connect to the Community Server must be listed in the Trusted
IPs for that server. List the ips for any other Sametime component for instance
▪ Choose the server we just installed which is listed under “Sametime Community Servers”
▪ Policies need to be reviewed
▪ Global Community Server properties need to be set
!146
147. Editing Community Server Connection Properties
▪ The account and password used for the System Console to access the Community Server
are stored under “Edit” on Connection Properties
!147
148. Setting Community Server Properties
▪ Changes here will require a restart of the Community Server so let’s do them all now
On
servers with multiple ips make
sure to bind to a specific
hostname only
!148
154. Working With Policies
▪ Two default policies are created, one covering all authenticated users and one for anonymous
users. Review these before going any further
▪ As of Sametime 9 policies no longer exist in the Domino web based Sametime administration
and neither does stpolicy.nsf
▪ You must now have a System Console if you want to use policies with Sametime
!154
155. Instant Messaging Policy
If
you are upgrading communities
side by side consider
This is
a client side setting,
transcripts are not saved on the
server automatically
Contact
list size significantly effects
LDAP performance
!155
160. Sametime Proxy Server
▪ The Sametime Proxy Server acts as a web proxy to your Community Server
▪ It can connect to any server in your Community
▪ Mobile clients connect to the Sametime Proxy Server and from there to the Community
Server
▪ Building a new Sametime Proxy Server requires us to create a database and then a
deployment plan before installing
!160
161. Creating The Sametime Proxy Server Database
▪ The create database script is found in the DatabaseScripts folder
in the extracted Sametime Proxy Server install directory
!161
162. Creating The Sametime Proxy Server Database
▪ Run from a command prompt
▪ createProxyDb [databasenametocreate] [db administrative account]
▪ e.g createProxyDb STPROXY db2admin
!162
170. Community Server Version
You can
install earlier Community Server versions
into a v9 SSC but Domino can’t be v9 unless the
Community Server is
!170
171. Primary and Secondary Nodes
▪ The first server of a type added to the System Console is the Primary Node
▪ additional servers considered cluster mates are secondary nodes
▪ If you install a server in its own cell it will not be managed by the System Console
▪ There can only be one Primary Node of each server type (Meeting, Proxy , Advanced etc) in
each cell
!171
172. Add
the new node to the existing
Cell (the System Console)
!172
173. These
are the WebSphere
configuration settings for the
new Sametime Proxy
Install
If
using Primary or Secondary
node,the server will be federated into the
cell and its user id and password
overwritten with that of the SSC
!173
174. Select Which Community Server To Connect To
▪ The Sametime Proxy will connect to any server in the Community (the Domino domain)
▪ You can modify its XML file later to bind it to a cluster or a specific server
!174
175. Select The Database To Use
▪ If you try selecting STSC it will not accept that as a valid database because the schema will
be wrong, this is why we create a specific database for the Sametime Proxy
!175
178. Locate The Repository.Config
▪ We will need to add the install repository for the Sametime Proxy to the Installation Manager
to do the install
▪ The repository.config should be in the root directory of the extracted install files
!178
181. We
now have three repositories that
Installation Manager is told to look in
WebSphere
SSC
Sametime Proxy
!181
182. Since
Installation Manager is told to look
in three repositories it finds three software
products to install. We select Sametime
Proxy Server only
!182
183. Since we
have already installed the SSC we
have a package group
If
this was a dedicated server for
Sametime Proxy there would be no existing
package group and Installation Manager
would create one
!183
184. We
have a deployment plan so
we use the System Console to
find that and install
!184
185. We
Since
Sametime Proxy Server
installs using WebSphere we
must tell the installer where
WebSphere is
!185
can’t proceed until
we validate WebSphere
is in place
187. Hostname
& port of the System
Console
Credentials
used to login to the SSC
Hostname
for the Sametime Proxy server
(must match the deployment plan
hostname)
!187
188. The
settings must be validated
before you can continue, this
ensures the SSC can be found
and connected to
!188
202. Creating A Dedicated Virtual Host
▪ Each Sametime component uses a dedicated virtual host to isolate its traffic from any other
server in the cell on the same port
▪ Without this step you may see redirections failing
▪ Make sure you BACKUP deployment manager before making these changes
!202
203. Precreated virtual hosts
Select
“New” to create a
dedicated virtual host
!203
admin_host used by the SSC
proxy_host is nothing to do with
the Sametime Proxy
204. Call the
new host anything not already in use,
in our case we’ve used
Now
click on Host Aliases to
add our new ports
!204
205. Click
“New” to add specific ports for
the Sametime Proxy Server
hostname
!205
206. Add each
port for any hostnames you want to
access the Sametime Proxy Server on
!206
207. You
should end up with entries
for each hostname for the server
ports
wc_defaulthost
wc_defaulthost_secure
plus: 80 & 443
!207
208. We
need to modify the default_host
aliases to remove the wildcard entries
for ports we have explicitly mapped
!208
209. Since
we mapped ports 9081, 9444,
80 and 443 in the stproxy_host we we
need to delete these as they now
conflict
!209
218. Managing Performance
Number
of concurrent user connections.
“0” disables all user connections
Disable
this if you want to prevent the
Sametime Proxy Server authenticating
against the user’s home server instead of the
server connected to this proxy
!218
219. Mobile Settings
APNS
ports for iOS notifications
that must be open outbound
from the Sametime Proxy
Server
Disable
PUSH for iOS forcing logout when
client goes into the background
!219
220. Creating A WAS Proxy For Our Sametime Proxy
▪ The Sametime Proxy Server when installed runs on the wc_defaulthost and
wc_defaulthost_secure ports for http and https respectively
▪ Those are not the ports 80 & 443
▪ To avoid having to place the port number in the URL to access the Sametime Proxy Server
we create a WAS Proxy that runs on ports 80 & 443 and provides a proxy service to the
application server
▪ We do the same for Meeting Servers
!220
227. Once Started You Should Be Able To See Ports 80 & 443
Listening on the Host Name Being Used
▪ You don’t have to install the WAS Proxy on the same server as the Sametime Proxy Server
▪ You can install multiple WAS Proxies behind a load balancer for additional failover
!227
229. Configuring SSL
▪ To use SSL we are going to want to install a certificate from a known certificate authority and
not use the internal IBM one that the installer created on the fly as that isn’t recognised by
any browser or mobile device
▪ To do this we need to import the trusted certificates from whatever CA we choose and then
generate a Certificate Signer Request and import the certificate we are given
▪ All of the SSL work is done under SSL Certificate and Key Management
!229
230. Step 1: Install The Trusted Roots
▪ I used GeoTrust for my CA but you could use any provider
▪ Trusted roots are installed into the CellDefaultTrustStore under Signer Certificates
!230
231. The
only trusted root that exists is
the one IBM created on the fly
during install
!231
232. Adding A New Trusted Root Certificate
Take
the trust certificates from your
authority’s site (in my case GeoTrust)
and add them here. Alias can be
anything meaningful to you
!232
235. Only The Default Personal Certificate Created By The
Installer Exists
!235
236. Create A Personal Certificate Request (CSR)
▪ This will create a file you can upload to any CA site such as GeoTrust, Verisign, GoDaddy,
Thawte to complete your request for a SSL certificate
▪ Go to CellDefaultKeyStore (not trust store) and choose “Personal Certificate Requests”
!236
237. Completing a CSR (Personal Certificate Request)
The
details you complete
here must match those
submitted on the CA site. The
Organization name must match
the owner of the domain you
are requesting a CSR for
!237
238. Importing A Completed Certificate
▪ Once your CA returns the certificate to you, it needs to be imported.
▪ If it arrives as an email just copy/paste the contents of the certificate into a text file
▪ Choose “Receive certificate from CA”
▪ You can only receive a certificate you have an outstanding request for
!238
240. Mapping The New Certificate To The Server Instances
▪ Now we have our new certificate we have to tell our application servers to use it instead of
the certificate they were installed with
▪ Wildcard certificates can be used here and with Sametime 9 it’s a requirement that the
Sametime Advanced and Sametime Proxy servers do use the same exact certificates
▪ To map a new certificate go to “Manage EndPoint Security Configurations”
!240
241. Select
the server to map. Here we have
already mapped the STProxyServer but
also need to map the WAS Proxy
stproxy_fwd
Select
server name to map
!241
242. SSL Mapping
Make sure
to override inherited values
Select the
new alias from the drop down list
!242
244. Restart Both The Application Server And WAS Proxy
▪ Go to https://<stproxyhostname>
▪ redirection will happen automatically
▪ no port required
▪ the new SSL certificate should be in place
and no warnings received
!244
245. To Enable Google Android Push Updates We Need To
Import Google’s Certificates
Use
EXACTLY these
settings and select “Retrieve
signer information”
!245