PingAM 7.5.1

Deploy AM

After you have downloaded AM software, deploy it to your installed application container.

Deploying AM only extracts the files into the application container, prior to installation and configuration. Deploying AM also makes LDIF files available, which can be used to prepare external data stores for use with AM.

After deploying AM, but before installation, your application container serves AM’s installer (or upgrader, if performing an upgrade) user interfaces.

We recommend that any external network access to the application container is suspended until the install, or upgrade, is complete. When complete, AM prevents access to the installer, or upgrader UI itself.

The AM-7.5.1.war file contains the AM server. How you deploy the .war file depends on your web application container.

  1. Deploy the .war file on your container.

    For example, copy the file to deploy on Apache Tomcat.

    $ cp AM-7.5.1.war /path/to/tomcat/webapps/openam.war

    In development or demonstration deployments, change the WAR file name to openam.war when deploying in Tomcat, so that the deployment URI is /openam.

    • Change the file name to something other than openam.war when deploying so that the deployment URI is not /openam. In a production environment, your deployment URI should not disclose the kind of software it is hosting.

    • AM requires a deployment URI with a non-empty string after /. Do not deploy AM in the root context. Do not rename the .war file to ROOT.war before deploying on Tomcat, for example.

    It can take several seconds for AM to be deployed in your container.

  2. Go to the initial configuration screen. For example, https://openam.example.com:8443/openam.

    The initial configuration screen lets you choose a default or custom configuration path.

    AM is now ready for installation.

  3. Proceed to configuring external data stores using the files created during deployment. See Prepare external stores.