Share this page

# Deploy WAR files on PPM server

You can deploy your custom WAR files on the PPM server.

In this topic:

## Before you deploy custom WAR files

Understand the following before you deploy custom WAR files.

- We recommend you read the instructions on how to authenticate with PPM and perform security checks from custom WAR files. You can find theses instructions in the index.jsp file in the PPM sample custom WAR.

- It is not supported to modify PPM database, or call PPM Java APIs from the custom WAR code. To interact with PPM, use the supported REST or SOAP APIs.

## Deploy WAR files on PPM server

Follow the steps below to deploy your custom WAR files on the PPM server.

To deploy custom WAR files on the PPM server:

1. Create a WAR file. PPM provides a sample WAR file for your reference, see PPM sample custom WAR.

2. Copy the WAR file to the <PPM_HOME>/server/_common/deploy directory.

3. Add your WAR file name (without the `.war` extension) to the CUSTOM_WARS parameter. For details, see the CUSTOM_WARS parameter in the Server parameters.

4. Stop the PPM server.

5. Run the `kUpdateHtml.sh` script to update the server.xml file. For details about the `kUpdateHtml.sh` script, see kUpdateHtml.sh.

6. Restart the PPM server. The WAR file is deployed in PPM. To access your WAR file, replace itg in the base URL with the WAR file name (without the `.war` extension). For example, https://<web_server><server_port>/my-custom-war/.

https://admhelp.microfocus.com PPM 8942
Tips to improve your search results... OpenText™ Project and Portfolio Management Help Center PPM Help 26.2-26.3 All View Local Help Center View Online Help Center Version: