Deploying 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.

Important

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.

To Deploy an Instance

The AM-7.1.4.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.1.4.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.

    Note

    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.

    Important

    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. Navigate to the initial configuration screen. For example, https://openam.example.com:8443/openam.

    Initial AM configuration screen

    AM is now ready for installation.

  3. Proceed to configuring external data stores using the files created during deployment. See Preparing External Stores.

Read a different version of :