Skip to main content

Home

Custom ports

You can configure Unravel to use custom ports instead of the default ports. This configuration can be set from the Unravel manager tool. Run the manager help config ports command to view the help for config ports. In a multi-cluster environment, you can configure custom ports for both core node as well as an edge node.

Warning

If you set custom ports for ElasticSearch or Datastore, some Report features will not function.

To configure custom ports, do the following:

  1. Stop Unravel.

    <Unravel installation directory>/unravel/manager stop
  2. Display the list of ports and keys

    <Unravel installation directory>/unravel/manager config ports show
  3. Set the port using the following command with the port and port key.

    <Unravel installation directory>/unravel/manager config ports set <port key> <port>

    For example, if you run the following command, NGUI listens on port 1234.

    <Unravel installation directory>/unravel/manager config ports set /hosts/host_main/instances/ngui_1/config/port 1234

    Note

    • Run manager config ports unset <port key> command to return the ports to their default values.

      <Unravel installation directory>/unravel/manager config ports unset /hosts/host_main/instances/appstore_1/config/flask/port
    • Run manager config ports remap to remap all the ports within a range.

      <Unravel installation directory>/unravel/manager config ports remap begin<specify start range> end<specify end range>

      For example, if you run the following command all the ports get remapped between 5000 and 6000

      <Unravel installation directory>/unravel/manager config ports remap 5000 6000
  4. Apply the changes.

    <Unravel installation directory>/unravel/manager config apply
  5. Start Unravel.

    <Unravel installation directory>/unravel/manager start

Remapping ports

  1. Stop Unravel.

    <Unravel installation directory>/unravel/manager stop
  2. Display the list of ports and keys

    <Unravel installation directory>/unravel/manager config ports show
  3. Run manager config ports remap to remap all the ports within a range.

    <Unravel installation directory>/unravel/manager config ports remap begin<specify start range> end<specify end range>

    For example, if you run the following command all the ports get remapped between 5000 and 6000:

    <Unravel installation directory>/unravel/manager config ports remap 5000 6000
  4. Apply the changes.

    <Unravel installation directory>/unravel/manager config apply
  5. Start Unravel.

    <Unravel installation directory>/unravel/manager start

Note

In a multi-cluster environment, do the following to avoid connectivity issues between core and edge node due to ports remapping:

  1. Remap the ports on the core node.

  2. Manually apply the same port mappings on the edge nodes for those ports that refer to the core node.