Why export Rhino?

Administrators and programmers can export a Rhino SLEE’s deployment and configuration state to a set of human-readable text files, which they can then import into another (or the same) Rhino SLEE instance. This is useful for backing up the state of the SLEE, migrating the state of one Rhino SLEE to another Rhino SLEE instance, or migrating the SLEE state between different versions of the Rhino SLEE.

Using rhino-export to backup SLEE state

The rhino-export tool exports the entire current state of the cluster, preserving all management state in a human-readable form, which:

  • is fairly easy to modify or examine

  • consists of an Ant build script and supporting files

  • includes management commands to restore the entire cluster state.

Tip To restore exported SLEE state, reinstall Rhino and use the rhino-import tool with the saved export.

What’s exported?

The exported image records the following state from the SLEE:

  • for each namespace:

    • all deployable units

    • all profile tables

    • all profiles

    • all resource adaptor entities

    • configured trace levels for all components

    • current desired state of all services and resource adaptor entities

  • runtime configuration:

    • external database resources

    • access control roles and permissions

    • logging

    • rate limiter

    • staging queue dimensions

    • object pool dimensions

    • threshold alarms

    • SNMP legacy OID mappings.

Note The exporter uses profile specification references to determine relationships between profiles. It does not recognise undeclared relationships expressed in the profile validation methods. If profile spec X contains a dependency reference to profile spec Y, then any create-profile-table targets for profile tables of X will include a dependency on any create-profile-table targets for any profile tables of Y. If there is no profile specification reference between two profile specifications that have a functional dependency, the exporter will not handle the dependency between the profile tables.

Exported profile data DTD

The format of the exported profile data is defined by the DTD file exported_profile_data_1_1.dtd, which can be found in the doc/dtd/ directory of your Rhino installation.

An administrator can write custom XML scripts, or modify exported profile data, according to the structure defined by this DTD.

The included profile element can be used to create, replace or remove a profile.

Refer to the documentation in exported_profile_data_1_1.dtd for more details.

Warning You should also backup any modified or created files which are not stored in Rhino’s management database (for example, using cron and tar). This applies to modified files under the Rhino installation (such as changes to security permissions or JVM options) and to any important generated output (such as CDR files).
Previous page Next page
Rhino Version 3.2