Change the Server Address or Port Number

Changing the Address of the Acrolinx Core Server

If you have used a symbolic name when installing the Acrolinx core server, this procedure is rarely required. This procedure is more often required if you used an IP address at installation, and the IP address of the server changes.

The core server has two separate endpoints, one for public communication (for example, from Integrations) and one for internal communication (from language and Analytics servers). This allows easier firewalling. You can assign different addresses to each of these endpoints.

If you change the address or port of the core server, make sure you also update the language server and analytics server properties to point to the new location.

To change the public and internal addresses of the core server, follow these steps:

  1. Update the public address of the core server.
    1. Open your overlay of the core server properties file.

      You find the overlay for the core server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\coreserver.properties
    2. Add the following property:

      endpointHost=<SERVER_ADDRESS>

      For example to update the public server address to a symbolic name, add a property that resembles the following example:

      Example:
      endpointHost=example.org
    3. To use a different port than the default port 8031, change the following property to reflect the new port number:

      endpointPort=<PORT_NUMBER>
  2. Update the internal address of the core server.
    1. Open your overlay of the core server properties file.

      You find the overlay for the core server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\coreserver.properties
    2. Add the following property:

      internalEndpointHost=<INTERNAL_SERVER_ADDRESS>

      For example, to update the internal server address to a symbolic name, add a property that resembles the following example:

      Example:
      internalEndpointHost=example-server.acrolinx.com
    3. To use a different port than the default internal port 8032, change the following property to reflect the new port number:

      internalEndpointPort=<INTERNAL_PORT_NUMBER>
  3. Configure each language server to use the new internal core server address.

    1. Open your overlay of the language server properties file .

      You find the overlay for each language server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\ls-<LS_NUMBER>.properties
    2. Add the following property:

      coreServerEndpointUrl=http://<INTERNAL_SERVER_ADDRESS>:<INTERNAL_PORT_NUMBER>/internal

      For example, to update the server address to a symbolic name with the default internal port 8031, add a property that resembles the following example:

      Example:
      coreServerEndpointUrl=http://example-server.acrolinx.com:8032/internal
  4. Configure the analytics server to use the new internal core server address.
    1. Open your overlay of the analytics server properties file .

      You find the overlay for the analytics server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\analyticsserver.properties
    2. Add the following property:

      com.acrolinx.jreport.coreserver.host=<INTERNAL_SERVER_ADDRESS>
      
      

      For example, to update the server address to a symbolic name, add a property that resembles the following example:

      Example:
      com.acrolinx.jreport.coreserver.host=example-server.acrolinx.com
  5. Save your changes and restart all servers.

Changing the Port of an Acrolinx Server

You can change the ports that are used to connect to the core server, the language servers, or the analytics server by editing the relevant properties. You might change the ports if limitations in your network environment prevent Acrolinx from using one or more of the standard preconfigured ports.

The default port for the core server is 8031.

To change the ports of an Acrolinx server, follow these steps:

  1. To update the ports for the core server, edit the core server properties.

    To change a port for a language server only, proceed to the next step.

    1. Open your overlay of the core server properties file.

      You find the overlay for the core server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\coreserver.properties
    2. To change the public port of the core server, edit the following property:

      endpointPort=<PORT_NUMBER>

      For example, to update the core server to use port 81 instead of the default 8031, add the following property:

      Example:
      endpointPort=81
    3. To change the internal port of the core server, edit the following property:

      internalEndpointPort=<INTERNAL_PORT_NUMBER> 

      For example, to update the core server to use internal port 82 instead of the default 8032, add the following property:

      Example:
      internalEndpointPort=82


  2. Edit the language server properties.
    1. Open your overlay of the language server properties file .

      You find the overlay for each language server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\ls-<LS_NUMBER>.properties
    2. If you have changed the internal port for the core server, you'll need to update the following property:

      coreServerEndpointUrl=http://<INTERNAL_SERVER_ADDRESS>:<INTERNAL_PORT_NUMBER>/internal

      For example, if you changed the core server to use port 81, add a property that resembles the following example:

      Example:
      coreServerEndpointUrl=http://example-server.acrolinx.com:82/internal
    3. To update the port for a language server only, add the following property:

      endpointPort=<LANGUAGE_PORT_NUMBER>

      For example, to update the language server to use port 8038, add the following property:

      endpointPort=8038
  3. Edit the analytics server properties.

    1. Open your overlay of the analytics server properties file .

      You find the overlay for the analytics server properties file in the following location:

      %ACROLINX_CONFIGURATION_ROOT%\server\bin\analyticsserver.properties
    2. If you have changed the internal port for the core server, you'll need to update the following property:

      com.acrolinx.jreport.coreserver.port=<INTERNAL_PORT_NUMBER>

      For example, if you changed the core server to use port 82, add a property that resembles the following example:

      Example:
      com.acrolinx.jreport.coreserver.port=82
  4. Save your changes and restart all servers.