Operations

addClusterNode

Parameters
  • nodeURI: String - A string holding the full URI of the RDF4J end point of the new node, e.g., http://192.0.2.1:7200/repositories/worker

  • remoteNotificationsPort: int - The port number used for emitting remote notifications (this can be left blank if it is not required, see remote notifications.)

  • readable: boolean - If set to false (the default is true), this worker node will receive only updates and will not participate in sharing the cluster query load.

Description

Adds a new worker node to the cluster. If the node is a duplicate of an existing one, no error is logged. The same will also happen if the node pointed by the argument is not available.

Interface method

public void addClusterNode(String nodeURI);

addSyncPeer

Parameters
Description

Adds a new peer master to the cluster.

Interface method

public void addSyncPeer(String id, String url);

backup

Parameters

backupDirectory : String - The full path to a directory on the master node where a backup image will be stored

Description

Initiates a backup from a healthy, in-syncworker node to the given directory on the master node.

Interface method

public void backup(String backupDirectory);

incrementalBackup

Parameters
  • sourceBackup : String - The full path to an existing directory on the master node where the source backup image is stored.

  • targetBackup : String - The full path to a directory on the master node where a backup image will be stored,

  • rebuildImage : Boolean - the default is true. If true a new backup image will be created in targetBackup folder. If false only the differences will be stored.

Description

Initiates an incrementalBackup from a healthy, in-syncworker node to the given directory on the master node.

Interface method

public void incrementalBackup(String sourceBackup, String targetBackup, Boolean rebuildImage);

changeSystemTransactionPassword

Parameters
  • oldPassword : String - The old password.

  • newPassword : String - The new password.

  • newPasswordRetype : String - The new password repeated.

Description

Changes the system transaction password. System transactions include a statement with a special predicate that instructs GraphDB to allow modifications to the imported, read-only schemas/ontologies. The replication cluster introduces a password for such transactions and this must appear in the object position of the ‘special’ statement, e.g.:

_:b1 <http://www.ontotext.com/owlim/system#schemaTransaction> "the_password"

This operation is used for setting/changing the password.

Interface method

public void changeSystemTransactionPassword(String oldPassword, String newPassword, String newPasswordRetype);

log

Parameters

message: String - Message text.

Description

Logs an INFO level message with the given text in the cluster agent’s log.

Interface method

public void log(String message)

removeClusterNode

Parameters

nodeURI : String - A string holding the full URI of the RDF4J end point of the node to be removed.

Description

Removes a node from the cluster. Invoking this operation will neither generate an exception, nor will log an error message.

Interface method

public void removeClusterNode(String message);

removeSyncPeer

Parameters

id: String - The ID of the peer master, e.g., “master2”.

Description

Removes the peer master from the cluster.

Interface method

public void removeSyncPeer(String id);

restoreFromImage

Parameters

backupDirectory : String - The full path to a directory on the master node where a backup image will be restored from.

Description

Initiates a restore from the given directory on the master node. The image will be replicated to each worker node in turn.

Interface method

public void restoreFromImage(String backupDirectory);