Scheduler for ArcGIS: Installation Guide

Owned by Steven McCall
Last updated: Jan 24, 2024

(Full manual available here)

Installing Scheduler for ArcGIS

Scheduler for ArcGIS is only installed on-premise; there is no SaaS version available. This means users have complete control over where their copy of Scheduler is installed, as well as any information from their ArcGIS Organization it may touch. Scheduler can be run on any machine that can access your ArcGIS Organization and can run as a service or on localhost*.

*Unless you are using webhooks. In that case, Scheduler must be installed on a server with a fully qualified domain name and a valid certificate from an outside certifying authority (i.e. not self-signed). If a user wishes to run Scheduler on localhost and leverage webhooks, they can do so as long as they use a URL rewrite to create a fully qualified domain name for localhost.

Scheduler for ArcGIS relies on MongoDB® (included in the ZIP file) to operate. You will also need to install it on any machine Scheduler (or Scheduler Satellite) is installed on. We also recommend installing MongoDB Compass as part of the installation process. Compass is a GUI interface for interacting with the database, and will help if you ever need to access any of that information.

Scheduler for ArcGIS also requires Internet Information Services (IIS) installed on the machine to operate. Be sure that IIS has been installed before performing the Scheduler installation. For Windows Server, you can install IIS by visiting the Start Menu > Administrative Tools > Server Manager, then Add roles and select Web Server (IIS). For Windows 11, you can install it by visiting Control Panel > Programs > Programs and Features > Turn Windows features on or off and select Internet Information Services.

New Installation Instructions

  • Unzip the Scheduler for ArcGIS build to the proper location. This can be under C:\inetpub\wwwroot\scheduler or any location you wish. You will need to add this location as an application in IIS. Make sure that your license file, SCHED-geojobe.license.txt, is in the main directory.

  • Install scheduler/installs/MongoDB-windows-*.exe. If you don’t already have MongoDB installed on your server, you can find the installation file, mongodb-windows-x86_64-7.x.x-signed.msi, in the scheduler/installs folder that was unzipped in step a. Follow MongoDB's installation wizard to install (default options are fine).

  • Install the required IIS Modules. In the scheduler/installs/standalone folder, there are two files - 1_rewrite_amd64_en-US.msi and 2_requestRouter_amd64.msi. These IIS modules must be installed in the order just listed for Scheduler for ArcGIS Enterprise to work properly. They are used by the application to create a reverse proxy to forward requests through IIS to the server application. 

  • Install and Start the Windows Service. Run as administrator the scheduler/installs/install_server.bat file

  • Click the three dots next to the Path setting. Navigate one directory up to the main Scheduler folder. Then select the server.exe file and click the open button.

  • Click the Install Service button

  • Run the services application on Windows and make sure that “Scheduler Server” is running. If not, start the service.

  • If you have already installed the service, you can run the edit_server.bat file.
    If you need to delete the service, run the remove_server.bat file

  • In IIS, Enable Application Request Router proxy.

Under connections, click on the server entry under the start page.

In the center panel under the IIS section, double-click on the Application Request Routing icon.

Click the enable proxy checkbox in the center panel, then on the right panel click the apply button.

You can now open a browser to http://yourdomain.com/scheduler and use the application.

Installing Scheduler Satellite on an ArcGIS/Data Source Server

Scheduler Satellite is an additional, optional application that can be used to access local files that cannot be accessed remotely. It will be included as a zip file in the main Scheduler build and can be installed on multiple other machines. The Satellite application communicates directly with the main Scheduler for ArcGIS to enable you to perform actions from the Scheduler interface where access would not have been previously possible.

To Install Scheduler Satellite

  • Unzip the Scheduler Satellite build to the proper location. This can be under C:\SchedulerSatellite or any location you wish. You will need to add this location as an application in IIS. Be sure to include your license file, SCHED-geojobe.license.txt, in the main directory of Scheduler Satellite.

  • Install scheduler/installs/MongoDB-windows-*.exe. If you don’t already have MongoDB installed on your server, you can find the installation file, SchedulerSatellite/installs folder that was unzipped in step a. Follow MongoDB's installation wizard to install (default options are fine). Follow MongoDB's installation wizard to install (default options are fine).

  • Install and Start the Windows Service. Run as administrator the SchedulerSatellite/installs/install_server.bat file

  • Click the three dots next to the Path setting. Navigate one directory up to the main Scheduler folder. Then select the satellite.exe file and click the open button.

  • Click the Install Service button.

  • Run the services application on Windows and make sure that “Scheduler Satellite” is running. If not, start the service.

  • See Section I: Scheduler Satellite for more information on how to configure Satellite in the Scheduler for ArcGIS application.

Updating an Existing Version of Scheduler for ArcGIS or Scheduler Satellite

  1. Stop the current Scheduler for ArcGIS/Scheduler Satellite service.

  1. Update the name for your current Scheduler folder to include the suffix “_old”. This is recommended best practice until the update is complete, so you can roll back if an unexpected error occurs during installation.

  2. Recreate the original Scheduler folder, then move the Zip file containing the update to the same location where you installed Scheduler for ArcGIS, then extract it. We recommend moving the files while they are still zipped, as this is a faster and more efficient use of both your computer’s resources and your time. If you do not have it, we recommend using 7zip to extract the files. 7zip is faster, more efficient, and more reliable than the default Windows process.

  3. If you made custom changes to config/nodeconfig.json, copy those files as needed from the _old directory into the new directory.

  4. Restart the Scheduler Service.

  5. Test the update at the same URL you used to access Scheduler for ArcGIS before. If the webpage loads and you can sign into Scheduler for ArcGIS, you may delete the _old folder created in step b. If you cannot get that far, please reach out to GEO Jobe’s Support Division (support@geo-jobe.com) for additional help.

  6. Changing the port of your Scheduler Service or Scheduller Satellite Service

    1. Scheduler by default runs internally on port (7501), and Scheduler Satellite runs on port (3000). If you wish to change the port number, follow these steps:

      • Temporarily stop the Scheduler service if it is running.

      • In the scheduler base directory, edit the web.config file, find the line

<action type="Rewrite" url="http://localhost:7501/{R:1}" />

  • And change it to

<action type="Rewrite" url="http://localhost:yourPortNumber/{R:1}" />

  • Save this file and edit your text editor.

  • Under the <schedulerhome>/config directory, edit the nodeconfig.json file and update the port to your new port number.

  • Restart the service or use <schedulerhome>/installs/install_server.bat to create the service.

Licensing

The licensing for Scheduler for ArcGIS is based on connectors, specifically per connector or the URL used to access your ArcGIS organization. Each unique ArcGIS organization requires a separate connector for Scheduler usage. The license encompasses unlimited implementations of Scheduler Satellite, facilitating access to data sources for integration with your Scheduler application. Additionally, a Scheduler license allows access for unlimited users to the application.

Your license is contained in a file in your main Scheduler/Scheduler Satellite directory called SCHED-geojobe.license.txt. Opening this file in a text editor you can see your expiration and connector information. You may also change the name of the license file that Scheduler for ArcGIS is looking for by opening scheduler/server-side/config/nodeconfig.json and changing the licenseFilename field.

Installation Requirements

System Requirements:

  • Windows Server 2016 or higher server OR

  • Windows 10 or higher personal computer

  • MongoDB installation required

  • Recommended server specs:

    • Quad-core processor minimum, 8 core or higher recommended for larger organizations

    • 16 GB RAM for optimal performance

  • If users want to run tasks based on ArcGIS Server Logs, Scheduler Satellite must be installed on the machine where the log files are located.

  • If they want to use webhooks, Scheduler must be installed on a machine with a valid certificate from a certifying authority (i.e. not self-signed). Scheduler can run on localhost but they must use a URL rewrite in IIS to create a fully qualified domain name that is HTTPS.