Create a Tomcat Directory Structure for the Web Services Component

How to Enable Web Services › How to Configure and Deploy Web Services › Create a Tomcat Directory Structure for the Web Services Component

Create a Tomcat Directory Structure for the Web Services Component

Web Services requires a Tomcat instance that can host Web Services. To create and populate the Tomcat instance a script file is provided. This file is WSTOMCCS located in CSIQJCL. This job creates an Apache Tomcat instance USS directory structure for Web Services using the CA Common Services for z/OS deployed Tomcat directories and the CA Endevor SCM Web Services install directories as input.

This file can be used to model a script to suit your installation needs. The script has three logical steps that enable you to do the following:

Create a Tomcat instance.
Add runtime libraries to the Tomcat instance.
Add Web Services to the Tomcat instance.

Follow these steps:

Modify WSTOMCCS located in CSIQJCL as follows:
1. Follow the directions in WSTOMCCS to edit the following path values.
  Note: For the USS steps to install and run Web Services these path values are needed. These values will be used in a few different files in this process. The first place these values are needed is WSTOMCCS.
  
  JAVA_HOME— Specifies the path location of JRE runtime. For example:
```
   JAVA_HOME=/sysname/sys/java31bt/v7r0m0/usr/lpp/java/J7.0
```
  CCS_TOMCAT_DIR— Specifies the path location of the CA Common Services deployed Tomcat. This path can be part of a file system that is mounted read-only on the system. The default value is:
```
   CCS_TOMCAT_DIR=/sysname/cai/CADeploy/CCS/tpv/tomcat.
```
  If the product needs a specific release of Tomcat you can change /tomcat to /apache-tomcat-v.r.nn where v.r.nn is the specific release.
  
  TARGET_TOMCAT_DIR— Specifies the target directory for the Web Service Tomcat instance. This path must be part of a file system that is mounted read-write on the system. The default value is:
```
   TARGET_TOMCAT_DIR=/sysname/cai/CADeploy/ESCM/tpv/tomcat  
```
  ENDEVOR_SOFTWARE_DIR— Specifies the CA Endevor SCM install path. Change the default to the path that the CA Endevor product has been installed to. This path path must end with /software.
  
  The default value is:
```
   ENDEVOR_SOFTWARE_DIR=/sysname/cai/CASoftware/ESCM/software        
```
2. Follow the directions in WSTOMCCS to do one of the following:
  Note: If this is your first installation of Web Services, do the first bullet.
  - To create a Tomcat instance, install runtime libraries on the Tomcat server, and deploy Web Services to the Tomcat instance— Set the following values:
    – Set the value for TOMCAT to YES.
    
    – Set the value for LIBS to YES.
    
    – Set the value of ENWS to DEPLOY.
  - To update a Tomcat instance, install runtime libraries on the Tomcat server, and deploy Web Services to the Tomcat instance— Set the following values:
    – Set the value for TOMCAT to NO.
    
    – Set the value for LIBS to YES.
    
    – Set the value of ENWS to DEPLOY.
  - To update a Tomcat instance, keep the runtime libraries that are currently added on your Tomcat server, and redeploy existing Web Services in the Tomcat instance— Set the following values:
    – Set the value for TOMCAT to NO.
    
    – Set the value for LIBS to NO.
    
    – Set the value of ENWS to CLEAN DEPLOY.
    
    Choose this option when updating a previously failed deployment.
  Note: When redeploying an existing deployment, the script removes the Web Services directory trees from the Tomcat instance. Then adds the new directory trees to the target Tomcat instance.
  
  Important— If you have an existing Web Services deployment, all customized files should be backed up before proceeding with this job. That would be any cfg files in your Endevor directory or any other files you have placed in the Endevor directory tree.
  
  Important: When you want to run Web Services under a new release of Tomcat, we recommend that you point to a new Tomcat directory path. After the script has run successfully, update the server.xml file in the new Tomcat tree with the port that you use for Web Services.
Run the job.
This job creates all of the directories and files needed to configure and start your Tomcat Server and copies the directory to the instance of Tomcat.