Deployment Example 1: Access Manager 7.0 Load Balancing, Distributed Authentication UI, and Session Failover

ProcedureTo Build and Deploy Distributed Authentication UI Server 2

  1. Log in as a root user to an Access Manager host.

    For this example, log into AccessManager-2.

  2. Copy the Distributed Authentication UI files to another workspace on the same (local) host.


    cd /opt/SUNWcomm/SUNWam
    cp README.distAuthUI amauthistui.war Makefile.distAuthUI /opt/SUNWam
  3. Edit the Makefile.distAuthUI file and set the following properties:


    JAVA_HOME=/usr/jdk/entsys-j2se/ 
    SERVER_PROTOCOL=http 
    SERVER_HOSTNAME=LoadBalancer-3.example.com 
    SERVER_PORT=90 
    SERVER_DEPLOY_URI=amserver 
    DISTAUTH_PROTOCOL=http 
    DISTAUTH_HOSTNAME=AuthenticationUI-2.example.com 
    DISTAUTH_PORT=1080 
    DISTAUTH_DEPLOY_URI=/distAuth 
    APPLICATION_USERNAME=amadmin 
    APPLICATION_PASSWORD=4m4dmin1 
    NOTIFICATION_URL=http://AuthenticationUI-2.example.com:1080/
    		distAuth/notificationservice 
    DEBUG_LEVEL=message 
    DEBUG_DIR=/tmp/distAuth 
    COOKIE_ENCODE=false 
    DISTAUTH_VERSION=7.0
  4. Create the war file by issuing the following command


    gmake -f Makefile.distAuthUI.war

    This creates a war file named distAuth_deploy.war.

  5. Rename the generated file.


    mv distAuthUI.war distAuth_AccessManager-2.war
  6. Copy distAuth_AccessManager-2.war from the local host where you built the Distributed Authentication UI (AccessManager—2) to the remote host where the Distributed Authentication UI will be deployed (AuthetnicationUI-2).


    # cp distAuth_AccessManager-2.war /net/AuthenticationUI-2/
    tmp/distAuth_ AuthenticationUI-2.war
  7. Deploy the Distributed Authentication UI WAR file.

    On the host AuthenticationUI-2, in the directory where you copied the distAuth_ AuthenticationUI-2.war file, run the wdeploy command using the following form:

    wdeploy deploy -u uri_path -i instance -v vs_id

    [ [-V verboseLevel ]| [-q] ] [-n] [-d directory] war_file

    For example, in this Deployment Example:


    # ./wdeploy deploy -u /distAuth -i https-AuthenticationUI-2.example.com 
    -v https-AuthenticationUI-2.example.com
    -d /opt/SUNWwbsvr/https-AuthenticationUI-2.example.com/webapps/distAuth
    /tmp/distAuth_ AuthenticationUI-2.war
  8. Restart Web Server.


    # cd /opt/SUNWwbserver
    # cd https-AuthenticationUI-2.example.com
    # ./stop; ./start
    server has been shutdown
    # Sun ONE Web Server 6.1SP5 B06/23/2005 18:00
    info: CORE3016: daemon is running as super-user
    info: CORE5076: Using [Java HotSpot(TM) Server VM, 
    Version 1.5.0_04] from [Sun Microsystems Inc.]
    #
    info: WEB0100: Loading web module in virtual server 
    [https-AuthenticationUI-2.example.com] at [/distAuth]
    info: WEB0100: Loading web module in virtual server 
    [https-AuthenticationUI-2.example.com] at [/search]
    info: HTTP3072: [LS ls1] http://AuthenticationUI-2.example.com:8080 
    ready to accept requests
    startup: server started successfully
Next Steps

The web module is loaded in the following directory:

/opt/SUNWwbsvr/https-AuthenticationUI-2.example.com/webapps/distAuth/distAuth