Backup  Locate

The Setup tool provides backup and restore capabilities through the following options:

Backup functionality allows you to save the Oracle Service Registry data and configuration to a filesystem directory. Later the backup data can be used for full restore of Oracle Service Registry data and configuration.

What data is backed up?  Locate

When you use the Setup tool to perform an Oracle Service Registry backup, the following data is included in the backup:

  • All registry data stored in the database (Except explicitly denied entities specified in REGISTRY_HOME/app/uddi/conf/migrationXY.xml which normally covers system entities and demo data. XY denotes the internal version number.).

  • Configuration files.

  • Oracle Service Registry libraries and JSP files.

In addition, consider backing up application server-specific data as described in Oracle Service Registry Backup Recommendations

[Important]Important

The Oracle Service Registry server must be shut down before you start backup or restore operations.

Restoration is additive. It does not delete entities that are already present in Oracle Service Registry and not present in the data source. If you need to restore and do not want to retain any current data, you must clean the database which can be done via: drop schema, create schema during setup. For details, see Database Installation

Oracle Service Registry Backup Recommendations  Locate

This section describes application server-specific backup considerations.

Oracle Service Registry Backup and Oracle WebLogic Server  Locate

Ideally, the following static and runtime artifacts within the Oracle WebLogic Server directory structure should be backed up on a periodic basis.

Static artifacts include:

  • BEA_HOME directories (excluding USER_PROJECTS directories) in the Admin Server and all the Managed Servers.

  • WLS product home (by default, it resides in BEA_HOME but it can be configured by the user to point to a different location) in Admin Server and all the Managed Servers.

Runtime artifacts include:

  • USER_PROJECTS directory in all the servers (by default, it resides in BEA_HOME, but it can be configured by the user to point to a different location).

  • Application artifacts (EAR and WAR files) which reside outside of the domain directory on each of the servers (in case of nostage or external_stage application staging modes).

  • Persistent Stores (by default, it resides in USER_PROJECTS, but it can be configured by the user to point to a different location).

Backup Oracle Service Registry  Locate

To back up Oracle Service Registry data:

  1. Stop the Oracle Service Registry instance.

    The Oracle Service Registry instance must be stopped when running Setup tool in the Backup mode. If the Oracle Service Registry is running during backup, the Setup tool returns errors indicating various XML files could not be updated.

  2. Use the Setup tool and choose Backup. To run the Setup tool, execute the following script from the bin subdirectory of your installation:

    Windows: setup.bat
    UNIX: ./setup.sh

    For more information, see command-line parameters in Setup.

    Figure 48. Setup Tool - Select Backup

    Setup Tool - Select Backup
  3. Select whether you want to use a Oracle Service Registry that is deployed (second choice) or not (first choice).

  4. Specify the location of the backup directory. You can check which items you wish to back up as shown in Figure 49.

    Item description.

    1. Backup data makes a backup of UDDI data such as different kinds of entities and taxonomies.

    2. Backup configuration files makes a backup of configuration files from REGISTRY_HOME/app/uddi/conf and REGISTRY_HOME/work/uddi/bsc.jar/conf.

    3. Backup configuration from Database makes a backup of configuration files and their history as they are stored in the database. See Configurations in Database in the Administration Guide.

    4. Backup libraries makes a backup of bsc.jar and web.jar from both app and work directories. These files and directories contain UI customizations and modifications.

    Figure 49. Setup Tool - Backup

    Setup Tool - Backup

Restore Oracle Service Registry  Locate

[Important]Important

The restore operation adds data or replaces data in the database. Data in database which are not in the backup are left untouched. We recommend to restore into newly created database.

To restore registry data and configuration from a backup:

  1. Use the Setup tool and choose Restore. To run the Setup tool, execute the following script from the bin subdirectory of your installation:

    Windows: setup.bat
    UNIX: ./setup.sh

    See command-line parameters in Setup.

    Figure 50. Setup Tool - Select Restore

    Setup Tool - Select Restore
  2. Specify the location of backup directory and check the items you wish to restore.

    Figure 51. Setup Tool - Restore from Backup

    Setup Tool - Restore from Backup
  3. Restore any application-server specific backup files. For more information, see Oracle Service Registry Backup Recommendations .