Create a Tomcat Directory Structure for the Web Services Component

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 Axis2/Java 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/v6r0m0/usr/lpp/java/J6.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 Axis2/Java 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 Axis2 to YES.
    
    – Set the value of ENWS to DEPLOY.
  - To update a Tomcat instance, install Axis2/Java 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 Axis2 to YES.
    
    – Set the value of ENWS to DEPLOY.
  - To update a Tomcat instance, keep the Axis2/Java software that is currently installed on your 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 Axis2 to NO.
    
    – Set the value of ENWS to DEPLOY.
  When updating an existing deployment, the script removes the Web Services directory trees from the Tomcat/Axis2 instance. Then adds the new directory tress to the target Tomcat/Axis2 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 or Axis2, 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.
Verify your Axis2 installation and the success of WSTOMCCS, as follows:
- Check that there is no STDERR output.
- Review STDOUT for any messages that indicate a problem.
- Verify that you now have the following directories in the /tpv/tomcat/webapps/axis2 directory of your CA Endevor SCM Web Services installation:
  - axis2-web
  - org
  - META-INF
  - WEB-INF
If the modules do not exist in the expected directory, review the job outputs for error messages.

If the directories exist in the axis2 directory, the job ran successfully.