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

ProcedureTo Configure the WAR for Distributed Authentication User Interface 2

This procedure configures the amauthdistui.war that will be used for deployment in To Deploy the Distributed Authentication User Interface 2 WAR.

  1. As a root user, log in to the AuthenticationUI–2 host machine.

  2. Switch to the non-root user.


    # su da71adm
    
  3. Change to the directory into which you will copy amDistAuth.zip.


    # cd /export/da71adm
    

    amDistAuth.zip contains the files you need to install the Distributed Authentication User Interface. It is included in the Access Manager software downloaded in 6.2 Deploying and Configuring Access Manager 1 and Access Manager 2.

  4. Copy amDistAuth.zip from the AccessManager–1 host machine.


    # cd /export/da71adm
    # ftp AccessManager-1.example.com
    
    Connected to AccessManager-1.example.com
    220 AccessManager-1.example.com FTP server ready.
    Name (AccessManager-1.example.com:username):username
    Password: ********
    ...
    Using binary mode to transfer files
    ftp> cd /export/AM71/applications
    CWD command successful
    ftp> mget amDistAuth.zip?
    mget amDistAuth.zip? y
    200 PORT command successful
    ftp> bye
    
  5. List the contents of /export/da71adm to verify that amDistAuth.zip was transferred and is owned by the non-root user.


    # ls -al
    
    total 26496
    drwxr-xr-x   5 da71adm  staff        512 Jul 19 20:59 .
    drwxr-xr-x   7 root     sys          512 Jul 20 10:13 ..
    -rw-r--r--   1 da71adm  staff        144 Jul 19 19:53 .profile
    drwx------   3 da71adm  staff        512 Jul 19 20:41 .sunw
    -rw-r--r--   1 da71adm  staff    6747654 Jul 19 20:43 amDistAuth.zip
    
  6. Unzip amDistAuth.zip.


    # unzip amDistAuth.zip
    
  7. List the contents again to verify the unzip.


    # ls -al
    
    total 26496
    drwxr-xr-x   5 da71adm  staff        512 Jul 19 20:59 .
    drwxr-xr-x   7 root     sys          512 Jul 20 10:13 ..
    -rw-r--r--   1 da71adm  staff        144 Jul 19 19:53 .profile
    drwx------   3 da71adm  staff        512 Jul 19 20:41 .sunw
    -rw-r--r--   1 da71adm  staff        572 Jul 19 20:59 .wadmtruststore
    -rw-r--r--   1 da71adm  staff    6772566 Jul 19 20:56 amauthdistui.war
    -rw-r--r--   1 da71adm  staff    6747654 Jul 19 20:43 amDistAuth.zip
    drwxr-xr-x   2 da71adm  staff        512 Jul 19 20:52 lib
    -rw-r--r--   1 da71adm  staff        136 Jul 19 19:53 local.cshrc
    -rw-r--r--   1 da71adm  staff        157 Jul 19 19:53 local.login
    -rw-r--r--   1 da71adm  staff        174 Jul 19 19:53 local.profile
    -rw-r--r--   1 da71adm  staff      10038 Mar 19 15:33 README.distAuthUI
    -rw-r--r--   1 da71adm  staff       1865 Mar 19 15:31 setup.bat
    -rw-r--r--   1 da71adm  staff       1865 Mar 19 15:31 setup.sh
    drwxr-xr-x   3 da71adm  staff        512 Jun 25 20:13 WEB-INF
  8. Change permissions on setup.sh, the Distributed Authentication User Interface configuration script.


    # chmod +x setup.sh
    

    This gives the non-root user permission to run the script that configures the Distributed Authentication User Interface WAR for its deployment.

  9. Run setup.sh.


    # ./setup.sh
    

    Caution – Caution –

    If using a shell other than sh, you must modify the setup script before running it.

    1. Open setup.sh in a text editor.

    2. Add #!/bin/sh as the first line of the file.

    3. Save and close the file.

    4. Run the script.


  10. Provide the following information.


    Debug directory (make sure this
    directory exists):

    Enter /tmp/distAuth


    Application username:

    Enter authuiadmin


    Application password:

    Enter 4uthu14dmin


    Protocol of the server:

    Enter http


    Host name of the server:

    Enter LoadBalancer-3.example.com


    Port of the server:

    Enter 7070


    Server's deploymen URI:

    Enter amserver


    Naming URL (hit enter to accept default 
    value, http://LoadBalancer-3.example.com:7070/
    amserver/namingservice)

    Press Enter to accept the default value. 


    Protocol of the distauth server:

    Enter http


    Host name of the distauth server:

    Enter AuthenticationUI-2.example.com


    Port of the distaut server:

    Enter 1080


    Distauth Server's deployment URI:

    Enter distAuth


    Notification URL (hit enter to accept default 
    value, http://AuthenticationUI-2.example.com:1080/
    distAuth/notificationservice)

    Press Enter to accept the default value. 

    After running the script, amauthdistui.war is updated with the above values. The next step is To Deploy the Distributed Authentication User Interface 2 WAR.