Manage Custom Host Entries

If you have hosts in your environment that use custom entries, or if you want to use NAT IPv4 addresses for your hosts, this topic provides instructions for configuring these settings.

Manage Custom Host Entries in /etc/hosts

If you identify hosts in your environment that need custom entries, you can add custom entries for your hosts in the /etc/hosts.user file.

To add custom host entries:

  1. From the console, log in to the host on which to define custom entries.
  2. Add the custom entry to the /etc/hosts.user file.

To update or refresh a custom entry in /etc/hosts:

Run the following command:
nw-manage --refresh-host --host-key <ID, IP, hostname or display name of host>

Manage Public or NAT IPv4 Addresses for Hosts

To add or update public or Network Address Translation (NAT) IPv4 addresses for NW Hosts, run the following command:
nw-manage --update-host --host-id <NW Server Host UUID> --ipv4-public <IP address>

Manage Custom Jetty Configuration

If you want to have custom jetty configurations or additional JAVA_OPTIONS that persist during the upgrade, this topic provides the instructions for configuring custom jetty settings.

To add custom jetty configuration

  1. From SSH prompt, create a copy of jetty configuration as jetty.user using the below command.
    $ cp /etc/default/jetty /etc/default/jetty.user
  2. Edit the /etc/default/jetty.user and remove all lines EXCEPT one of the JAVA_OPTIONS additional settings lines.
    For example, JAVA_OPTIONS="${JAVA_OPTIONS} -Drsa.primary.host=true "
  3. Edit the line with the option (in this example increasing the max memory option from 8G to 24G):
    JAVA_OPTIONS="${JAVA_OPTIONS} -Xmx24G "
  4. Make sure to use the JAVA_OPTIONS="${JAVA_OPTIONS} " format to EXTEND the JAVA OPTIONS.
  5. REMOVE the [ -f /etc/default/jetty.user ] && source /etc/default/jetty.user file.
  6. Save the file.

  7. Restart the jetty service.
    systemctl restart jetty

    Note: When you overwrite the jetty.user custom config file, ensure that all the jetty configurations (JAVA_OPTIONS) present in /etc/default/jetty are available in this file. If any jetty configuration (JAVA_OPTIONS) is not available in the jetty.user file, you must copy it to the file and then restart the jetty service.