Edit the Appliance Hosts File

Every appliance instance in a deployment has a unique hosts file. Use the Operations Console to add, modify, or delete entries to this file. Do not edit the hosts file outside of the Operations Console, or the file may become unreadable.

Procedure

  1. Log on to the Operations Console on the appliance that has the hosts file that you want to edit.

  2. Click Administration > Network > Hosts File.

  3. Perform the appropriate action.

    • To add a new entry, click Add New and enter:

      • An IP address in IPv4 or IPv6 format. Example in IPv6 format: 3ffe:1900:4545:3:200:f8ff:fe21:67cf. Example in IPv4 format: 19.117.63.126.

      • One or more hostnames, separated by commas. Every hostname and FQDN has a limit of 255 characters, and this field has a limit of 1024 characters. Example hostname: authservices.corp.com.

        One IP address can have multiple hostnames. To associate different IP addresses with the same hostname, you must add a row for each IP address.

      • Comments, if any. Double quotation marks, hash characters, and any non-printing characters are not supported, and are removed when the hosts file is saved.

      Note: You cannot repeat an IP address or hostname that is in the Read-only Content section of the hosts file.

    • To edit an existing entry, click the row that you want to edit and make changes. You can edit multiple rows before saving your changes.

      If you update the IP address or hostname for a remote syslog server, you must restart Authentication Manager services to apply the change:

      1. Log on to the appliance operating system as rsaadmin.

      2. Change the directory to /opt/rsa/am/server

      3. Run ./rsaserv restart all.

    • To delete an entry, select the checkbox in the row that you want to remove, and click Delete. When prompted, confirm the action. You can select multiple rows.

  4. Click Save to save your changes in the hosts file.