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 WebSphere MQ Tier instance, verify that you have performed the following tasks:

  • Use the Precise Framework Installer to install framework components

Installing a WebSphere MQ Tier instance

This section describes the procedures that are needed to install a WebSphere MQ 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 Editing or removing Tier instances or clusters.

Adding a WebSphere MQ 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, follow steps a-d:
    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 WebSphere MQ Tier property settings

To define WebSphere MQ Tier property settings

  1. From the drop-down menu, select the server where the MQ instance is running. To add a server that is not listed, click Add. For more information, see Adding a new server.

    Select the server upon which you want to install the WebSphere MQ Tier Collector. The server name or IP address appears in the list only if you previously defined it as a Precise server.

  2. From the drop-down menu, select the Queue Manager name.

    This is the Queue Manager that you want the WebSphere MQ Tier Collector to sample. Choose a Queue Manager from the list or type the name of another valid Queue Manager running on the server.

  3. If the "Instance name" textbox is not auto-filled, enter a unique name for the instance.

  4. If the "MQ home folder" textbox is not auto-filled, type the full folder path of the IBM WebSphere MQ software component configuration to be used with this instance or click the browse (...) button to select the full folder path.

    On UNIX, the MQ home folder is usually /var/mqm. On Windows, check the registry path:

    SOFTWARE\IBM\MQSeries\CurrentVersion\WorkPath

  5. If the "MQ lib directory" textbox is not auto-filled, type the full folder path of the library where IBM WebSphere MQ software components keep the API exits or click the browse (...) button to select the full folder path.

    On UNIX, the MQ lib folder is usually /var/mqm/exits. On Windows, check the registry path:

    SOFTWARE\IBM\MQSeries\CurrentVersion\Configuration\ ClientExitPath\ExitsDefaultPath

  6. If you want to define the Measuring Network Time, then perform the procedure described in the next section.
  7. Click Next.

Defining Measuring Network Time in the WebSphere MQ Tier

To define the Measuring Network Time

  1. On the MQ Instance Installation Property Setting dialog box, click Advanced.
  2. Click the Network Monitoring tab.
  3. Select Associate MQ activity with network statistics.
  4. Select or insert ports in the left pane and move them to the right pane
  5. Click OK.

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. Click Mark as done if you have performed the action items yourself. See Post-installation action items for more information.

Post-installation action items

Once the WebSphere MQ Tier Collectors have been installed, the following post-installation task may be required:

Setting the Queue Manager attributes

To set Queue Manager attributes on Windows

  1. Go to Start > Programs > IBM WebSphere MQ and open the MQ Services utility.
  2. Right-click the specific queue manager and select Properties.
  3. On the Exits tab, click Add.
  4. Set the attributes as follows:
    • Name. VeritasI3Agent
    • Function. PSI_EntryPoint
    • Module. <Precise_root>\products\insight\bin\psi_mq_exits.dll
    • [V] Data. %ID%
    • Sequence. 100
    where %ID% is a hexadecimal number, such as 0x 920D212F.
  5. Stop and restart the queue manager.

To set Queue Manager attributes on UNIX

  1. Log in as the mqm user.
  2. Copy all psi_mq_exits* files from the <Precise_root>\products\insight\bin\ folder to the mq lib folder.
  3. Open the qm.ini file of the relevant queue manager, located in the mq home/qmgrs folder, and add the following lines:
         ApiExitLocal: Sequence=100
         Function=PSI_EntryPoint
         Module=mq lib/psi_mq_exitsName=VeritasI3Agent
         Data=%KEY%
    where %KEY% is a hexadecimal number, such as 0x920D212F.
  4. Run the following command to stop the queue manager:
    endmqm queue manager name
  5. Run the following command to restart the queue manager:
    strmqm queue manager name


IDERA Website | Products | Buy | Support | Community | About Us | Resources | Legal

  • No labels