Skip To Content

Silently installing Portal for ArcGIS on Linux

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

Note:

Upgrading to 10.5.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.

Install Portal for ArcGIS silently on Linux

  1. Before beginning the installation, read the license agreement located at <CD_ROOT or untar directory>/Documentation/EULA.pdf and accept the terms.
  2. Run the setup silently at the prompt. See sample syntax below:

    <CD_ROOT or untar directory>/Setup -m silent -l yes -a <full path to authorization file>

    Usage: Setup [Options]

    OptionDescription

    -m; --mode MODE

    Optional. Defaults to GUI.

    MODE is one of the following: silent, console, or gui.

    -l; --license-agreement CHOICE

    Required for silent mode. CHOICE can be Yes or No.

    Yes indicates that you have read and agreed to the Esri Master Agreement (E204, E300). Please visit http://www.esri.com/legal/licensing-translations to read the agreement.

    -a; --authorization-file FULL_PATH_TO_AUTHORIZATION_FILE

    Optional. If this option is not used, you will need to authorize the software after installation. FULL_PATH_TO_AUTHORIZATION_FILE is the full, absolute path to an .ecp or .prvc file provided by Esri.

    FULL_PATH_TO_AUTHORIZATION_FILE examples:

    --authorization-file /home/user/ArcGIS_Portal.ecp

    -a /data/auth_files/ArcGIS_Portal.prvc

    -d; --directory DIRECTORY

    Optional. By default, Portal for ArcGIS is installed in the user's $HOME directory. DIRECTORY specifies a different installation directory.

    The path /arcgis/portal is appended to the installation directory.

    If you're pointing the setup to a previous installation directory, the content in that directory is automatically used in the new installation. Content from installations prior to version 10.2 are not supported.

    -v; --verbose

    Installer runs in verbose mode.

    -h; --help

    Displays command line help and exits.

    -e; --examples

    Displays usage examples of these options and exits.

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.5.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
    Note:

    To prevent any one service from spawning too many threads and consuming all server resources, systemd v228 and beyond included in SLES12 SP2 and higher set the maximum number of threads to be created at 512. Users on SLES12 may need to enable and raise this limit if it is a heavily used system. To enable and raise this limit, as root user, uncomment and edit the following line in the <arcgisserver.service | arcgisportal.service | arcgisdatastore.service> unit file before deploying it to the /etc/systemd/system folder: # TasksMax=512

  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.