During the installation of Elvis 6 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 Elvis Server on a system, changing the server configuration, and starting the server.
For full details about this process, see Installing Elvis 6 Server > Installing additional nodes.
To restart or not to restart Elvis Server?
A common question that is asked is whether or not Elvis 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 Elvis Server when needed.
Changing the properties for the cluster
During the installation of Elvis 6 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, Elvis 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.
The steps to follow depend on the version of Elvis that is used.
Steps for Elvis 6.16 or higher
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 Elvis page.
Step 3. Restart Elvis Server when needed.
Steps for Elvis 6.15 or lower
Accessing the configuration page
Step 1. Access the Admin pages by doing one of the following:
- Enter the following URL:
http://<yourserver>:<port>/admin
Example: http://localhost:80/admin
- On the Elvis Server console, click Server admin page.
Step 2. Click Change config in the menu bar.
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 by clicking List config properties at the top of the page under 'Config properties'.
Checking the currently set properties
To see the properties that are currently set for the cluster, click any of the links in the 'Choose a file' section. This will open that particular file for editing.
Figure: The content of the cluster-config.properties.txt file, showing the properties set for that file for the whole cluster.
Editing a property
Editing a property is done by directly editing the configuration file.
Step 1. In the Choose config file section, click any of the links to open the file.
The page for changing the file properties appears.
Step 2. Add or change a property with its value and click Save changes.
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 Elvis page.
Step 3. Restart Elvis Server when needed.
Document history
- 22 July 2022: Added section 'Adding additional nodes'.
Comments
Do you have corrections or additional information about this article? Leave a comment! Do you have a question about what is described in this article? Please contact Support.
0 comments
Please sign in to leave a comment.