Deployment Example: Single Sign-On, Load Balancing and Failover Using Sun OpenSSO Enterprise 8.0

ProcedureTo Deploy the Generated WAR as Distributed Authentication User Interface 1

Before You Begin

This procedure assumes you have completed To Generate the Distributed Authentication User Interface WAR.

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

  2. Switch to the non-root user.


    # su da80adm
    
  3. Change to the directory into which ossodistauth.war will be copied.


    # cd /export/da80adm
    
  4. Copy ossodistauth.war from the osso–1 host machine.


    # ftp osso-1.example.com
    
    Connected to osso-1.example.com
    220 osso-1.example.com FTP server ready.
    
    Name (osso-1.example.com:username):username
    
    Password: password
         ...
    Using binary mode to transfer files
    
    ftp> cd /export/OSSO_BITS/opensso/deployable-war
    
    CWD command successful
    
    ftp> mget ossodistauth.war
    
    mget ossodistauth.war? y
    
    200 PORT command successful
    
    ftp> bye
    
  5. Verify that ossodistauth.war was successfully copied and is owned by the non-root user.


    # ls -al
    
    total 17630
    drwxr-xr-x   3 da80adm  staff        512 Jun 30 15:20 .
    drwxr-xr-x   6 root     sys          512 May 13 11:22 ..
    -rw-r--r--   1 da80adm  staff        144 May 13 11:22 .profile
    drwx------   3 da80adm  staff        512 May 13 14:55 .sunw
    -rw-r--r--   1 da80adm  staff   10017728 Jun 30 15:20 ossodistauth.war
    -rw-r--r--   1 da80adm  staff        136 May 13 11:22 local.cshrc
    -rw-r--r--   1 da80adm  staff        157 May 13 11:22 local.login
    -rw-r--r--   1 da80adm  staff        174 May 13 11:22 local.profile
  6. Start the Web Server Administration Server.


    # cd /opt/SUNWwbsvr/admin-server/bin
    # ./startserv
    
  7. Add the Distributed Authentication User Interface WAR using the wadm command line interface.


    # cd /opt/SUNWwbsvr/bin
    # ./wadm add-webapp --user=admin 
    --host=da-1.example.com --port=8989
    --config=da-1.example.com --vs=da-1.example.com
    --uri=/distAuth
    /export/da80adm/ossodistauth.war
    
    Please enter admin-user-password: web4dmin
    
    Do you trust the above certificate? [y|n] y
    
    CLI201 Command 'add-webapp' ran successfully
  8. Deploy the Distributed Authentication User Interface WAR using the wadm command line interface.


    # ./wadm deploy-config --user=admin 
    --host=da-1.example.com --port=8989
    da-1.example.com
    
    Please enter admin-user-password: web4dmin
    
    CLI201 Command 'deploy-config' ran successfully
  9. Verify that the distAuth web application has been deployed.


    # cd /opt/SUNWwbsvr/https-da-1.example.com/web-app/da-1.example.com
    # ls -al
    
    total 6
    drwxr-xr-x   4 da80adm  staff        512 Jun 30 15:40 .
    drwxr-xr-x   3 da80adm  staff        512 Jun 30 15:40 ..
    drwxr-xr-x   6 da80adm  staff        512 Jun 30 15:40 distAuth
    
  10. Restart the Web Server instance.


    # cd /opt/SUNWwbsvr/https-da-1.example.com/bin
    # ./stopserv; ./startserv
    
    server has been shutdown
    Sun Java System Web Server 7.0U2 B12/09/2008 09:02
    info: CORE5076: Using [Java HotSpot(TM) Server VM, Version 1.5.0_12]
    from [Sun Microsystems Inc.]
    info: WEB0100: Loading web module in virtual server [da-1.example.com]
    at [/distAuth]
    info: HTTP3072: http-listener-1: http://da-1.example.com:1080 ready to
    accept requests
    info: HTTP3072: http-listener-2: https://da-1.example.com:1443 ready to
    accept requests
    info: CORE3274: successful server startup

    The output indicates that the distAuth web application has been successfully loaded.