Deploying an Access Manager 7.1 WAR File With Application Server 9.1

To Deploy the Access Manager 7.1 WAR File With Application Server 9.1

Before You Begin

• You must have downloaded and unzipped the Access Manager 7.1 ZIP file, as described in Downloading the Access Manager 7.1 WAR File.

• Application Server 9.1 must be installed and running on the host server.

• To execute the asadmin deploy command or login to the Application Server 9.1 Administration Console, you must know the administrator password for the domain.

1. If necessary, create a staging directory for the WAR file. For example:

   # mkdir opt/AccessManagerWAR

   Create a staging directory for these situations:

   • You downloaded and unzipped the Access Manager 7.1 ZIP file on a server other than the server where you plan to deploy Access Manager 7.1

   • You want to customize Access Manager 7.1

2. If you created a staging directory in Step 1, copy the amserver.war file to that directory.

   Important: For Application Server 9.1. copy the amserver.war file from the zip_root/applications/jdk15 directory.

3. If you want to customize Access Manager:

   1. Explode the amserver.war file in the staging area. For example:

      # cd opt/AccessManagerWAR
      # jar -xvf amserver.war

   2. Modify the exploded files as required for your deployment.

      For example, the files that you can customize include web.xml and related XML files, Java Server Pages (.jsp files), images (.gif files), and style sheets (.css files).

      For more information, see Chapter 10, Updating and Redeploying Access Manager WAR Files, in Sun Java System Access Manager 7.1 Developer’s Guide.

   3. Recreate a new amserver.war file. For example:

      # cd opt/AccessManagerWAR
      # jar -cvf amserver.war *

4. Deploy the amserver.war file using either the Application Server 9.1 Administration Console or the asadmin deploy command.

   For example, the following asadmin deploy command deploys the amserver.war file on a Solaris system:

   # cd opt/SUNWappserver/appserver/bin
   # ./asadmin deploy --user admin --port 4848 
   --passwordfile /tmp/pwdfile /opt/AccessManagerWAR/amserver.war

   where:

   /opt/AccessManagerWAR is the directory where the amserver.war file exists.

   /tmp/pwdfile is a password file that contains the administrator password in ASCII text format:

   AS_ADMIN_PASSWORD=password
   

   For more information, see the deploy command in the Sun Java System Application Server 9.1 Reference Manual. For example, to deploy the WAR file to a different server instance or to a cluster, also include the --target option in the command.

   For information about the Application Server 9.1 Administration Console, see Chapter 3, Deploying an Application, in the Sun Java System Application Server 9.1 Quick Start Guide.

Next Steps

Continue with the Access Manager 7.1 configuration in the following sections.