Service Registry 3.1 Administration Guide

ProcedureTo Switch From Embedded Mode to Network Server Mode

To switch from embedded mode (the default) to Network Server mode, change the setting of the registry.install.clientDatabase property from false to true, and require database authentication.

After editing the property, recreate the database resources, then stop and restart the Application Server.

  1. Change to the Service Registry install directory:

    cd ServiceRegistry-base/install

  2. Open your copy of the install.properties file in a text editor.

  3. Change the setting of the property registry.install.clientDatabase from false to true.

  4. Change the setting of the registry.install.RequireDatabaseAuthentication property from false to true.

  5. Edit the setting of the registry.install.DatabaseUserID property, if necessary.

    For Network Server mode, this value must be APP.

  6. Edit the setting of the registry.install.DatabasePassword property.

    Any length is valid. The default value is app123.

  7. Save and close the file.

  8. Recreate the database connection pool and its associated resource. To do so, execute the following command (all on one line):

    Ant-base/ant -f build-install.xml Dinstall.properties=props-file appserver.jdbcResource.update

    where props-file is the path name of the copy of install.properties file that you edited in To Configure Service Registry as Root Using Custom Properties After a Configure Later Installation or To Configure Service Registry as a Non-Root User Using Custom Properties After a Configure Later Installation.

  9. Stop and restart the Application Server domain for the Registry. To do so, execute the following command (all on one line):

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

  10. Start the Java DB database. To do so, execute the following command:

    asadmin start-database --dbhome database-directory

    By default, this command places the database and its log file in the current directory. Use the --dbhome option to specify the location of your database (normally, this is RegistryDomain-base/3.0/data/registry/soar).

Next Steps

If the database is running in Network Server mode, you can perform an online backup of the database.

Later, if you want to return to embedded mode, follow the same steps, with the following exceptions: