|
This chapter contains the following sections:
The Local Monitor Server (LMS) is an Oracle Tuxedo system server provided by the Oracle TSAM Agent.
To properly deploy the Oracle TSAM Agent, you must add the LMS to each Oracle Tuxedo machine section of the UBBCONFIG file. Listing 1 shows an example of how to add the LMS to the UBBCONFIG file.
...
*MACHINES
MACHINEA
...
*GROUPS
...
LMSGRP LMID=MACHINEA
...
*SERVERS
LMS SRVGRP=LMSGRP SRVID=1 MINDISPATCHTHREADS=1 MAXDISPATCHTHREADS=5 CLOPT=”-A -- -l tsamweb.abc.com:8080/tsam”
...
LMS is multi-threaded so that you can configure the service dispatching thread number based on the Oracle Tuxedo application work load. The “-l” option specifies the Oracle TSAM Data Server address which is configured in the Oracle TSAM Manager. For more information, see the
Oracle TSAM Reference Guide. The Oracle TSAM Data Server uses the same port number as the Oracle TSAM Manager Console.
| Note: | LMS can also be added to a running Oracle Tuxedo application using TMIB. |
This section contains the following topics:
The Oracle TSAM 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 Manager, it must be deployed to a database server and a Web application container.
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 Manager is deployed on the specified database server automatically; otherwise, you must deploy Oracle TSAM Manager to a database server using the "Database Deployment Utility".
If you select "Bundled Tomcat server", "An existing Tomcat server" or "An existing WebLogic server" during installation, Oracle TSAM Manager is deployed on the specified application server automatically; otherwise you must deploy Oracle TSAM Manager to an application server using the "Application Server Deployment Utility" or manually.
The LDAP deployment updates the LDAP configuration information in the tsam.ear file (located at < TSAM_DIR >/deploy).
Oracle TSAM provides the following LDAP Deployment utilities:
Listing 2 and Listing 3 show UNIX and Windows LDAP Deployment utility examples accordingly.
| Note: | The LDAP information in the tsam.ear file is overwritten after you run the LDAP Deployment utility. You must redeploy the tsam.ear file on the application server. |
For more LDAP configuration file information, see the Oracle TSAM Installation Guide.
cd < TSAM_DIR >/deploy
./LDAPDeployer.sh tpgauth
cd < TSAM_DIR >\deploy
LDAPDeployer.cmd c:\tpgauth
If you choose to deploy Oracle TSAM 11gR1 to an existing database server after installation, you must add an Oracle TSAM database after installation using the database deployment utilities.
Oracle TSAM provides the following database deployment utilities:
The database deployment utilize do the following:
- admingid- viewergid-adminpassword< TSAM_DIR >/deploy)Listing 4 and Listing 5 show UNIX and Windows database deployment utility examples accordingly.
| Note: | The database utility has the following restrictions: |
tsam", and it must be created before you use this utility-overwrite yes", the existing TSAM database is always overwritten and the database connection URL in the tsam.ear file is updated; If you select the parameter "-overwrite no", the database connection URL is updated, but the existing TSAM database is not overwrittentsam.ear file is overwritten after you run the database deployment utility. You must redeploy the tsam.ear file on the application.For more information, see the Oracle TSAM Installation Guide.
./ DatabaseDeployer.sh -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
./ DatabaseDeployer.sh -type oracle -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
DatabaseDeployer.cmd -type derby -hostname localhost -port 1527 -dbname TSAM -user app -password app -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
DatabaseDeployer.cmd -type oracle -hostname localhost -port 1521 -dbname TSAM -user tsam -password tsam -overwrite no -admingid 0 -viewergid 1 -adminpassword admin1
If you choose to deploy Oracle TSAM 11gR1 to an existing application server after installation, you must deploy it to an existing application server (WebLogic or Tomcat) after installation using the application server utilities, or manually.
| Note: | The WebLogic server has the following restrictions: |
| Note: | For more information, see http://www.oracle.com/tools/toplink_adf.html. |
Oracle TSAM provides the following application server deployment utilities:
UNIX Application Server Deployment: AppServerDeployer.sh
Windows Application Server Deployment: AppServerDeployer.cmd
UNIX and Windows application deployment utility examples are shown in Listing 6 and Listing 7 accordingly.
cd < TSAM_DIR >/deploy
./AppServerDeployer.sh -type weblogic -adminurl localhost:7001 -directory /home/oracle/wlserver_10.3 -user weblogic -password weblogic1
cd < TSAM_DIR >/deploy
./AppServerDeployer.sh -type tomcat -directory /home/oracle/apache-tomcat-6.0.24
cd < TSAM_DIR >\deploy
AppServerDeployer.cmd -type weblogic -adminurl localhost:7001 -directory C:\oracle\wlserver_10.3 -user weblogic -password weblogic1
cd < TSAM_DIR >/deploy
AppServerDeployer.sh -type tomcat -directory C:\oracle\apache-tomcat-6.0.24
Oracle TSAM Manager provides deployment scripts for the following application servers:
Execute the commands shown in Listing 8 and Listing 9 for Unix and Windows accordingly to deploy Oracle TSAM on an Apache Tomcat Server.
| Note: | Replace < TSAM_DIR > and < TOMCAT_DIR > with the actual TSAM and TOMCAT paths on your disk. |
TSAMDIR=< TSAM_DIR >; export TSAMDIR
TOMCATDIR=< TOMCAT_DIR >; export TOMCATDIR
JAVA_HOME=$TSAMDIR/jdk; export JAVA_HOME
PATH=$TSAMDIR/jdk/bin:$PATH; export PATH
cd $TSAMDIR/deploy
mkdir tsam
cd tsam
jar xf ../tsam.ear
mkdir tsam
cd tsam
jar xf ../tsam.war
cp ../../adflib/* WEB-INF/lib/
jar cf ../tsam.war *
cd ..
rm -rf $TOMCATDIR/webapps/tsam
rm -rf $TOMCATDIR/webapps/tsamhelp
cp tsam.war $TOMCATDIR/webapps/
cp tsamhelp.war $TOMCATDIR/webapps/
cd ..
cp adflib/* $TOMCATDIR/lib/
rm -rf tsam
set TSAMDIR=< TSAM_DIR >
set TOMCATDIR=< TOMCAT_DIR >
set JAVA_HOME=%TSAMDIR%\jdk
set PATH=%JAVA_HOME%\bin;%PATH%
cd /d %TSAMDIR%\deploy
mkdir tsam
cd tsam
jar xf ..\tsam.ear
mkdir tsam
cd tsam
jar xf ..\tsam.war
copy ..\..\adflib\* WEB-INF\lib\
jar cf ..\tsam.war *
cd ..
rd %TOMCATDIR%\webapps\tsam /s/q
rd %TOMCATDIR%\webapps\tsamhelp /s/q
copy tsam.war %TOMCATDIR%\webapps\
copy tsamhelp.war %TOMCATDIR%\webapps\
cd ..
copy adflib\* %TOMCATDIR%\lib\
rd tsam /s/q
After installing Oracle WebLogic Server, do the following steps to deploy Oracle TSAM:
http://localhost:7001/console.tsam.ear file in the $TSAMDIR/deploy directory.tsam.ear file.At the Settings for TSAM page, you can modify specific settings for TSAM at Configuration - > General. For example, Session Timeout (in seconds).
As needed, you can change the parameters for the following servers:
You can directly run Oracle TSAM Manager without changing any Apache Tomcat configuration parameters.
If required, you can change the default for the following parameters:
Configuration parameters for Apache Tomcat Server are located in the following files:
When installing Oracle TSAM with an existing Tomcat server, the default JVM memory size is not sufficient for Oracle TSAM to run. You can extend the memory by specifying the JAVA_OPTS environment variable value.
For an example, to set the value to -Xms256m, enter -Xmx1024m -XX:PermSize=64M -XX:MaxPermSize=256m
The default Apache Tomcat port number is 8080. You can change the default based on your environment. The port is defined in <TSAM_DIR>/apache-tomcat-6.0.24/conf/server.xml file. For example, you could change to port 9090 by doing the following:
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector port=”9090” acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" redirectPort="8443"/>
The Oracle TSAM Manager console and data server URLs depend on the Apache Tomcat port setting. The following example assumes the default port “8080” used:
The “host” is the full domain name or IP address where the Oracle TSAM Manager is installed. The Oracle TSAM Agent LMS must be set correctly using the Oracle TSAM Manager data server URL.
To configure Session Timeout, do the following steps:
This is the maximum number of HTTP requests that can be pipelined until the connection is closed by the server. Apache Tomcat provides an attribute maxKeepAliveRequests in the <TSAM_DIR>/apache-tomcat-6.0.24/conf/server.xml file for custom control. Setting this attribute to 1 disables HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. Setting this to -1 allows an unlimited pipeline amount or keep-alive HTTP requests. If not specified, this attribute is set to 100.
<Connector port="8080" ... maxKeepAliveRequests="-1"/>
You must configure the maximum size in bytes of the POST, maxPostSize, that is handled by the container FORM URL parameter parsing. The limit can be disabled by setting this attribute to a value less than or equal to 0. If not specified, this attribute is set to 2097152 KB (2 megabytes). maxPostSize is modified in the <TSAM_DIR>/apache-tomcat-6.0.24/conf/server.xml file.
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector maxPostSize="0" acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="150" minSpareThreads="25" port="8080" redirectPort="8443"/>
If Oracle TSAM has huge amount of monitoring data in the database, and maxPostSize is not adequate, an exception message, “javax.servlet.ServletException: Post too large”, is given when any operations fail.
| Note: | It is recommended that maxPostSize is set to 0. |
This is the maximum number of request processing threads created by Apache Tomcat, maxThreads, which determines the maximum number of simultaneous requests that can be handled by Apache Tomcat. If not specified, this attribute is set to 200. maxThreads is modified in the Apache Tomcat server.xml file. Oracle TSAM keeps a thread-level JDBC connection if the thread has database access. When you configure this attribute, you need to consider the DBMS capability.
This is the maximum queue length, acceptCount, for incoming connection requests when all possible request processing threads in Apache Tomcat are in use. Any requests received when the queue is full are refused. The default value is 100. Setting acceptCount to a larger number allows the Apache Tomcat queue to accept more HTTP requests if Apache Tomcat is busy. The acceptCount parameter is modified in the Apache Tomcat server.xml file.
The following is a maxPostSize, maxThreads, acceptCount example:
<!-- Define a non-SSL HTTP/1.1 Connector on port 8080 -->
<Connector maxPostSize="0" acceptCount="1000" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxSpareThreads="75" maxThreads="130" minSpareThreads="25" port="8080" redirectPort="8443"/>
For more information, see the Apache Tomcat Web site.
You can directly run the Oracle TSAM Manager without changing any Oracle WebLogic configuration parameters.
If required, you can change the default for the following parameters:
The default Oracle WebLogic Server Listening port number is 7001. To change the default Listening Port, do the following steps:
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.exampleServer, where Oracle TSAM is deployed.WebLogicSession Timeout configuration is the same as for Tomcat server: For more information, see Configuring Session Timeout for Tomcat.
To enable and disable HTTP KeepAlive, do the following steps:
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).exampleServer, which your TSAM deployed.To set the maximum size in bytes of the POST unlimited, do the following steps:
http://localhost:7001/console.exampleServer, which your TSAM deployed.Maximum Thread Simultaneous Processing is mapped into Maximum Threads Constraint at WebLogic Server. To configure Maximum Threads Constraint, do the following steps:
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).Maximum Incoming Connection Requests is mapped into Capacity Constraint at WebLogic Server. To configure Capacity Constraint, do the following steps:
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).| Note: | If you do not see “Lock & Edit” in the Change Center of the Administration Console, WebLogic Server Configuration editing is enabled. |
| Note: | Click Preferences. Uncheck the Automatically Acquire Lock and Activate Changes checkbox, then click Save. |
For more information, see the Oracle WebLogic Web site.
If you chose the bundled Apache Tomcat Server and the bundled Derby database during installation, startup/shutdown script files for both are installed in the Oracle TSAM bin folder.
If you only choose the bundled Apache Tomcat Server, the installed startup/shutdown script only deals with Apache Tomcat Server. If you only choose the bundled Derby database, startup derby/shutdown derby script files are installed in the Oracle TSAM bin folder.
If you run Oracle TSAM Manager with the bundled Apache Tomcat Server (with or without the Bundled Derby database), use the following steps to start and shut down Oracle TSAM Manager:
If you run Oracle TSAM Manager with the bundled Derby database (without the bundled Apache Tomcat Server), use the following steps to start and shut down Derby:
| Note: | If you do not choose the bundled Apache Tomcat Server, you must set up your JAVA environment (JDK 1.6 or above) and boot up your existing application server manually. |
This section contains the following topics:
Oracle TSAM Manager 11gR1 can import Oracle TSAM 1.1/10gR3 alert definition items or event trigger rule files and convert them to Oracle TSAM 11g format. To make these conversions, you must do the following steps:
cd <TSAM11g_DIR >/deploy-srcdbtype SRCDBTYPE -srcdbhostname SRCDBHOSTNAME -srcdbport SRCDBPORT -srcdbdbname SRCDBNAME -srcdbuser SRCDBUSER -srcdbpassword SRCDBPASSWORD -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
1. Make sure your Oracle TSAM 11g database servers are running.
3. Run the commands shown in Listing 11.
-srcfile SRCFILE -dstdbtype DSTDBTYPE -dstdbhostname DSTDBHOSTNAME -dstdbport DSTDBPORT -dstdbdbname DSTDBNAME -dstdbuser DSTDBUSER -dstdbpassword DSTDBPASSWORD.
Table 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. |
TSAM 1.1/10gR3 policy files can be imported in the Oracle TSAM 11g policy management page. For more information, see Tuxedo Monitoring Policy in the Oracle TSAM 11g Users Guide.
The Oracle TSAM 11gR1(11.1.1.1.0) database is different from the Oracle TSAM 11gR1(11.1.1.2.0) database. You must run a database migration script before reusing it.
You must do the following steps:
cd <TSAM11g_DIR>
JAVA_HOME=<TSAM11g_DIR>/jdk; export JAVA_HOME
DERBY_HOME=<TSAM11g_DIR>/db-derby-10.5.3.0-bin; export DERBY_HOME
$DERBY_HOME/bin/ij
|