Upgrade extensions

This topic discusses how to upgrade ArcGIS Enterprise SDK to a later version and upgrade the SOE or SOI built with previous version of the SDK to a later version.

Extension compatibility with newer versions of ArcGIS Server

Currently, deploying an older version of SOE or SOI to a newer version of ArcGIS Server is not supported. Even though the extension may still work with a newer version of ArcGIS Server, the best practice is to recompile the extension using the same version of ArcGIS Enterprise SDK as the version of ArcGIS Server where the extension will be deployed. With that being said, if you want to deploy your SOE or SOI to the latest version of ArcGIS Server, you should compile your SOE or SOI using the latest version of ArcGIS Enterprise SDK.

Similarly, if you want to use a new feature provided by the newer version of ArcGIS Enterprise SDK, you must upgrade your ArcGIS Server to the same version.

Upgrade steps

To upgrade your ArcGIS Enterprise SDK, you should first uninstall any previous version of ArcGIS Enterprise SDK. This can be done through the Control Panel for Windows and the uninstall_EnterpriseSDK command for Linux.

Then, you can install the latest version of ArcGIS Enterprise SDK, set up the development environment, and use the installed SDK to recompile your previous version of SOE or SOI project. Since ArcGIS Enterprise SDK started to use the Maven framework to manage SOE and SOI projects at 10.8.1, the upgrade steps are different depending on which version you want to upgrade to.

Upgrade to 10.8.1 or later versions of ArcGIS Enterprise SDK

  1. Install the SDK and set up the development environment (see Installation).

  2. Create a new SOE or SOI Maven project using the Maven archetype (see Project creation).

    Since the 10.8.1 SDK manages SOE or SOI project using the Maven framework, you should migrate your previous Java SOE and SOI project to a Maven project.

    If your previous SOE or SOI project references any third-party JARs, you must install those JARs to your Maven local repository and reference them at the project's POM.xml file (see Dependency management).

  3. Copy the code and other relevant files, such as custom property page files, if any, to the new Maven project.

  4. Now you can use mvn install to build your project.

Upgrade to 10.8 or previous versions of ArcGIS Enterprise SDK

  1. Install the SDK and set up the development environment (see Appendix > Use Eclipse plugin (10.6.1-10.8) > Installation).

  2. Open your previous version of SOE or SOI project in Eclipse.

    Click File > Open Projects from File System.

    Select your project folder and click Finish.

  3. Update the ArcGIS Enterprise SDK library.

    Right-click the project > Build Path > Configure Build Path....

    Click the Libraries tab in the project's Properties window.

    Choose the existing ArcObjects Library listed under Libraries and click the Remove button to remove it.

    Add the current ArcGIS Enterprise SDK library (see add the ArcGIS Enterprise SDK library).

  4. You can save the Java class and build your project now.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

;