Admin Tools 2.0 Enterprise Installation Guide

For On-Premise Installation:

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.
   
   

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.
   
   

   Open

   

   
   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
   
   

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
   
   

   Open

   

   
   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.

Changing the port of your Admin Tools Service

Admin Tools by default runs internally on port (9180). For a situation such as you are running a beta version of Admin Tools 2.0 with 1.0 still running on 9180, you may need to change the port and run as a second service. To change the port:

1. Temporarily stop the Admin Tools 2.0 service if it is running.
   
   

2. In the AdminTools base directory, edit the web.config file and change line 33 from:
   <action type="Rewrite" url="http://localhost:9180/{R:1}" />
   TO:
   <action type="Rewrite" url="http://localhost:9181/{R:1}" />
   
   

3. Save this file and exit your text editor.
   
   

4. Under the AdminTools/app-server/config directory, edit the nodeconfig.json file and change line 2 from:
   "port": 9180,
   TO:
   "port": 9181,
   
   

5. Save this file and exit the text editor.
   
   

6. Restart the service or use AdminTools/installs/install_server.bat to create the service.

 Related articles