Service Registry 3.1 Update 1 Administration Guide

Configuring Service Registry with Application Server 9.1

The version of Application Server in Java ES 5 Update 1 is 8.2. It is possible, however, to install Service Registry on Application Server 9.1.

ProcedureTo Configure Service Registry with Application Server 9.1

  1. If an Application Server 8.2 domain for the Registry is running, stop the domain:

    1. Change to the Service Registry install directory.


      cd ServiceRegistry-base/install
      
    2. Run the following command:


      Ant-base/ant -f build-install.xml -Dinstall.properties=props-file appserver.domain.stop
      
  2. Install Application Server 9.1 in a location of your choice.

  3. Deploy Service Registry on Application Server 9.1:


    Ant-base/ant -f build-install.xml -Dinstall.properties=props-file appserver.deploy.as9
    
  4. Run the Application Server upgrade utility. Use the following command (Appserver-base is the location where you installed Application Server 9.1):


    Appserver-base/bin/asupgrade
    

    For the Source Domain Directory, specify RegistryDomain-base/domains/registry. For example, on a Linux system you would specify /var/opt/sun/srvc-registry/domains/registry.

    For the Target Domains Root Directory, specify RegistryDomain-base without registry. For example, on Linux you would specify /var/opt/sun/srvc-registry/domains/. The upgraded domain will also be named registry.


    Note –

    This step instructs you to create an Application Server 9.1 domain for the Registry in the same location as the previous domain (the term for this is an in-place upgrade). If you specify a different location for the Target Domains Root Directory (the term for this is a side-by-side upgrade), you must perform the task To Create a New Certificate Realm after you complete the current task.


  5. Start the Application Server domain for the Registry.


    Ant-base/ant -f build-install.xml -Dinstall.properties=props-file appserver.domain.start
    
Next Steps

If you performed a side-by-side upgrade instead of an in-place upgrade, as described in Step 4, you must now perform the task To Create a New Certificate Realm.

For the Application Server 9.1 documentation, go to http://docs.sun.com/coll/1343.4.

ProcedureTo Create a New Certificate Realm

  1. Change to the Appserver-base/bin directory.

  2. Run the following command to remove any existing certificate realm (there should not be one):


    ./asadmin delete-auth-realm --host localhost --port 6489 certificate
    
  3. Run the following command (all on one line) to create a new certificate realm:


    ./asadmin create-auth-realm --terse=false --echo=true --interactive=true --user admin 
    --host localhost --port 6489 
    --classname com.sun.enterprise.security.auth.realm.certificate.CertificateRealm 
    --property assign-groups=have.client.cert certificate
    
  4. Stop and restart the Application Server domain, as described in To Stop and Restart the Application Server Domain for the Registry.