This section includes the following topics:

Pre-installation tasks

Most of the screens for this installation require you to input details regarding your information systems. Before performing this installation, compile a list of all required user inputs based on the screen names and tables below. Each table (in the sections below) lists the options per screen.

Before installing a Tuxedo Tier instance, verify that you have performed the following tasks:

  • Use the Precise Framework Installer to install framework components

Installing a Tuxedo Tier instance

This section describes the procedures that are needed to install a Tuxedo Tier instance. You have the option of adding a new instance, as well as adding a new application. For information on editing or removing an existing instance, see the Editing or removing tier instances or clusters.

Adding a Tuxedo Tier instance

On the AdminPoint Instances screen, you can add a new Tier instance.

Before adding a Tier instance, create a list of all required inputs based on the screen information below.

To add a Tier instance

  1. From StartPoint, click the AdminPoint tab.
  2. Click the Setup tab.
  3. From the drop-down menu, select Instances & Clusters.
  4. Click the All instances tree item
  5. At the bottom of the Display Instances & Clusters screen, click Add Instance. An Add New Instance dialog box appears.
  6. Select the required technology from the list.
  7. Select the application from the list. If the desired application is not on the list, use the following steps:
    1. Click Add.
    2. In the Application Name field, type in the new application name.
    3. On the Application System field, select the system application from the list.

    4. Click OK.

      To install an instance in an application, you must have ADMINISTRATE.INSTALL permission for the application in which you want to install the instance. If you only have permission for a specific technology, you will only be able to install in an application that is either empty, or is comprised of only the same technology.

  8. Select a Tier from the list.

  9. Click OK to view the next screen.

    Always refresh AdminPoint after adding an instance.

Defining Tuxedo property settings

To define Tuxedo property settings

  1. Click the drop-down menu and select the server with the Tuxedo domain. This is the name or IP address of the server where you want to install the Tuxedo Tier Collector. The server name or IP address appears in the list only if you previously defined it as a Precise server. In upgrade mode, the list contains all servers that were installed or upgraded.
  2. Click Add to enter the name of a server not on the list. For more information, see Adding a new server.

  3. Click the drop-down menu and select the auto-detected Tuxedo domain from the list.

    When a Tuxedo domain is detected, other text boxes will be auto-filled. If one of the editable text boxes is edited, the contents of the Detected Tuxedo domain text box will be cleared. On Windows and UNIX, Tuxedo detection is dependent on running processes. In most configurations of HP-UX, Linux, and Solaris 10, detection will be partial and will only return the instance name. This is also the case for AIX and other Solaris versions, if a specific security update is installed.

  4. Enter a unique Tuxedo instance name that will enable you to distinguish between multiple instances. This is the ID of the Tuxedo software component configuration to be used with this instance.

    To obtain the Tuxedo domain ID, look for the BBL process on the server machine; then use the name following the DOM option. Alternatively, look for the UBBCONFIG file (or a file containing UBB in its name); then use the value of the DOMAINID variable in the RESOURCES section. If you are not sure what the Tuxedo domain ID is, you can use the UNIX user name running the BBL process on the server machine, or simply use an arbitrary name. In upgrade mode, this is the name of the Tuxedo domain you want to upgrade. Via the auto-detection mechanism, invalid characters for Precise may appear. This should be changed manually.

  5. Enter the installation home folder of the Tuxedo information system. This is the installation home folder of the Tuxedo information system.

    To obtain the path of the Tuxedo installation folder, log in as the Tuxedo operator and check the value of the TUXDIR application variable. Alternatively, locate the Tuxedo bin folder where the BBL program is located; the Tuxedo installation folder is immediately above it.

  6. Enter the full path of the configuration file of the Tuxedo information system that you plan to monitor. This is the full path of the configuration file of the Tuxedo information system that you plan to monitor.

    The Insight Savvy for Tuxedo uses this file to find the Tuxedo domain's logical name, which it needs to read data out of the domain shared memory. To find the Tuxedo configuration file, log in as the Tuxedo operator and check the value of the TUXCONFIG application variable. This is a binary file. Do not confuse it with the textual UBBCONFIG file. In a PeopleSoft installation, the name of the Tuxedo configuration file is usually PSTUXCFG. This file is located in the PeopleSoft installation folder/appserv/PeopleSoft Domain folder. For example:

    /home/hrprd/hrprd831/appserv/HR_PRD831/PSTUXCFG

  7. Click the drop-down menu and select the Tuxedo version.

    Precise supports Tuxedo 6.5 to 10.3. To obtain the Tuxedo version number, log in as the Tuxedo operator and run the following command: tmadmin -v.

  8. Click Next.

About the AdminPoint Tier installation preview screen

The preview screen signifies that the AdminPoint Tier installer has gathered enough information to begin the installation phase.

The preview screen displays the following details before installation begins:

  • Server name or IP address
  • The name of the monitored server
  • What actions will be performed in their respective order
  • Installation folder (location)
  • Required disk space
  • Currently available disk space

At this screen, you can still change any of the settings displayed. Click Back to change any of the displayed settings. Click Next to continue installation. Click Cancel to stop the installation process.

About the AdminPoint Tier installation progress screen

This screen appears when the AdminPoint Tier installer is actually performing installation. Installation may take several minutes.

The progress screen visually displays the progress of actual installation on selected servers.

About the AdminPoint Tier installation complete screen

This screen appears when the AdminPoint Tier Installer has completed installation of all Tier instances.

If there are no action items, click Finish (it will be the only option available) to complete the instance installation. If there are action items, click Next (it will be the only option available).

About the AdminPoint Tier Action Items screen

After a Tier instance is installed, you must perform post-installation tasks as may be required. Only after completing any post-installation tasks required can you start using the Tier instances you have just installed.

Perform any tasks displayed on this screen.

Click Execute for Precise to perform the action items.

On UNIX, you will need to manually perform the action item with a root-level permission.

Click Mark as done if you have performed the action items yourself. See Post-installation action items for more information.

Post-installation action items

When the Tuxedo Tier Collectors have been installed, post-installation tasks may be required.

  • Run the following commands only if they have not been previously run for other Tuxedo instances on this server and this server is a UNIX server:
    • Log in as root user and run the following commands:
      cd <precise_root>/products/insight/install
      ./tuxedo_root.sh

    • A Tuxedo information system can have one or more Tuxedo servers. On each Tuxedo server, you can have one or more Tuxedo domains. A Tuxedo domain has a logical definition: it is an instance holding common business units and handling client processes. The Tuxedo Tier should be installed for each Tuxedo domain. Therefore, if your Tuxedo information system has more than one domain, you should create a Tuxedo Tier instance for each domain.

      It is recommended to install the Insight Savvy for Tuxedo in each Tuxedo domain. To find out how many Tuxedo domains are running on your Tuxedo server machine, count how many BBL processes are running on this machine. On Windows, look for BBL processes in the Windows Task Manager. On UNIX, run the following command: ps -ef|grep BBL

To perform Tuxedo Tier post-installation tasks

  1. In the Tuxedo Tier - Installation dialog box, click Next.
  2. In the Tuxedo Tier - Post-Installation dialog box, follow the instructions to perform all post-installation tasks.
  3. Click Finish.


IDERA |  Products | Purchase | Support |  Community |  Resources |  About Us  | Legal

Save