Installing the ArcGIS Runtime SDK for Java on Linux

Start here to download, install, and set up the ArcGIS Runtime SDK for Java. You can install multiple versions of this software development kit (SDK) on the same machine.

1. Download the SDK to a location from which the setup program can be run, typically the home folder of the developer installing the SDK. Download the SDK from the Esri Customer Care Portal. Or insert the ArcGIS Runtime SDK for Java media. For download and extraction instructions, see the ArcGIS Runtime SDK Quick Start Guide . If you have no access or limited access to the Internet in your organization and cannot view the quick start topic, you may be eligible to use the Esri Customer Care site to request that backup media be sent to you.
2. Make sure the machine you want to use as your development machine meets the system requirements. For the latest release information, including tips and known issues discovered after release, see Release notes: ArcGIS Runtime SDK for Java.
3. Double-click the Setup shell script, Setup.sh, located in the download location. Run it directly or in a terminal.

   The ArcGIS Runtime SDK for Java installation wizard appears.

4. Click Next.
5. Follow the on-screen instructions. In the Select Features panel, you can change the default installation directory by clicking the Change button, then navigating to the directory you want. Make sure this directory is on your development machine. You must have write permissions to this directory. Ensure no other users are using the directory.
6. On the last panel of the wizard, click Done. The ArcGIS Runtime SDK for Java is installed and the Software Authorization Wizard displays. Now you are ready to authorize your development machine. Or you can authorize it later.
7. ArcGIS Runtime SDK for Java environment variables can be set using a shell script and one of three options, as described in the following section.

Set ArcGIS Runtime SDK for Java environment variables

ArcGIS Runtime SDK for Java environment variables can be set using a shell script and one of the three options described in this section:

1. For every user logging in
2. For an individual user logging in
3. For each time a user needs to use the SDK, for example, for all programs executed from a single terminal session

1—For all users logging in to the machine

Copy the SDK initialization scripts (both init_sdk_java.sh and init_sdk_java.csh) from <install location>/java10.1.1 to /etc/profile.d : $ sudo cp <install location>/java10.1.1 /etc/profile.d

2—For an individual user logging in to the machine

1. Add the contents of the SDK initialization script to the ${HOME}/.bashrc and ${HOME}/.cshrc file.

   $ cat <install location>/java10.1.1/init_sdk_java.sh >> ${HOME}/.bashrc

   $ cat <install location>/java10.1.1/init_sdk_java.csh >> ${HOME}/.cshrc

2. Reboot the machine and have the user log in. Use the export command, verify that ArcGIS Runtime SDK environment variables are present.
3. Start all applications that are dependent on the ArcGIS Runtime SDK for Java from anywhere in the user's environment.

3—For a single terminal session

1. Start the terminal.
2. Decide which shell script is appropriate for the environment. You can determine the current shell by using the following command:

   $ echo ${SHELL}

3. If the shell is bash or sh then source init_sdk_java.sh.

   $ source <install_location>/java10.1.1/init_sdk_java.sh

4. If the shell is csh or tcsh then source init_sdk_java.csh.

   $ source <install_location>/java10.1.1/init_sdk_java.csh

5. Use the export command; verify that ArcGIS Runtime SDK environment variables are present.
6. Start all applications that are dependent on the ArcGIS Runtime SDK for Java from this terminal. Also start Eclipse from this terminal if Eclipse is to open ArcGIS Runtime SDK for Java applications.

Install the Eclipse plugin

To install the Eclipse plugin, see the instructions in Installing the Eclipse plugin.