Skip to main content

Configure ArcGIS Notebook Server in advanced scenarios

ArcGIS Enterprise can be deployed on machines that have multiple network interface controller (NIC) cards or DNS entries (also called records) in a DNS name server. If you installed ArcGIS Notebook Server on a machine that contains more than one NIC card or multiple entries in a DNS name server, you must identify the IP address or host name the server should use for network communication. This is done by adding a file to the installation directory for each machine in the site.

Configure ArcGIS Notebook Server

Follow the steps below to configure ArcGIS Notebook Server in an advanced scenario:

  1. Sign in to the machine where ArcGIS Notebook Server is installed. Browse to the <Notebook Server installation directory>\framework\etc folder. Create a file named hostname.properties with appropriate permissions in this folder.

  2. Sign in to the machine where ArcGIS Notebook Server is installed. Browse to the <Notebook Server installation directory>/framework/etc folder. Create a file named hostname.properties with appropriate permissions in this folder.

  3. Add the following text to the first line of the file, and specify the fully qualified domain name of the intended interface: hostname=interface.domain.com. For example, if you have a machine with two NIC cards or DNS entries (1 and 2), these interfaces' domain names resolve to NS1.mycompany.com and NS2.mycompany.com. If you want ArcGIS Notebook Server to use the second interface for network communication, add the following text to the hostname.properties file: hostname=NS2.mycompany.com.

    Note:

    In some cases, such as when a host name is the same for multiple interfaces, you should instead specify the IP address of the interface you want ArcGIS Notebook Server to use for network communication. The syntax is hostname=<IP address>.

  4. Save and close the hostname.properties file.

  5. Restart the ArcGIS Notebook Server service on Windows. Repeat with any other machines in your ArcGIS Notebook Server site.

  6. Restart ArcGIS Notebook Server using the stopnotebookserver.sh and startnotebookserver.sh commands. Repeat with any other machines in your ArcGIS Notebook Server site.

If necessary, complete the steps to configure the following ArcGIS Enterprise software components on machines with multiple NIC cards or DNS entries: