Provisioning the Software

This topic contains the following sections:

•	Install Tuxedo and ART (GA)

•	Apply Tuxedo and ART Rolling Patches (RPs)

•	Install ART Test Manager Agents

This function is accessed from the main ART Test Manager menu in the top right corner of the window. It is used to facilitate installing and updating Tuxedo, ART Runtimes and ART Test Manager Agents on one or more test machines concurrently. If the test machines already have Tuxedo and ART for CICS, IMS, or Batch installed, these don’t need to be installed again. If the installations don’t have current rolling patches (RPs) applied, this function can be used to apply them remotely. However, the only mandatory action is the provisioning of ART Test Manager Agents, which is required once per test environment before any testing can be run through the ART Test Manager.

In the Provisioning dialog, the target machine can be added by specifying its host name and ssh port along with user name and password. Click “Test SSH Connection” button to verify the connectivity and the validity of the credentials, then click “Add” button. Once required machines have been added, each will appear under its own tab as shown in the figure below. Under the machine tab, three functional tabs are available: GA Installation for provisioning the required software, RP installation for applying rolling patches, and Agent Installation for the mandatory installation of ART Test Manager agent.

Install Tuxedo and ART (GA)

To install Tuxedo and ART, click “GA Installation” tab, then fill in the required information and click “Install GA” button. The input parameters required on the form are:

•	Java Home: Absolute path of JDK 1.7 or later

•	Oracle Home: Installation path

•	Oracle Home Name: An alias of Oracle Home, default value is the directory name of Oracle Home

•	COBOL Compiler Type: If choosing “COBOL-IT”, specify the COBOL-IT install path. If choosing “Micro Focus COBOL”, compiler installation path is not required.

•	Location of Tuxedo installer package on local machine or remote machine. It will be uploaded to the ART Test Manager and transferred to the target machine.

•	Location of ART (runtimes for CICS, IMS, and Batch) installer package on local machine or remote machine. It will be uploaded to the ART Test Manager and transferred to the target machine.

During the installation, progress indicator will appear. After the installation is finished, the results will appear.

Tip:	Do not refresh the browser during the installation. If the connection to the ART Test Manager is over WiFi, the upload and installation process may take longer.

After the installation, click “Show GA Installation” to the right of the Oracle Home Name input field to check if ART Test Manager can find them.

Apply Tuxedo and ART Rolling Patches (RPs)

Between releases, Oracle provides patches and minor enhancements in update packages called Rolling Patches (RPs). Click the “RP Installation” tab and select one or more RP installer packages for Tuxedo and/or ART, then click “Install RP”. Based on the Oracle Home location specified in the GA Installation tab, ART Test Manager will locate currently installed versions and run Oracle Opatch tool to apply the RP packages.

During the installation, progress indicator will appear. After the installation is finished, the results will appear.

If any RP installation fails, click “Failed Installation” red link to check the details.

Click “Show RP Installation” button to review the RP installation history as shown in the figure below.

Install ART Test Manager Agents

ART Test Manager provides agents for each of the three Tuxedo Application runtimes: CICS, IMS, and Batch. These agents run as Tuxedo servers the corresponding domain and provide information back to the ART Test Manager about the running transactions, programs, and jobs. They need to be installed before you can start Tuxedo domains from the ART Test Manager and run test cases.

To install the agents, in the Provisioning view click “Agent Installation” tab. For each runtime the form provides input field to specify its location, usually in a runtime-specific subdirectory under the common deploy location. To check if the agents are installed, click “Show Agent Installation” button to the right of each input filed. If they are not installed, after filling in the locations of the three runtimes, click “Install Agent” button in the lower right corner. The progress window shows agent installation in process for each runtime and final status.

After installation click “Show Agent Installation” button to confirm the installation.

After installing the agents, when starting relevant Tuxedo domains, the console window shows all Tuxedo servers being started. Check to make sure that the servers containing ART Test Manager’s agents start normally. These servers in CICS, IMS, and Batch domains are called ARTCICSAGENT, ARTIMSAGENT, and ARTJESAGENT respectively.

The information provided by these agents is designed to cover the basic view of what’s executing in each domain directly within the ART Test Manager user interface. More extensive monitoring options are available in Tuxedo Systems and Application Monitor Plus (TSAM Plus), and in the case of Batch runtime in ARTISPF panels available in Tuxedo ART Batch as extensions to uni-SPF.