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

ProcedureTo Build and Deploy Distributed Authentication UI Server 1

  1. Log in as a root user to AccessManager-1.

    For this example, log into AccessManager-1.

  2. Copy the Distributed Authentication UI files to another workspace on the AccessManager-1.


    # 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-1.example.com 
    DISTAUTH_PORT=1080 
    DISTAUTH_DEPLOY_URI=/distAuth 
    APPLICATION_USERNAME=amadmin 
    APPLICATION_PASSWORD=4m4dmin1 
    NOTIFICATION_URL=http://AuthenticationUI-1.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


    # /usr/sfw/bin/gmake -f Makefile.distAuthUI  

    This creates a war file named distAuthUI.war .

  5. Rename the generated file.


    # mv distAuthUI.war distAuth_AccessManager-1.war
  6. Copy distAuth_AccessManager-1.war from the local host where you built the Distributed Authentication UI server (AccessManager–1) to the remote host where the Distributed Authentication UI server will be deployed (AuthenticationUI-1).

    In this deployment example, the desintation directory is /tmp.

  7. Log in as a root user to the Authentication UI-1 Web Server.

  8. Start the Authentication UI-1 Web Server.


    # cd /opt/SUNWwbserver
    # #cd https-AuthenticationUI-1.example.com
    # # ./start
    
  9. Deploy the Distributed Authentication UI WAR file.

    On the host AuthenticationUI-1, in the directory where you copied the distAuth_AuthenticationUI-1.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:


    # cd /opt/SUNWwbsvr/bin/https/bin
    # ./wdeploy deploy -u /distAuth -i https-AuthenticationUI-1.example.com 
    -v https-AuthenticationUI-1.example.com
    -d /opt/SUNWwbsvr/https-AuthenticationUI-1.example.com/webapps/distAuth
    /tmp/distAuth_AuthenticationUI-1.war
  10. Restart Web Server.


    # cd /opt/SUNWwbserver
    # cd https-AuthenticationUI-1.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-1.example.com] at [/distAuth]
    info: WEB0100: Loading web module in virtual server 
    [https-AuthenticationUI-1.example.com] at [/search]
    info: HTTP3072: [LS ls1] http://AuthenticationUI-1.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-1.example.com/webapps/distAuth