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.
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.
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.
Install the SDK and set up the development environment (see Installation).
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.xmlfile (see Dependency management).
Copy the code and other relevant files, such as custom property page files, if any, to the new Maven project.
Now you can use
mvn installto build your project.
Install the SDK and set up the development environment (see Appendix > Use Eclipse plugin (10.6.1-10.8) > Installation).
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.
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).
You can save the Java class and build your project now.