Restart Server

Overview

There are a number of situations which might require you to restart a Matillion ETL instance. Typically, a restart will be needed after you have made some change to the server configuration, for example:

• Adding a third-party JDBC driver – If you update the Matillion ETL configuration to use a JDBC driver not supplied as standard, you will need to restart the Matillion ETL instance for the new configuration to come into effect.
• Applying a licence – You will need to apply a new licence key to Matillion ETL when your existing licence expires, or if you wish to change any of the instance limits built into the software. On applying a new licence key, Matillion ETL must be restarted to gain access to the expected features.
• Configuring OpenID – Matillion ETL supports OpenID login credentials from a number of different OpenID service providers. After configuring Matillion ETL to use OpenID, a restart is required for the change to take effect.

When any configuration change calls for a restart of the Matillion ETL instance, or when you need to manually restart Matillion ETL for any other reason, follow the restart procedure in this document.

The following processes require the Matillion ETL instance to be restarted from a command line:

• Configuring a high-availability cluster – When you configure multiple Matillion ETL instances to operate as a high-availability (HA) cluster in Azure, each instance in the cluster will need to be restarted from a command line.
• Setting up an external connection to a Matillion ETL database – In order to set up an external connection to a Matillion ETL database, the Matillion ETL instance will need to be restarted from a command line.
• Recreating self-signed SSL certificates – After recreating the self-signed SSL certificates supplied with Matillion ETL, the Matillion ETL instance must be restarted from the command line.
• Adding a certificate chain file for SSL configuration – When you configure your Matillion ETL instance to recognize a certificate chain file, the Matillion ETL instance must be restarted from the command line.
• Performing in-place updates – When performing a manual update of Matillion ETL via SSH, a restart from the command line is required. When performing an in-client update, the instance will restart automatically.
• Configuring SSL protocols – When changing SSL protocol configuration, such as disabling TLS1 and/or TLS1.1, a restart from the command line is required.

In these cases, the required restart commands will be given in the documentation for the procedure you are following.

Using Restart Server in Matillion ETL

1. In Matillion ETL, on the top-right of the screen, click Admin and select Restart Server from the menu.

2. Click Yes when prompted for confirmation of the restart.

3. The server will take several seconds to restart, during which time you will see a Connection lost message. Don't be alarmed by this message: it means that the restart is progressing as expected.

4. When the restart has completed, your browser will offer a dialog asking if you want to reload the site. Click Reload.