Changing the Assets Server configuration for a running cluster

During the installation of Assets Server, basic configuration settings were made. Once the cluster is up and running, additional properties can be configured to further unlock functionality and features. As was the case during the installation, configuration can be done for each specific node and for the cluster itself.

This article describes how to do both.

Adding additional nodes

Adding additional nodes to a running cluster is done by installing Assets Server on a system, changing the server configuration, and starting the server.

For full details about this process, see Installing Assets Server > Installing additional nodes.

To restart or not to restart Assets Server?

A common question that is asked is whether or not Assets Server should be restarted after making changes to the configuration files.

The answer is that it depends on which property is changed. Information about whether a restart is required or not can be found in the comments for each property in the configuration files (see Looking up the available properties below).

Changing the properties for a specific node

Step 1. Open the following file on one of the nodes in the cluster:

Elvis Server/Config/node-config.properties.txt

Step 2. Change any of the properties as explained in the comments of the file.

Step 3. Save and close the file.

Step 4. Restart Assets Server when needed.

Changing the properties for the cluster

During the installation of Assets Server the cluster properties were configured by manually modifying the cluster-config.properties.txt file.

Once the cluster is up and running though, changing the cluster properties should be done through the administration page on one of the nodes. After saving the changes, Assets Server will automatically distribute the changes across all other nodes.

Important: Modifying the cluster-config.properties.txt file on a node in a running cluster by manually opening it from the Elvis Server/Config folder should not be done; this can result in nodes with different cluster properties which can lead to unpredictable behavior.

Accessing the configuration page

Access the Management Console and in the menu on the left, choose Server configuration > Files.

Looking up the available properties

An overview of the available properties, their description and whether or not changing them requires a cluster restart can be found in Server configuration > Cluster properties.

Checking the currently set properties

To see the properties that are currently set for the cluster, access Server configuration > Files and click on a file in the list to inspect its content.

Editing a property

Step 1. Do one of the following:

• For configuring the cluster-config.properties.txt file:

• Use Server configuration > Files > the cluster-config.properties.txt to configure any properties that are already set.
• Use Server configuration > Cluster properties to configure any properties that are already set or properties that are not yet set.

• For all configuration files: Use Server configuration > Files and choose the file that you want to edit.

Tip: For files with a lot of content it might be handy to copy the content to your favorite text editor such as TextWrangler or Notepad++ so that you can easily read and edit the configuration settings. When finished editing, paste the content back into the Assets Server page.

Step 3. Restart Assets Server when needed.