/
Admin Tools 2.0 Enterprise Installation Guide

Admin Tools 2.0 Enterprise Installation Guide

System Requirements

Admin Tools Enterprise currently works in Windows Server (2019 or higher) running IIS. Any typical Windows server used as a web server should have enough RAM, Disk space, CPUs, etc. to run Admin Tools Enterprise. Admin Tools Enterprise is run via a web browser, such as Google Chrome, Mozilla Firefox, and Edge. MongoDB version 5 or higher is required.

  • Minimum Specs:

    • 4 cores, 16 GB RAM

    • Windows Server 2019

    • At least 10 GB of free space

  • Recommended Specs:

    • 8 cores, 32 GB RAM

    • At least 10 GB of free space

    • Windows Server 2019 or higher

Instructions

This article is a step-through guide to properly install Admin Tools 2.0 Enterprise.

NOTE: For best practices, we recommend installing our products on a different machine than your ArcGIS Organization.

  1. Unzip the Admin Tools build to the proper location
    This can be under C:\inetpub\wwwroot\admintools or any location you wish. Be sure your windows file path is less than 256 characters when extracting our products otherwise there may be failures when unzipping the files. After unzipping, add this location as an application in IIS.

  2. Install AdminTools/installs/MongoDB-windows-*.exe
    If MongoDB isn’t installed on their server, install MongoDB using the mongodb-windows-x86_64-5.0.9-signed.msi file from the AdminTools/installs folder that was unzipped in step 1. Follow MongoDB's installation wizard to install (default options are fine). If there are any issues, see the MongoDB Installation Guide.

    1. Installing MongoDB Compass is optional. This software provides a human-readable interface for the database, and can help with troubleshooting, should it be necessary.

  3. Install Required IIS Modules
    In the AdminTools/installs/standalone folder, there are two files - rewrite_amd64_en-US.msi and requestRouter_amd64.msi. These IIS modules must be installed in the order just listed for Admin Tools for Enterprise to work properly. They are used by the application to create a reverse-proxy to forward requests through IIS to the server application.

  4. Install & Start Windows Service
    a. Run as administrator the AdminTools/installs/install_server.bat file
    b. Click the three dots next to the Path setting. Navigate one directory up to the main Admin Tools folder and navigate to the /app-server directory. Then select the index.exe file and click the open button.
    c. Click the Install service button
    d. Run the services application on Windows and make sure that “AdminTools Server” is running. If not, start the service.

     

    1. Additional Notes to Install & Start Windows Services

      1. If you are using IWA Authentication for an identity, you will need to set up the service account of the Admin Tools service to be an administrator account of the IWA ArcGIS organizations and use that as the service user.

        1. In your NSSM service installer, click on the Log On tab and select the This Account option.

        2. Use the account and password that will have administrator privileges to your organization.

        3. Once you are finished making changes, click the Install Service button.

      2. If you have already installed the service, you can run the edit_server.bat file

      3. If you need to delete the service, run the remove_server.bat file

  5. IIS: Enable Application Request Router proxy
    a. Under connections, click on the server entry under the start page
    b. In the center panel under the IIS section, double click on the Application Request Routing icon, so that your domain, <domain>/admintools/api, properly reroutes to the app-server localhost:9181.


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



  6. You can now open a browser to (https://yourdomain.com/admintools) and use the application.

NOTE: If you attempt to sign in to the application and see the “Invalid Redirect URI” error message popup. This means that the Redirect URI settings for the Admin Tools item in your ArcGIS Enterprise has not been configured, please refer to Creating An App-or-Client ID for your ArcGIS Organization from step 6 onwards to fix this.

 

If you have any questions or are experiencing any issues while following the step-through, please reach out to our GEO Jobe Support Team at support@geo-jobe.com.

 

 Related articles

Admin Tools for ArcGIS FAQ

Changing the Port Admin Tools Service Uses