Procedure for upgrading Sametime Gateway V8.0.2.1 HF1 to V8.0.2 HF3

minceillusionInternet και Εφαρμογές Web

30 Ιουλ 2012 (πριν από 4 χρόνια και 11 μήνες)

249 εμφανίσεις

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions



Procedure for u
pgrading Sametime Gateway
V
8.0.
2.1
HF1

to
V8.0.
2

HF
3


This procedure
instructs
on how to upgrade your Sametime Gateway V8.0.
2.1 HF1

to
V8.0.2 HF
3
.

The procedure includes instruction and scripts for Microsoft Windows, and Linux. For
other ope
rating system contact IBM support.





The procedure includes the following steps:

Procedure for upgrading Sametime Gateway V8.0.2.1 HF1 to V8.0.2 HF3

......................

1

Prerequisite

................................
................................
................................
.................

2

Fix list

................................
................................
................................
.........................

2

Acquires the files

................................
................................
................................
........

2

Backing up the environment

................................
................................
.......................

2

Installing new STGW JAR files

................................
................................
.................

2

Installing SIP Container fixes for WebSphere Application Server

............................

5

Verifying the upgrade

................................
................................
................................
.

9


IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions



Prerequisite

This package should be applied on top of 8.0.
2.1 HF
1
.

Fix list

The package contains fixes for the following:

Acquires

the files

Make sure you have the following files before beginning:

STGW8.0.
2
_
HF
3
.zip



Download from fix central


Backing up the environment

It is recommended to backup your environm
ent before starting the upgrade process.

In each of the STGW server, run
a server file system
cold
backup, so that the whole file system
could be rolled back in case the upgrade fails.

There's no option to backup and rollback specific
directories
,

t
he whole file system should be backed up.

Installing new STGW JAR files


1.

Stop al
l of the Sametime Gateway processes on the server.


This includes: Sametime Gateway Server instances, WAS Node Agent, Sip Proxy
server instance, Deployment Manager (DMGR) server.


Make sure that there are no Java processes listed in the operating system p
rocesses
table. Forcefully end any running Java processes.



2.

Extract the STGW8.0.2
_
HF
3
.zip file into:


On
W
indows:

C:
\
STGW8.0.2
_
HF
3

On Linux/Unix:

/home/myuser/STGW8.0.2
_
HF
3


For example:

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions





3.

On all of your environment's Sametime Gateway (STGW) servers, loc
ate and take
note of all of the STGW shared Jars directories. You should have one or more such
shared Jars directories.


These directories takes the name form of:

On Windows:

C:
\
Program Files
\
IBM
\
WebSphere
\
STgateway
*
\
rtc_gw_lib
\

On Linux:


/opt/IBM/WebSphe
re/STgateway
*
/rtc_gw_lib/


Where the
*

character denotes a characters wildcard.

The directory path prefix (
C:
\
Program Files
\
IBM
\
WebSphere
\
) depends on
where you have originally decided to install Websphere.



Here are example of a number of STGW shared Jar
s directories on Windows:


C:
\
Program Files
\
IBM
\
WebSphere
\
ST
gateway
\
rtc_gw_lib
\

C:
\
Program Files
\
IBM
\
WebSphere
\
STgateway
Proxy
\
rtc_gw_lib
\

C:
\
Program Files
\
IBM
\
WebSphere
\
ST
gatewayPrimary
\
rtc_gw_lib
\

C:
\
Program Files
\
IBM
\
WebSphere
\
STgateway
ProxyStandalone
\
r
tc_gw_lib
\



4.

Once you have located all of the STGW shared directories, delete the files contained
in each of the directories (before deleting the files back them up in a
different

directory).

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions




For example on Windows:




5.

Copy the new JAR files from the
STG
W8.0.2
_
HF
3

package

Jars directory:


On Windows:

C:
\
STGW8.0.2
_
HF
3
\
Jars

On Linux/Unix:

/home/myuser/STGW8.0.2
_
HF
3
/Jars


to

each of the STGW shared directories from which you deleted files in the previous
step.

6.

Continue to
“I
nstalling SIP Container fixes for

W
ebSphere Application Server” in the
next section
.

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions




Installing
SIP Container
fixes for
WebSphere Application
Server

1.

Copy all the Pak files from
the STGW8.0.2.1HF
3

package

Paks directory

into the update installer maintenance directory.


The maintenance di
rectory default location is:


On Windows
:

C:
\
Program
Files
\
IBM
\
WebSphere
\
UpdateInstaller
\
maintenance
\

On Linux:


/opt/IBM/WebSphere/UpdateInstaller/maintenance/


2.

Launch the update installer.


F
or example, on Windows:

C:
\
Program Files
\
IBM
\
WebSphere
\
Update
Installer
\
update.bat


Note
: It takes a few seconds to actually show itself on the screen.

3.

Click
Next

on the W
elcome screen.

4.

The update installer should automatically find the installation location of the
AppServer Directory
;

if
it doesn't, type it in yours
elf.


For example, on Windows:

C:
\
PROGRA~1
\
IBM
\
WEBSPH~1
\
APPSER~
\


after you've verified the installation directory, click
Next
.

5.

On the
Maintenance O
peration
S
election
screen
, leave the default on "
I
nstall
maintenance

package
" and click
Next
.

6.

On the M
ainte
na
nce Package Directory Selection

screen
, provide the
path to the
maintenance directory where you placed the files.

7.

Select

the following paks
:



6.1.0.23
-
WS
-
WAS
-
IFPK83615.pak

Click
Next
.

8.

Click
Next

on the I
nstallation summary screen to start installing.

9.

Wait

for the installation to complete with a success announcement
; then c
lick
Next

to
finish the installation.

10.

Exit the update installer.

11.

Re
-
launch the update installer, and this time
select to
install the following paks:



6.1.0.23
-
WS
-
WAS
-
IFPK89010.pak

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions





6.1.0.23
-
WS
-
WAS
-
IFPK89478.pak



6.1.0.23
-
WS
-
WAS
-
IFPK92033.pak

12.

Exit the update installer
.

13.

Continue to
“I
nstalling new STGW EAR
and WAR files” in the next section.

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions



Installing new STGW EAR and WAR files

Important
: Since the deployment operation affects the entire clus
ter of servers, this step
should only be performed on the DMGR machine.

1.
Stop all of the Sametime Gateway processes on the server.


This includes: Sametime Gateway Server instances, WAS Node Agent, Sip Proxy server
instance, Deployment Manager (DMGR) serve
r.


Make sure that there are no Java processes listed in the operating system processes table.
Forcefully end any running Java processes.

2.
Starts the server



Cluster deployment


Start the Deployment Manager (DMGR) process.

Important
: Do not continue if t
he DMGR hasn't started.


For instructions on starting the deployment manager, see the
Star
ting the Integrated
Solutions Console

in the Lotus Sametime Gateway information center.


Single Server


Start the server process.

Important
: Do not continue if the server hasn't started.


For instructions on starting the deployment manager, see the
Starting a single server

in
the Lotus Sametime Gateway information center


3.
Open the folder
S
TGW8.0.2_HF3

and edit the

setenv

file that is appropriate for your
platform
;


On Windows
:

C:
\
STGW8.0.2_HF3
\
setenv.bat

On Linux/Unix:

/home/myuser/STGW8.0.2_HF3/setenv.sh


Change the following environment variables values to match your environment. For
exam
ple, on Windows (you may not need to change the path):


set WASDIR=C:
\
Program Files
\
IBM
\
WebSphere
\
AppServer

set WAS_USER_NAME=stgwadmin

set WAS_PASSWORD=stgwadmin


Save and close the file.

4.
Run the reDeploySTGW batch file that is relevant to your platform:


On Windows:

reDeploySTGW.bat

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions



On Linux/Unix:





chmod +x ./reDeploySTGW.sh




chmod +x ./setenv.sh




./reDeploySTGW.sh


The results will be written to the output file:
reDeploySTGW.log.txt

5.
To validate that the redeployment phase was successful, make sure

the following lines
appear in the output log file:


ADMA5013I: Application Sametime Gateway Core installed successfully.

ADMA5013I: Application Sametime Gateway User locator installed successfully.

ADMA5013I: Application Sametime Gateway Event logger inst
alled successfully.

ADMA5013I: Application Sametime Gateway Authorization controller installed successfully.

CWLAA10001I: The Integrated Solutions Console module was deployed successfully.


Make sure that the word
exception

not

appears in the output file i
n any way.

6.
Required:

Stop and restart server


Cluster Deployment


Stop the Deployment Manager (DMGR) process.



Single Server


Stop the server process.


7.
Cluster Deployment
: Start all node agents on the STGW and SIP Proxy servers.


8.
Cluster Deployment
:

Finally, log in into the deployment manager’s Integrated
Solutions Console and synchronize your changes to all nodes in the cluster by doing the
following:


a. Click
System Administration > Nodes
.

b. Select all nodes in the cluster, and then click
Full Re
synchronize
.

IBM Lotus Sametime Gateway 8.0.2 HF3
Upgrade Instructions



Verifying the upgrade

1.

Start your environment.

2.

After the environment had finished starting up, inspect the Sametime Gateway
Server SystemOut.log file.


For example, the default location on Windows (formatted to fit here):

C:
\
Program files
\
IBM
\
WebSphere
\
AppServer
\
profiles
\


RTCGW_Profile1
\
logs
\
RTCGWServer
\
SystemOut.log


Make sure that the following line appears:

Sametime Gateway Version
:
[STGW8.0.2HF3]
20090802.0949D