Modifying the Properties of a Global Index Catalog

Global index properties are related to the replication of global index catalogs. The following global index catalog properties are available:

• replication-server: This lists the servers in the replication topology, in the format host:port.

  ---

  Note - This property should not be modified with set-catalog-prop. This property is modified using enable-replication.

  ---

• server-id: Specifies a unique identifier for the global index within the global index catalog replication domain. Each instance within the same global index catalog replication domain must have a different server ID. An instance which is a member of multiple global index catalog replication domains may use the same server ID for each of its global index catalog replication domain configurations.

  Syntax: 1 <= INTEGER <= 65535 or text.

  ---

  Note - This property should not be modified.

  ---

• window-size: Specifies the window size that the instance will use when communicating with replication servers. Default value is 100.

  Syntax: 0 <= INTEGER or text.

• heartbeat-interval: Specifies the heartbeat interval that the instance will use when communicating with replication servers. The instance expects a regular heartbeat from the replication server within the specified interval. If a heartbeat is not received within this interval, the instance closes its connection and connects to another replication server.

  Syntax: 100 ms <= DURATION (ms)

• isolation-policy: Specifies the behavior of the instance if a write operation is attempted on the data within the global index catalog replication domain when none of the configured replication servers are available.

• group-id: The id associated with a specific replicated domain. This value defines the group id of the replicated domain. The replication system will preferably connect and send updates to replicate to a replication server with the same group id as itself.

  Syntax: 1 <= INTEGER <= 127

  ---

  Note - This property should not be modified.

  ---

• auto-sync-at-startup: Specifies the behavior of the instance when an instance is started. If set to true (the default value), the global index catalog will synchronize itself with another instance in the same replication domain if one is already running. If no global index catalog in the replication domain is running, the newly restarted global index catalog will detect as soon as another global index catalog becomes ready, and will synchronize then. If set to false, a gicadm initialize-replication is required at each startup of an instance to ensure that the data of all the global index catalogs in a replication domain is synchronized.

To Modify the Properties of a Global Index Catalog

For a list of the global index catalog properties, see Modifying the Properties of a Global Index Catalog.

• Use the gicadm command with the set-catalog-prop subcommand.

  $ gicadm -h localhost -D "cn=Directory Manager" -p 4444 -w password -X \
  set-catalog-prop --catalogName name \
  --set property:value 

To Modify Multi-Valued Global Index Catalog Properties

For multi-valued global index or global index catalog properties, you can add or remove a value using the --add or --remove options.

For global index catalog, only the property replication-server can be multi-valued.

Note - For multi-valued global index properties, use the set-index-prop subcommand instead.

• To add a value, use the gicadm command with the set-catalog-prop subcommand.

  $ gicadm -h localhost -D "cn=Directory Manager" -p 4444 -w password -X \
  set-catalog-prop --catalogName name \
  --add replication-server:value 

  • To remove a value from a multi-valued property, use the gicadm command with the set-catalog-prop subcommand.

    $ gicadm -h localhost -D "cn=Directory Manager" -p 4444 -w password -X \
    set-catalog-prop --catalogName name \
    --remove replication-server:value \

To Reset Global Index Catalog Properties To the Default Values

If you have modified any of the global index catalog properties and want to reset them to the default values, use the following procedure.

• Use the gicadm command with the set-catalog-prop subcommand.

  $ gicadm -h localhost -D "cn=Directory Manager" -p 4444 -w password -X \
  set-catalog-prop --catalogName name \
  --reset property