Prepare to upgrade GeoEvent Server
Note:
Do not uninstall an existing version of ArcGIS GeoEvent Server before installing the new version of GeoEvent Server. Instead, run the GeoEvent Server installer to properly upgrade your existing GeoEvent Server configuration to the new version.
The GeoEvent Server installer is designed to detect and upgrade an existing installation of GeoEvent Server on the target system.
Before upgrading to a new version of GeoEvent Server, it is recommended you export your GeoEvent Serverconfiguration using ArcGIS GeoEvent Manager and backup any installed or added components. The components are added to the following folder: <ArcGIS Server installation directory>/GeoEvent/deploy.
Note:
When upgrading from a 10.x version to GeoEvent Server 11.1, your existing GeoEvent Server site configuration will not be automatically upgraded during the installation. You will need to manually import your configuration file after successful completion of the upgrade. To acknowledge you understand this, /ubc yes must be specified following ./Setup.sh. For more information on exporting and importing your GeoEvent Server site configuration, see Backup and restore your GeoEvent Server site configuration.
For any custom components you have developed including connectors and processors, you might need to modify the code, release numbers, configurations, and rebuild with the appropriate version of the GeoEvent Server Software Development Kit (SDK). For more information, see If I have custom components (connectors or processors) deployed, do I need to recompile them against the latest GeoEvent Server SDK when upgrading? below.
Upgrade GeoEvent Server
To upgrade GeoEvent Server from a previous version, follow the steps below:
- Stop the ArcGIS GeoEvent Server daemon
- Stop the ArcGIS GeoEvent Gateway daemon.
- When applicable, stop and uninstall the ArcGIS GeoEvent Server and ArcGIS GeoEvent Gateway daemons.
Note:
Refer to the GeoEvent Server Installation Guide for the version currently installed and execute Step 1 of the Uninstall GeoEvent Server topic to stop and uninstall the daemons.
- Upgrade ArcGIS Server.
Note:
The version of ArcGIS Server and ArcGIS GeoEvent Server must be the same.
- Upgrade ArcGIS GeoEvent Server by following the installation steps at Install GeoEvent Server. This will upgrade GeoEvent Server to the new version.
Common software upgrade questions
This section addresses common questions about the upgrade behavior of GeoEvent Server.
Do I need to uninstall a previous version of GeoEvent Server before installing the new version?
No. If you already have an existing version of GeoEvent Server installed, the setup will automatically upgrade it to the new version without any additional configuration.
Do I need to backup anything before installing the new version of GeoEvent Server?
Yes. It is recommended that you back up your GeoEvent Server configuration as well as your added components.
To backup your GeoEvent Server configuration, use GeoEvent Manager to export your configuration as a configuration file.
Note:
When upgrading from a 10.x version to GeoEvent Server 11.1, your existing GeoEvent Server site configuration will not be automatically upgraded during the installation. You will need to manually import your configuration file after successful completion of an upgrade. For more information on exporting and importing your GeoEvent Server site configuration, see Backup and restore your GeoEvent Server site configuration.
To backup your added components, back up the content from the following folder: <ArcGIS Server installation directory>/GeoEvent/deploy.
If I upgrade to a new version of ArcGIS Server, do I need to upgrade GeoEvent Server?
Yes. The release of GeoEvent Server must match ArcGIS Server. You cannot run mismatched releases of the software on the same machine.
If I have custom components (connectors or processors) deployed, do I need to recompile them against the latest GeoEvent Server SDK when upgrading?
With any GeoEvent Server release, there may be important updates to backend libraries and dependencies that may require any custom components (connectors and processors) developed and deployed on a previous release of GeoEvent Server to be recompiled using the GeoEvent Server SDK being installed. Before deploying to a production environment a custom component built against a previous release's SDK, ensure it works as expected.
If a custom component deploys correctly, no further action is needed. If the custom component does not deploy correctly, recompile against the release of the GeoEvent Server SDK being installed.