Installing Oracle TSAM Plus Using Console-Mode Installation

Installing Oracle TSAM Plus Using Console-Mode Installation

The following sections describe how to install Oracle TSAM Plus using console-mode installation:

•

What Is Console-Mode Installation?

•

Installing on UNIX Platforms in Console Mode

•

Uninstalling Oracle TSAM Plus on UNIX Platforms in Console Mode

What Is Console-Mode Installation?

Console-mode installation is the text-based method of executing the Oracle Installation program. It can be run only on UNIX systems and is intended for UNIX systems with non-graphical consoles. Console-mode installation offers the same capabilities as graphics-based installation.

Installing on UNIX Platforms in Console Mode

Perform the following steps to install Oracle TSAM Plus Manager and Agent software in console mode on a certified UNIX platform:

1.

Execute the installation program in character-based mode by selecting the appropriate installation file for your platform.

# sh <installer_name> -i console

This command launches the installation script, which displays the following message:

Preparing to install...
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

2.

Press the Enter key to continue. If you are installing Oracle TSAM Plus 12c Release 1 (12.1.1.1), the following message is displayed:

=======================================================================

Introduction
------------

InstallAnywhere will guide you through the installation of
TSAM Plus 12.1.1.1 for Tuxedo <VERSION>.

It is strongly recommended that you quit all programs before continuing with this installation.

Respond to each prompt to proceed to the next step in the installation. If you want to change something on a previous step, type 'back'.

You may cancel this installation by typing 'quit'.

=======================================================================

3.

The next screen prompts you to choose the Oracle TSAM Plus 12c Release 1 (12.1.1.1) install set.

===============================================================

Choose Install Set
------------------

Please Choose the Install Set to be installed by this installer.
->1- Full

2- TSAM Plus Agent

3- TSAM Plus Manager

ENTER THE NUMBER FOR THE INSTALL SET OR PRESS <ENTER> TO ACCEPT THE DEFAULT (Full Install):

4.

Oracle Home directory.

Choose an Oracle Home

-------------------------

1- Choose existing Oracle Home directory

2- Specify Oracle Home directory

If you select 2, then you must specify an Oracle Home directory. The path of this directory must be an absolute existing path name with write permission, otherwise the following message is displayed:

Error: The specified directory doesn't exist or is not writable.

Note:

If Oracle TSAM Plus Agent is selected, all the supported Tuxedo versions under Oracle Home are listed. Make sure the Tuxedo version you are going to select has been installed in the Oracle Home directory. The registry.xml file under the Oracle Home is checked. If the default Oracle Home folder does not contain this file, option 1 is not displayed. The following message is displayed: Error: Oracle Tuxedo is not found in the specified directory.

If this file exists, the installer can verify the Oracle Tuxedo version, Oracle Tuxedo components list and the Oracle Tuxedo installation directory. If the Oracle Tuxedo version is not supported, the following message is displayed: Error: Registered Oracle Tuxedo version 12.1.1.0 is not found in the specified directory.

If the selected Oracle Tuxedo install set is not "Full" or "Server", the following message is displayed: Error: Registered Oracle Tuxedo version does not have server component installed.

If the Oracle Tuxedo installation directory does not exist, the following message is displayed: Error: Registered Oracle Tuxedo install directory is not found.

If the Oracle Tuxedo installation directory is not writable, the following message is displayed: Error: Registered Oracle Tuxedo install directory is not writable.

If one or more supported tuxedo directories are installed under the selected Oracle Home, Tuxedo directory must be selected:

Choose Tuxedo directory

-------------------------------------------------

->1- /apps/OracleHomes/tuxedo12.1.1.0

-------------------------------------------------

Enter a number: 1

If a previous installation is detected, the Overwrite screen appears.

-------------------------------------------------

Overwrite feature?

The following TSAM Plus 12.1.1.1 feature is found under

/apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0

...

Do you want to overwrite it?

1- No

2- Yes

-------------------------------------------------

You can choose whether overwrite it or not.

If the backup configuration files are found in the chosen installation folder, the following message appears:

---------------------------------------------------------------------

TSAM Plus configuration files are found under

/apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0, do you want to import them? No/Yes

---------------------------------------------------------------------

If the three configuration files are from TSAM Plus 12c Release 1 (12.1.1.1), choose Yes, otherwise, choose No.

5.

Modify or change the default Oracle TSAM Plus Manager installation folder.

=======================================================================

Choose Install Folder

------------------------

Where would you like to install?

Default Install Folder: /apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

=======================================================================

6.

Choose authentication type

If you choose Full or TSAM Plus Manager install set, the Choose Authentication Type screen appears.

=======================================================================

Choose Authentication Type

--------------------------

User information can be stored in the Oracle TSAM Plus database or an existing LDAP server.

The authentication type "Local first" supports both.

"LDAP only" exclusively supports LDAP authentication.

     ->1- Local first

       2- LDAP only

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:

=======================================================================

If you choose "Local first", the installer prompts:

--------------------------

Do you want to specify an LDAP configuration file now?

    ->1- No

       2- Yes

If you choose "No", you can specify the LDAP configuration file by running the LDAP deployment utility LDAPDeployer after installation.

Note:

If you choose "No" in this process, there is no LDAP configuration file deployed. You must deploy an LDAP configuration file after installation manually by using the LDAP deployment utility (LDAPDeployer.sh or LDAPDeployer.cmd) if you want to enable the LDAP authentication. For more information, see Deploying Oracle TSAM Plus Manager in the Oracle TSAM Plus Deployment Guide.

If you choose "LDAP only" as the authentication type or "Yes", you must input the path of the LDAP configuration file.

--------------------------

Enter an existing LDAP configuration file:

7.

Specify Database Type

If you choose Full or TSAM Plus Manager install set, the Choose Database Type screen appears.

Choose the TSAM Manager database type you want to install:

-------------------------

1- Bundled Derby database

2- An existing Derby database

3- An existing Oracle database

4- Skip, I will deploy TSAM Plus to an existing database server after the installation

Existing Derby or Oracle databases are expected to be set up and running before Oracle TSAM Plus manager installation. For bundled Derby, if you deploy Oracle TSAM Plus manager to an existing WebLogic server, the bundled Derby database still runs after installation. Otherwise (if the application server is Tomcat), the bundled Derby database shuts down.

Note:

If you select 4, TSAM Plus database will not be created during installation. You must add a TSAM Plus database after installation manually by using the database deployment utility (DatabaseDeployer.sh or DatabaseDeployer.cmd). For more information, see Deploying Oracle TSAM Plus Manager in the Oracle TSAM Plus Deployment Guide.

8.

Specify the database connection.

If you choose connect to an existing Derby or Oracle database, the Specify Database Connection screen appears.

•

Specify the host name:

•

Specify the port:

•

Specify the database name:

•

Specify user name:

•

Specify the password:

If the specified database uses OS authentication, the user name and password should be null.

If the specified database cannot be connected, an error message is displayed and you should specify the database connection again.

If a previous database installation is detected, the installer prompts:

Overwrite existing TSAM Manager Database?

------------------------

TSAM Manager Database is found under "XXX".

Do you want to overwrite it?

->1- No

2- Yes

Choose "yes" to overwrite it, or "no" to leave it untouched.

Note:

If you choose the bundled Derby database, the existing database is directly overwritten.

9.

If you choose to create a new database, Oracle TSAM Plus 12.1.1.1 creates a user with the name "admin". You are prompted to specify and verify the password accordingly.

Enter the administrator group ID (DEFAULT: 0):

Enter the viewer group ID (DEFAULT: 1):

Oracle TSAM Plus 12.1.1.1 will create a user with the name "admin". Specify its password: Verify password:

10.

If install mode "Full" or "TSAM Plus Manager" is selected, you are prompted to choose an application server.

Choose an application server

------------------------

1- Bundled Tomcat Server

2- An existing Tomcat Server

3- An existing WebLogic server

4- Skip, I will deploy TSAM 12c to an existing application server after the installation

If 1 is selected, Oracle TSAM Plus startup/shutdown script/ and the Oracle TSAM Plus Manager war package is copied to Install Directory.

If 2 is selected, you are prompted to specify an existing Tomcat folder. Enter an existing Tomcat folder.

If 3 is selected, you are prompted to specify an existing WebLogic Server directory.

Oracle WebLogic Server directory seletion

------------------------

1- Choose an existing WebLogic Server directory

2- Specify an existing WebLogic Server directory

Note:

For 1, 2 or 3, the Oracle TSAM Plus Manager .war package is also deployed to the specified application server.

Note:

If you select 4, Oracle TSAM Plus Manager will not be deployed during installation. You must deploy it to an existing application server (WebLogic or Tomcat) after installation manually by using the application server utility (AppServerDeployer.sh or AppServerDeployer.cmd). For more information, see Deploying Oracle TSAM Plus Manager in the Oracle TSAM Plus Deployment Guide.

11.

If you choose deploy to an existing Weblogic Server, you are required to input the following WebLogic Server connection parameters.

•

Enter Oracle WebLogic admin url:

•

Enter Oracle WebLogic user name:

•

Enter Oracle WebLogic password:

The existing WebLogic Server is expected to be located on the local installation machine. Remote existing Weblogic Servers are not supported.

The operator must has the execution permission to the Weblogic Server installation directory.

12.

Set TSAM Plus properties: you can set TSAM Plus properties in the install process or select default and use the default properties value.

===============================================================================

Set TSAM Plus Properties

-------------------

Please reset the following TSAM properties, or use the default.

Default Value:

SVC_TOPN=2

ENABLE_ART=TRUE

QUERY_TIMEOUT=30

MAX_PERSISTENCE_THREADS_NUM=2

MAX_INQUEUE_RUNNER_NUM=5000

BUSY_THRESHOLD=500

QUEUE_FULL_SLEEP_INTERVAL=500

TIMEOUT_SHUTDOWN=30

CALLPATTERN_DELAY_MINUTES=1

CALLPATTERN_THREAD_NUM=2

CALLPATTERN_QUEUE_SIZE=1000000

CALLPATTERN_BATCH_THREAD_NUM=2

CALLPATTERN_BATCH_NUM=100

CALLPATTERN_BATCH_RUN_TIME=00-00-00

CALLPATTERN_BATCH_RUN_INTERVAL_MINUTES=1440

LOG_LEVEL=INFO

->1- Default

2- Reset

13.

Review the pre-installation summary information. The pre-installation summary includes the following details:

Pre-Installation Summary

------------------------

Please Review the Following Before Continuing:

Product Name:

TSAM Plus 12.1.1.1 for Tuxedo 12.1.1.0

Install Folder:

/apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0

Database host name

localhost

Database port

1527

Database name

TSAM

Database user name

administrator group ID

     0

viewer group ID

     1

Application server type

bundled Tomcat server

Application server folder

/apps/OracleHomes/bea/tsam12.1.1.1_fortux12.1.1.0/apache-tomcat

Disk Space Information (for Installation Target):

Required: 71,850,401 bytes

Available: 19,094,890,496 bytes

PRESS <ENTER> TO CONTINUE:

14.

Review the information and press Enter to start the installation. Once the installation is complete, the following message is displayed:

Installation Complete

---------------------

Congratulations. TSAM Plus 12.1.1.1 for Tuxedo 12.1.1.0 has been successfully installed to:

/apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0

PRESS <ENTER> TO EXIT THE INSTALLER:

Uninstalling Oracle TSAM Plus on UNIX Platforms in Console Mode

To uninstall Oracle TSAM Plus on a UNIX platform:

1.

Change to your uninstall directory using the following command:

> cd /apps/OracleHomes/tsam12.1.1.1_fortux12.1.1.0/uninstall/

2.

Start the uninstallation program with the following command:

./uninstall

Listing 3‑1 displays an Oracle TSAM Plus Oracle uninstallation.

Listing 3‑1 UNIX Uninstallation Example

Uninstall TSAM Plus 12.1.1.1 for Tuxedo 12.1.1.0
----------------
About to uninstall...
TSAM Plus 12.1.1.1 for Tuxedo 12.1.1.0
This will remove features installed by InstallAnywhere. It will not remove files and folders created after the installation.
PRESS <ENTER> TO CONTINUE:
ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:
       ->1- Completely remove all features and components.
       2- Choose specific features that were installed by InstallAnywhere.
Please choose one of the following options:
Choose Product Features
-----------------------
ENTER A COMMA_SEPARATED LIST OF NUMBERS REPRESENTING THE FEATURES YOU WOULD
LIKE TO SELECT, OR DESELECT. TO VIEW A FEATURE'S DESCRIPTION, ENTER
'?<NUMBER>'. PRESS <RETURN> WHEN YOU ARE DONE:

              1- [X] TSAM Plus Agent
              2- [X] TSAM Plus Manager

Uncheck the features that you want to uninstall. Checked features will remain installed.

3.

When the uninstall program is finished, the Uninstall Complete screen appears.

Uninstall Complete
------------------

All items were successfully uninstalled.

See Also

•

Oracle TSAM Plus Deployment Guide