IBM Tivoli Composite Application Manager Agents for WebSphere Applications Version 7.2, for J2EE Version 7.1.1, for HTTP Servers Version 7.1

Creating a configuration directory

After installing ITCAM for WebSphere® Application Server, create an ITCAM configuration home directory using the createcfg.sh script. This directory will be used by the configuration utility. The default path for this directory is: /u/itcam72. This directory is referred to as config_home.

The configuration directory is required for configuring the ITCAM for WebSphere Application Server to monitor single or multiple application server instances. Optionally, you can also create an additional configuration directory for a different environment or LPAR.

A Java™ SDK 1.5 or higher defined ( JAVA_HOME defined and in the PATH variable) is required for the user running the utility.

We recommend running the createcfg.sh utility using a WebSphere administrator user ID. If you are running createcfg.sh as a root user or a user ID with root privileges, you can specify file and directory ownership. Configuration options for createcfg.sh are available here: Createfg.sh Options.

The directory under which createcfg.sh utility will create the configuration directory should be owned by a WebSphere Application Server group.

Complete the following steps to create a configuration directory:

Determine the name and location of the configuration directory, for example: /u/itcam72/CONFIG.
Note: We recommend that you create a distinct installation and configuration home directory.
Launch createcfg.sh from the installation directory, for example:
```
cd /u/itcam72/WebSphere/DC/bin
./createcfg.sh 
```

The launch page is displayed, for example:

------------------------------------------------------------------------
-         Create Configuration for z/OS Data Collector                 -
-                                                                      -
-  ITCAM Data Collector for WebSphere Create Configuration Utility     -
-                                                                      -
-  Create the configuration home directories for ITCAM for AD.         -
-  At each prompt,enter 'q' to quit the utility or '?' for help.       -
------------------------------------------------------------------------
        
You only need to run this script once. 
 All Data Collectors can share the same configuration home.

        Sun  May 20 16:39:06 EDT 2012  

        uid=2403(B8ADMIN) gid=2500(B8CFG) groups=1400(ITGROUP)
 
For the installation directory path you should enter 
 the logical path (symbolic link) instead of the physical path 
 (canonical path name). Doing this will provide flexibility 
 for cloning and service migration.

The following message is displayed:
```
Enter installation directory path:  [default is: /u/itcam72/WebSphere/DC]:
```
Enter the installation path, for example: /install/ITCAM

The following message is displayed:

Enter directory name in which to create the ITCAM configuration root: 
[default is: /u/itcam72]:

Enter the configuration home.

The following message is displayed:

You may set a new owner for the configuration 
 home files and directories. 
 
 The owner may be entered as 'user' or 'user:group'. 
 An owner of 'none' will bypass setting the owner. 
 **IMPORTANT** Root access is required to change owner. 


Enter owner for the configuration home:  [default is: none]:

Enter ownership if userid has root capability.

The following message is displayed:

You may set permissions for the configuration 
 home files and directories. 
 
 Permissions are entered in chmod format, which may be either 
 numeric, like 664, or symbolic, like: 'a+rX,u+w,g+w,o-w' 
 Permissions specified as 'none' will bypass setting permissions. 


Enter permissions for the configuration home:  [default is: none]:

The owner and permissions must be such that the WebSphere application servant region user ID may create and update files in the config_home directories.

The following message is displayed:

Summary of chosen configuration parameters

ITCAM will create an ITCAM for Application Diagnostics configuration home 
with the following parameters:

   1)   SMP/E install path : /u/itcam72/WebSphere/DC 

   2)     Config home path : /u/itcam72/CONFIG 

   3)    Owner will remain : [B8ADMIN:B8CFG] 

   4)       Access will be : 775 


Type 'a' to accept, and continue to build the configuration home, - or -
 type 'r' to respecify, or -
 type 'q' to quit:

Enter a to continue.

Verify the configuration home directory was created successfully, observe the following structure:

Feedback