MarkLogic 9 Product Documentation

Administrator's Guide — Chapter 32

Browsing Resource Configurations

To find a resource and view its configuration by browsing:

1. Click on the resource category in the resource list on the left side of the Configuration Manager. The list of resources in the selected category appears. The number to the right of the resource category name indicates how many of that resource are present:

1. Click on the name of a resource to display the configuration:

1. The Configuration Settings page displays the settings for the selected resource. In the right-hand frame, the resources that are related to the resource are also listed. You can click on a related resource to view its configuration.

   For forests with partitions, a Partitions link will be included under related resources.

1. Some of the configuration settings are collapsed into containers. These are identified by an arrow preceding the container name. You can click on the arrow to expand the container to display the details. For example, to view the forest range settings, you click on the arrow next to the Range container, as shown below:

Searching for a Resource

To search for a resource by name, use the search box at the top of the page. As you type, the Configuration Manager suggests matching resources.

1. Click in the search box and begin typing the name of a resource. A dropdown of suggested search matches appears:

   

2. Click on a search suggestion in the dropdown list to bring up that configuration, or click the Search button to display a page of matching resources from which to select.

Exporting a Configuration

Exporting resource configurations saves them to a zip file.You may import these configurations back in to compare, review, and apply updates.

You can only export App Server and Database configurations. You cannot export Host, Forest, or Group configurations. In addition, you cannot export an App Server or Database that has more than 200 characters in its name.

The following procedure describes how to export a configuration.

1. Navigate to the Configuration Manager and select the Export tab.

   

2. Select the App Servers and/or Databases for which you want to export the configurations. You can select all of the Databases and or Servers by checking the category name in the left-hand frame. For example, to select all of the Databases, do the following:

   

   A colored-in check box indicates that some, but not all, of the resources in that category have been selected. You can clear all of the selected resources by clicking on the check box until it's clear.

3. If an App Server makes use of a modules database, an additional check box appears in the Modules column. Check this box to export the modules database along with the App Server configuration.

   You must have the correct roles to export and import a modules database, as described in "Security Considerations".

   

4. After you have selected all of the configurations to be exported, click Export.

A zip file with a name format of package{id}.zip will be downloaded to your browser's download directory. A unique id is produced and added to the name of each exported zip file.

Importing a Configuration

Use the Import feature of the Configuration Manager to upload and apply previously exported configuration packages.

Importing a configuration loads the saved settings into the Configuration Manager. No automatic configuration changes occur. Once you import a configuration (or set of configurations), you may compare the settings with existing configurations and optionally apply configuration changes, as described in "Comparing Imported Configuration with Current Configuration".

The following procedure describes how to import a configuration.

1. Navigate to the Configuration Manager and select the Import tab.

   

2. Click Browse and navigate to the location of the exported zip file.

   

3. A pop-up directory window appears. Double click on the package name and the package appears in the field next to the Browse button.

   

Comparing Imported Configuration with Current Configuration

This section describes how to compare the imported configuration package with your current configuration and determine how the settings are to be applied to your current configuration.

1. After importing a configuration, you can click the Compare button to compare the imported configuration with you current configuration.

   

2. You will see a summary of the differences between your current configuration and the imported configuration. To view details of the differences for a resource, click on the resource, as shown for the Documents database below.

   

   The meaning of the Settings symbols are shown in the legend at the bottom left-hand part of the page.

   

3. The resource Configuration Settings page displays the settings for both the Current and Package configurations and highlights any differences and errors, if present. To view only the differences and errors, select Show Differences & Errors from the pull-down menu. To view only the errors, select Show Errors Only.

1. By default, all of the packaged settings are imported to your current configuration. If you want to keep a setting in your current configuration that conflicts with the packaged configuration, click on the setting's Import box and uncheck to deselect the setting.

1. Some of the configuration settings are collapsed into containers. These are identified by an arrow preceding the container name. You can click on the arrow to expand the container to display the details. For example, to view the differences between the range element index settings, you click on the arrow next to the Range Element Indexes container, as shown below:

1. You can set how the container settings are to be imported into your current configuration. Select the Merge policy if you want to import only additional settings. This policy ensures that only new settings are imported and no settings are removed from your current configuration.

1. If there are settings in your current configuration that are missing from the imported configuration, they are displayed when you select the Replace policy. The Replace policy will remove these settings from your current configuration.