Table of Contents Previous Next PDF


Deploying Oracle TSAM Plus Manager

Deploying Oracle TSAM Plus Manager
This chapter contains the following topics:
Deploying Oracle TSAM Plus Manager
This section contains the following topics:
Overview
The Oracle TSAM Plus Manager functions as a Web application in a Servlet/JSP container. It uses the DBMS (Database Management System) to store persistent Oracle Tuxedo performance and monitoring data. Before using Oracle TSAM Plus Manager, it must be deployed to a database server and a Web application container. Optionally Oracle TSAM Plus Manager can use LDAP server for authentication.
If you input the LDAP configuration file during installation, the LDAP deployment is done automatically; otherwise, you must do the LDAP deployment using the "LDAP Deployment Utility" if you want to enable the LDAP authentication.
If you select "Bundled Derby database", "An existing Derby database" or "An existing Oracle database" during installation, Oracle TSAM Plus Manager is deployed on the specified database server automatically; otherwise, you must deploy Oracle TSAM Plus Manager to a database server using the "Database Deployment Utility".
If you select "Bundled WebLogic Server" or "Existing WebLogic Server" during installation, Oracle TSAM Plus Manager is deployed on the specified application server automatically; otherwise you must deploy Oracle TSAM Plus Manager to an application server using the "Application Server Deployment Utility" or manually.
Oracle TSAM Plus Manager LDAP Deployment
The LDAP deployment updates the LDAP configuration information in the tsam_wls12c.ear file (located at <TSAM_DIR>/deploy). For more information, refer to Deploying LDAP Configuration File in Oracle TSAM Plus Configuration Guide.
Oracle TSAM Plus Manager Database Server Deployment
If you choose to deploy Oracle TSAM Plus to an existing database server after installation, you must add an Oracle TSAM Plus database after installation using the database deployment utilities.
Database Deployment Utilities
Oracle TSAM Plus provides the following database deployment utilities:
Windows Database Deployment: DatabaseDeployer.cmd
The database deployment utilities do the following:
Note:
If the TSAM Plus database user is created manually or by one earlier release of TSAM Plus, run <TSAM12c_DIR>/deploy/TSAMGrantOracle.ddl in the database administrator role to grant the necessary privileges to users. Replace "#TSAM_DB_USER#" in TSAMGrantOracle.ddl with the real user name and “;" followed.
Resets the default admin user password to the password specified by the parameter -adminpassword when setting the parameter “-resetpassword yes”.
Specifies a Weblogic data source JNDI name with the "-wlsdsJNDIname" parameter. The database properties parameters are ignored if "-wlsdsJNDIname" is specified.
Note:
The Oracle database driver is recommended to be “*Oracle's Driver (Thin) for Instance connections, Versions:9.0.1 and later”, “*Oracle's Driver (Thin) for RAC Service-Instance connections; Versions:10 and later", or “*Oracle's Driver (Thin) for Service connections; Versions:9.0.1 and later"
The Derby database driver is recommended to be “Derby's Driver (Type 4) Versions:Any”.
Decides whether to use the Oracle Database Partitioning feature to manage the database table according to the parameter -enable_partition yes|no. This is a mandatory option when the database type is 'oracle'. It specifies whether to create the Oracle Database schema with partition. -enable_partition yes is only used for Oracle Enterprise Edition (with partition feature).
Listing 1‑1 and Listing 1‑2 show Unix/Linux and Windows database deployment utility examples accordingly.
Note:
If you select the parameter "-overwrite yes", the existing TSAM Plus database is always overwritten and the database connection URL in the tsam_wls12c.ear file is updated; If you select the parameter "-overwrite no", the database connection URL is updated, but the existing TSAM Plus database is not overwritten
The database connection URL in the tsam_wls12c.ear file is overwritten after you run the database deployment utility. You must redeploy the tsam_wls12c.ear file on the application.
For more information, see the Oracle TSAM Plus Installation Guide.
Listing 1‑1 Unix/Linux Database Deployment Utility Example
1.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type derby -hostname localhost -port 1527 -dbname TSAM -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
2.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
3.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type oracle -enable_partition yes -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
4.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type oracle -enable_partition yes -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -dbSysdbaUser sys -dbSysdbaPwd tsam -tsamDbTablespace users -adminpassword admin1
5.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type oracle -enable_partition yes -url jdbc:oracle:thin:@localhost:1521:TSAM -user tsam -password tsam -dbSysdbaUser sys -dbSysdbaPwd tsam -tsamDbTablespace users -adminpassword admin1
6.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -type oracle -enable_partition no -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -adminpassword admin1 -resetpassword yes
7.
cd <TSAM_DIR>/deploy
./DatabaseDeployer.sh -wlsdsJNDIname ds_tsam
Note:
 
Listing 1‑2 Windows Database Deployment Utility Example
1.
cd <TSAM_DIR>\deploy
DatabaseDeployer.cmd -type derby -hostname localhost -port 1527 -dbname TSAM -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
2.
cd <TSAM_DIR>\deploy
DatabaseDeployer.cmd -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
3.
cd <TSAM_DIR>\deploy
DatabaseDeployer.cmd -type oracle -enable_partition yes -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
4.
cd <TSAM_DIR>\deploy
DatabaseDeployer.cmd -type oracle -enable_partition no -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -adminpassword admin1 -resetpassword yes
5.
cd <TSAM_DIR>\deploy
DatabaseDeployer.cmd -wlsdsJNDIname ds_tsam
Note:
 
Oracle TSAM Plus Application Server Deployment
If you choose to deploy Oracle TSAM Plus Manager to an existing application server after installation, you must deploy it to an existing WebLogic Server 12c Domain after installation using the application server utilities, or manually.
Note:
For more information, see http://www.oracle.com/tools/toplink_adf.html.
Application Server Deployment Utilities
Oracle TSAM Plus provides the following application server deployment utilities:
Unix/Linux Application Server Deployment: AppServerDeployer.sh
Windows Application Server Deployment: AppServerDeployer.cmd
Unix/Linux and Windows application deployment utility examples are shown in Listing 1‑3 and Listing 1‑4 accordingly.
Listing 1‑3 Unix/Linux Application Server Deployment Utility Example
Deploy TSAM Plus to a WebLogic server
cd <TSAM_DIR>/deploy
./AppServerDeployer.sh -type weblogic -adminurl localhost:7001 -directory /home/oracle/wlserver_10.3 -user weblogic -password weblogic1
 
Listing 1‑4 Windows Application Server Deployment Utility Example
Deploy TSAM Plus to a WebLogic server
cd <TSAM_DIR>\deploy
AppServerDeployer.cmd -type weblogic -adminurl localhost:7001 -directory C:\oracle\wlserver_10.3 -user weblogic -password weblogic1
 
Manual Application Server Deployment
Oracle TSAM Plus Manager provides deployment scripts for the following application servers:
Oracle TSAM Plus Manual Oracle WebLogic Server Deployment
After installing Oracle WebLogic Server, do the following steps to deploy Oracle TSAM Plus:
1.
2.
3.
4.
5.
In the Install Application Assistant, locate the tsam_wls12c.ear file in the $TSAMDIR/deploy directory.
6.
Click Next.
7.
8.
Click Next.
9.
10.
Click Next.
11.
Typically, the default values are adequate.
12.
Click Next.
13.
At the Settings for TSAM Plus page, you can modify specific settings for TSAM Plus at Configuration - > General. For example, Session Timeout (in seconds).
14.
15.
Changing Configuration Parameters
You can directly run the Oracle TSAM Plus Manager without changing any Oracle WebLogic configuration parameters.
If required, you can change the default for the following parameters:
Setting the Minimum JAVA Option Memory Size
When installing Oracle TSAM Plus with a Weblogic server, specify at least 2048MB heap memory for the Weblogic server:
-Xms2048m -Xmx2048m
For information about how to change the heap size, refer to Oracle Weblogic documents.
Configuring Oracle WebLogic Listening Port
The default Oracle WebLogic Server Listening port number is 7001. To change the default Listening Port, do the following steps:
1.
Launch Oracle WebLogic Server Administration Console using the following URL: http://localhost:port/console. Where: "localhost" is the host name of the machine running WebLogic Server, "port" is the port number where WebLogic Server listens for requests.
2.
3.
4.
Click the Server, e.g., exampleServer, where Oracle TSAM Plus is deployed.
5.
6.
Configuring Session Timeout
To set Session Timeout, do the following steps:
1.
2.
3.
4.
5.
6.
Configuring HTTP KeepAlive
To enable and disable HTTP KeepAlive, do the following steps:
1.
Launch Oracle WebLogic Server Administration Console using the following URL: http://localhost:port/console. Where: "localhost" is the host name of the machine running WebLogic Server, "port" is the port number where WebLogic Server listens for requests (7001 by default).
2.
3.
4.
Click the Server, e.g., exampleServer, which your TSAM Plus deployed.
5.
6.
Configuring POST Maximum Byte Size
To set the maximum size in bytes of the POST unlimited, do the following steps:
1.
2.
3.
4.
Click the Server, e.g., exampleServer, which your TSAM Plus deployed.
5.
6.
Configuring Maximum Thread Simultaneous Processing
Maximum Thread Simultaneous Processing is mapped into Maximum Threads Constraint at WebLogic Server. To configure Maximum Threads Constraint, do the following steps:
1.
Launch Oracle WebLogic Server Administration Console using the following URL: http://<hostname>:<port>/console, where <hostname> is the host name of the machine running WebLogic Server, and <port> is the port number that WebLogic Server listens for requests (7001 by default).
2.
In the Change Center of the Administration Console, click Lock & Edit, if you have not already done so.
3.
4.
5.
Change Maximum Threads Constraint at tab of Configuration, if no constraint is configured, click New to create one.
6.
Configuring Maximum Incoming Connection Requests
Maximum Incoming Connection Requests is mapped into Capacity Constraint at WebLogic Server. To configure Capacity Constraint, do the following steps:
1.
Launch Oracle WebLogic Server Administration Console using the following URL: http://<hostname>:<port>/console, where <hostname> is the host name of the machine running WebLogic Server, and <port> is the port number that WebLogic Server listens for requests (7001 by default).
2.
In the Change Center of the Administration Console, click Lock & Edit, if you have not already done so.
3.
4.
5.
Change Capacity Constraint at tab of Configuration, if no constraint is configured, click New to create one.
6.
Note:
If you do not see “Lock & Edit” in the Change Center of the Administration Console, WebLogic Server Configuration editing is enabled.
Click Preferences. Uncheck the Automatically Acquire Lock and Activate Changes checkbox, then click Save.
For more information, see the Oracle WebLogic Web site.
Starting Up and Shutting Down Oracle TSAM Plus Manager
If you chose the bundled WebLogic Server and the bundled Derby database during installation, startup/shutdown script files for both are installed in the Oracle TSAM Plus bin folder.
If you only choose the bundled WebLogic Server, the installed startup/shutdown script only deals with WebLogic Server. If you only choose the bundled Derby database, startup derby/shutdown derby script files are installed in the Oracle TSAM Plus bin folder.
Bundled WebLogic Server Start Up/Shut Down
If you run Oracle TSAM Plus Manager with the bundled WebLogic Server (with or without the Bundled Derby database), use the following steps to start and shut down Oracle TSAM Plus Manager:
1.
Unix/Linux:
a.
b.
Windows:
a.
b.
2.
Unix/Linux:
a.
b.
Windows:
a.
b.
Bundled Derby Database Start Up/Shut Down
If you run Oracle TSAM Plus Manager with the bundled Derby database (without the bundled WebLogic Server), use the following steps to start and shut down Derby:
Note:
1.
Unix/Linux:
a.
b.
Windows:
a.
b.
2.
Unix/Linux:
a.
b.
Windows:
a.
b.
Oracle TSAM Plus High Availability and Scalability
Oracle TSAM Plus High Availability
You can configure two TSAM Plus managers for one TSAM Plus agent. The first one is a master. When the master manager is not available, TSAM Plus agent tries to connect the second one as a backup.
Figure 2 Oracle TSAM Plus High Availablility
TSAM Plus Manager Scalability
Oracle TSAM Plus manager is responsible for doing following tasks simultaneously:
For an enterprise that has a large number of Oracle Tuxedo applications, it requires TSAM Plus Manager to handle huge amounts of data and requests. Multiple TSAM Plus Manager instances can be configured to achieve the high throughput and low latency requirements.
As shown in Figure 3, there are three Oracle TSAM Plus managers configured in one Oracle TSAM Plus system, in which manager 1 and 2 are configured as data servers, and manager 3 is configured as a TSAM Plus console.
Figure 3 Oracle TSAM Plus Manager Scalability
Oracle TSAM Plus Migration
This section contains the following topics:
Oracle TSAM 1.1/10gR3 Alert Migration
Oracle TSAM Plus Manager 12cR2 can import Oracle TSAM 1.1/10gR3 alert definition items or event trigger rule files and convert them to Oracle TSAM Plus 12c format. To make these conversions, you must do the following steps:
Oracle TSAM 1.1/10gR3 Alert Definition Items Migration
1.
2.
3.
Listing 3‑1 AlertMigration.sh (Unix/Linux only)/cmd (Windows only)
-srcdbtype SRCDBTYPE -srcdbhostname SRCDBHOSTNAME -srcdbport SRCDBPORT -srcdbdbname SRCDBNAME -srcdbuser SRCDBUSER -srcdbpassword SRCDBPASSWORD -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
 
Oracle TSAM 1.1/10gR3 Rules File Migration
1. Make sure your Oracle TSAM Plus 12c database servers are running.
2. cd <TSAM12c_DIR>/deploy
3. Run the commands shown in Listing 3‑2.
Listing 3‑2 AlertMigration.sh (Unix/Linux only)/cmd (Windows only)
-srcfile SRCFILE -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
 
AlertMigration.sh Parameters
Table 3‑1 lists AlertMigration.sh/cmd parameters.
 
Note:
If the specified database uses OS authentication, the user name (parameter srcdbuser or dstdbuser) and password (parameter srcdbpassword or dstdbpassword) should be null.
Oracle TSAM 1.1/10gR3 Policy Migration
TSAM 1.1/10gR3 policy files can be imported in the Oracle TSAM Plus 12cR2 (12.1.3) policy management page. For more information, see Tuxedo Monitoring Policy in the Oracle TSAM Plus Users Guide.
Oracle TSAM Plus 12.1.3.0.0 Database Migration
The TSAM Plus 12.1.3.0.0 Oracle database can be reused by TSAM Plus 12.2.2.0.0 after the database is upgraded. The Oracle TSAM Plus 12.1.3.0.0 database is different from the Oracle TSAM Plus 12.2.2.0.0 database. You must run three database migration scripts before reusing it.
You must do the following steps:
1.
2.
Run the scripts under <TSAM12c_DIR>/deploy
Take using Oracle SQLPlus as an example, the steps of running the script are as follows:
Enter the directory <TSAM12c_DIR>/deploy.
SQL > @TSAMUpgradeOracle.sql
SQL > @TSAM_PACKAGE.sql
Notes: 
See Also

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.