Installing Portal for ArcGIS

The steps below guide you through the Portal for ArcGIS installation process.

Note:

Upgrading to 10.6.1? For more information, see About upgrading Portal for ArcGIS.

Preparing to install Portal for ArcGIS

1. Verify that your site meets the minimum system requirements.
2. Log in to your machine as a user with administrative privileges. You cannot install Portal for ArcGIS as a root user.
3. Open the ports as described in Ports used by Portal for ArcGIS.
4. Close all noncritical applications on your server.
5. Browse to the downloaded folder containing the Portal for ArcGIS setup or insert the Portal for ArcGIS media into the appropriate drive to automatically launch the setup program.

You are now ready to proceed with the Portal for ArcGIS installation.

Installing Portal for ArcGIS

1. Run the setup program from the Portal for ArcGIS download folder or setup media. The setup program begins by checking the prerequisites that must be met to successfully set up and use Portal for ArcGIS. If your system does not meet any of the prerequisites, follow the instructions in the dialog box to correct any issues. To learn more, see Checking portal diagnostics using the diagnostics tool.
2. If all prerequisites are met, the Introduction dialog box displays. Click Next to proceed.
3. On the Master Agreement dialog box, read the master agreement. If you accept the terms, click the I accept the master agreement button, and click Next to proceed; otherwise, exit the setup by clicking Cancel.
4. On the Choose Install Folder dialog box, specify the installation location. If you're pointing the installer to an earlier portal directory, the content in that directory will automatically be used in the new installation. Content from installations prior to version 10.2 are not supported. Click Next to continue.
5. Review the summary information, and click Install to begin the installation.
6. Before the installation finishes, the Software Authorization Wizard dialog box displays. Use the wizard to complete the authorization process. For more information, see Authorizing Portal for ArcGIS. Ensure that your provisioning file includes entitlements for at least one portal member using a Level 2 license. You require at least one Level 2 license in order to create your portal.
7. When the authorization process is complete, click Done to exit the wizard.

   Note:

   The software authorization status is displayed on the Install Complete dialog box. If a failure is detected, address the failure message, and open the Portal for ArcGIS Software Authorization Wizard to rerun the authorization.

Post-installation configuration

If you want Portal for ArcGIS to start with the operating system, complete the steps specific to your operating system.

Operating systems that support systemd

If your operating system supports the use of systemd to bootstrap and manage processes (for example, if you are using Red Hat 7.x), follow these steps to configure Portal for ArcGIS to start with the operating system.

1. Within a command shell, switch to root user.
2. Copy the <Portal for ArcGIS installation directory>/framework/etc/arcgisportal.service unit file to /etc/systemd/system. Once the file is copied over, make sure /etc/systemd/system/arcgisportal.service has its file permissions set to 600.

   Note:

   This file is installed with Portal for ArcGIS 10.6.1.

3. Still as root user, run the following command to automatically create the links in /etc/systemd/system/multi-user.target.wants:
   # systemctl enable arcgisportal.service

4. To verify that the systemd service is properly configured, restart the service and check its status.
   # systemctl stop arcgisportal.service
   # systemctl start arcgisportal.service
   # systemctl status arcgisportal.service

5. End the root user session.
6. Reboot the operating system and verify that Portal for ArcGIS restarts properly.

Operating systems that support SysV

If your operating system supports the use of SysV to bootstrap and manage processes, follow these steps to configure Portal for ArcGIS to start with the operating system.

1. Within a command shell, switch to root user.
2. Copy the <Portal for ArcGIS installation directory>/framework/etc/arcgisportal shell script to the appropriate supported Linux distribution-based locations provided below:
   • RHEL: /etc/rc.d/init.d/
   • SUSE: /etc/init.d/
3. Change the directory to the applicable init.d folder, and check the arcgisportal script to make sure that root has at least read and execute permissions.
4. Edit the script as follows:

   1. Update the portalhome variable to the Portal for ArcGIS installation directory, for example, /home/username/arcgis/portal.

   2. For RHEL only, add the line below just before # Description: Portal for ArcGIS Service:

      # chkconfig: 35 99 01

   3. Save the edits to the arcgisportal script.

5. Still as root user, run the following commands to automatically create the links in /etc/rc*.d with the appropriate run levels:
   • RHEL:
     $ chkconfig --add arcgisportal
     $ chkconfig arcgisportal on

   • SUSE:
     $ insserv arcgisportal
     $ chkconfig arcgisportal on

6. End the root user session.
7. Reboot the operating system, and verify that Portal for ArcGIS restarts properly.

If you encounter an error during the installation

If you encounter a failure during the installation, you can review the logs to help you troubleshoot. When doing this, first determine if you can access the ArcGIS Portal Directory. If you can, query the logs and review the messages. If not, review the log messages on disk. To access the logs on disk, browse to the logs directory and open the most recent log file (for example, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20150101.095803-8596-0.0.log). If necessary, you can share this information with Esri Support.

If your portal machine has multiple network interface controller cards

ArcGIS Enterprise can be deployed on machines that have multiple network interface controller (NIC) cards. If you installed Portal for ArcGIS on a machine that contains more than one NIC card, you may want to identify which interface the portal should use for network communication. This is done by editing an existing file and adding a new file into the portal's installation directory, which by default is /home/User/arcgis/portal.

Caution:

Perform these steps immediately after installation, prior to creating the initial administrative account and portal site.

1. Log in to the multi-NIC machine where Portal for ArcGIS is installed. Navigate to the folder <Portal installation directory>/framework/etc. Create a new file named hostname.properties, with appropriate permissions, inside this folder.
2. 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 (1 and 2) and their interfaces' domain names resolve to P1.mycompany.com and P2.mycompany.com, and you want Portal for ArcGIS to use the second interface for network communication, add this text to the hostname.properties file: hostname=P2.mycompany.com.

   Note:

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

3. Save and close the hostname.properties file.
4. Navigate to the folder <Portal installation directory>/framework/runtime/ds/framework/etc. Locate the hostidentifier.properties file located in this folder.
5. Open the file in a text editor. Remove the comment mark # from the hostidentifier property, and set the property to the IP address of the NIC card you want the portal to use for network communication. For example, to designate a card with IP address 12.34.56.189, the line should read as follows.
   hostidentifier=12.34.56.189

6. Save and close the hostidentifier.properties file.
7. Restart the portal using the command line scripts stopportal.sh and startportal.sh.

   Note:

   When you upgrade your portal to a newer version, the upgrade will reset this hostidentifier.properties file to its default contents. You must add the appropriate IP address back in after upgrading.

If necessary, follow the steps to configure other ArcGIS Enterprise software components on machines with multiple NIC cards:

• ArcGIS Server
• ArcGIS Data Store