Operating system-dependent variables and paths

The direction of the slash for directory paths might vary in this documentation. No matter which type of slash you see in the documentation, use the following guidelines for a slash:

• If using Linux®, AIX®, HP-UX, or Solaris operating systems, use a forward slash (/).
• If using Windows® operating systems, use a backslash (\).

The names of environment variables are not always the same in Windows, Linux, HP-UX, AIX or Solaris operating systems. For example, %TEMP% in Windows is equivalent to $tmp in Linux, HP-UX, AIX, and Solaris operating systems.

For environment variables, use the following guidelines:

• If using Linux, HP-UX, AIX, or Solaris operating systems, use $variable.
• If using Windows operating systems, use %variable%.

Resolving directory path variables

This section describes directory path naming conventions used in this guide.

The ITM home directory

Throughout this guide, reference is made to the <ITM_Home> variable, which is the directory location where IBM® Tivoli® Monitoring is installed. These are the default operating system dependent values for this variable:

• For Windows: C:\IBM\ITM\
• For Linux, HP-UX, AIX, and Solaris: /opt/IBM/ITM
• For z/OS UNIX System Services: /CandleHome

  Note: For z/OS operating systems, you specify the value of <ITM_Home> for the HFS CandleHome directory parameter when you are configuring the ITCAM for SOA monitoring agent.

If you installed IBM Tivoli Monitoring in a different directory location, substitute your install path location for <ITM_Home>.

The IBM Tivoli Composite Application Manager for SOA home directory

Throughout the product library, reference is made to the <ITCAM4SOA_Home> variable, which is the directory location where IBM Tivoli Composite Application Manager for SOA monitoring agent is installed in the IBM Tivoli Monitoring environment. These are the default operating system dependent values for this variable:

• For Windows systems: <ITM_Home>\TMAITM6
• For Linux, HP-UX, AIX, and Solaris systems: <ITM_Home>/<platform>/d4
• For z/OS systems: <ITM_Home>

Determining the platform value in directory paths

Throughout this product library, reference is made to the <platform> variable, which is part of the Linux or UNIX® directory path specification for certain files that you need to access, for example:

<ITM_Home>/<platform>/<product>

In this example, the two-character <product> variable is also part of the directory path, and is typically specified as cq, d4, or iw in this guide.

On supported Linux and UNIX operating systems, you can find the value for <platform> with this short procedure:

1. From a command prompt, navigate to the <ITM_Home>/bin directory.
2. Run the following command:

   ./cinfo -d

3. Locate the line for product code <product>, for example:

   cq

   Locate this product code when you are looking up the <platform> value for Tivoli Enterprise Portal Server.

   iw

   Locate this product code when you are looking up the <platform> value for Tivoli Enterprise Portal Server Extension.

   d4

   Locate this product code when you are looking up the <platform> value for the IBM Tivoli Composite Application Manager for SOA monitoring agent.

   The platform designation is found under the Platform column.

The platform designation depends on the operating system, the computer type, and the version of IBM Tivoli Monitoring that is installed. The platform for the d4 product code is typically not the same as for the cq and iw product codes.

The following example shows the output of the cinfo command when ITCAM for SOA version 7.1.1 and IBM Tivoli Monitoring version 6.2.1 are installed on a supported Red Hat Linux operating system on a 32–bit Intel® computer:

"ProdCode","Description","Platform","Version","Release"

"ax","IBM Tivoli Monitoring Shared Libraries","li6263","06210000","100"

"cq","Tivoli Enterprise Portal Server","li6263","06210000","100"

"cw","Tivoli Enterprise Portal Browser Client","li6263","06210000","100"

"d4","ITCAM for SOA","li6243","07110000","100"

"gs","IBM Tivoli GSKit","li6243","07303100","100"

"iw","IBM Tivoli Enterprise Portal Server Extensions","li6263","06101300","100"

"jr","Tivoli Enterprise-supplied JRE","li6263","05050000","100"

"kf","IBM Eclipse Help Server","li6263","06210000","100"

"ms","Tivoli Enterprise Monitoring Server","li6263","06210000","100"

"sh","Tivoli Enterprise Monitoring SOAP Server","li6263","06210000","100"

"ui","Tivoli Enterprise Services User Interface","li6263","06210000","100"

This example shows the following information:

• li6263 is the platform for Tivoli Enterprise Portal Server (product code cq )
• li6243 is the platform for the ITCAM for SOA monitoring agent (product code d4)
• li6263 is the platform for Tivoli Enterprise Portal Server Extensions (product code iw)

[ Top of Page | Previous Page | Next Page | Contents ]