Deploy the Distributed Authentication UI server WAR file (amauthdistui.war, or the name you are using for the WAR file, if you changed the name), to one of the following web containers:
Sun Java System Web Server 7
Sun Java System Application Server Enterprise Edition (EE) 8.2
BEA WebLogic Server
IBM WebSphere Application Server
For the supported web container versions, see the Sun Java System Access Manager 7.1 Release Notes.
Before you deploy the WAR file, the web container must be installed and running on the server where you plan to deploy the WAR file.
Login as (or become) superuser (root) on the server where you plan to deploy the WAR file.
Deploy the amauthdistui.war file (or the name you are using for the WAR file, if you changed the name) using either the web container administration console or CLI command.
The following examples use the web container CLI commands. You can also deploy the WAR file using the web container administration console.
Web Server 7
If Web Server 7 is the web container, use the wadm command to deploy the WAR file. For example, on Solaris systems:
# cd /opt/SUNWwbsvr7/bin # ./wadm add-webapp --user=admin --host=dist-auth-server-host --port=dist-auth-port --config=web-server-configuration-name --vs=web-server-virtual-server --uri=/dist-auth-deploy-uri zip_root/amauthdistui.war # ./wadm deploy-config --user=admin --host=dist-auth-server-host --port=dist-auth-port --restart=true web-server-configuration-name
Enter the Web Server 7 administration password when you are prompted.
Application Server EE 8.2
If Application Server EE 8.2 is the web container, first create a password file to be used when you deploy the WAR file. For example: /tmp/pwdfile.
Set the following variable in the password file:
AS_ADMIN_PASSWORD=application-server-admin-password
Then, use the asadmin deploy command to deploy the WAR file. For example, on Solaris systems:
# cd /opt/SUNWappserver/appserver/bin # ./asadmin deploy --user appserver-admin --passwordfile /tmp/pwdfile --port 4849 --contextroot dist-auth-deploy-uri --name dist-auth-deploy-uri --target dist-auth-server-host zip_root/amauthdistui.war
Web Server wadm command: Chapter 9, Deploying Web Applications, in Sun Java System Web Server 7.0 Developer’s Guide to Java Web Applications.
Application Server asadmin deploy command: Deploying an Application in Sun Java System Application Server Enterprise Edition 8.2 Quick Start Guide
BEA WebLogic Server documentation: http://www.bea.com/
IBM WebSphere Application Server documentation: http://www-306.ibm.com/software/webservers/appserv/was/
Issues and workarounds that apply to WebLogic Server or WebSphere Application Server: Sun Java System Access Manager 7.1 Release Notes