Adding a new ArcGIS Organization to your Admin Tools for ArcGIS Dropdown
When first signing into Admin Tools for ArcGIS, the user is prompted with a dropdown containing a list of your licensed ArcGIS Organizations.
For customers with a Site License ( *.your-domain.com ) or a Professional Services License ( *.* ), you may find yourself in a situation where you would like to add a specific ArcGIS Organization as an option in this list. This guide will outline how to do so.
Note: This is only applicable for clients with Site Licenses or Professional Services Licenses.
Step 1: Stop the Admin Tools Service
You will want to stop the Admin Tools service, so that any other potential users will not be interacting with components that will be updated as part of this process. To do so, open your Services window, select the AdminTools Server service, then stop the service.
Step 2: Open the clientConfig file
In your File Explorer, navigate to where Admin Tools is installed. In the root directory, find and open the clientConfig file in a text editor of your choice.
clientConfig file will be in Admin Tools' root directoryStep 3: Update the portals array to include your desired ArcGIS Organization(s)
In clientConfig, there will be an array labeled portals. Each index in the array ( indexes are contained by curly brackets { } ), represents an ArcGIS Organization. When Admin Tools starts, it will check this list against your licensed options. Any ArcGIS Organizations that are included in your licensing will be added to the dropdown list when a user is selecting the ArcGIS Organization to use with Admin Tools.
Note: The values on the left side of each colon should not be edited. You will only edit values on the right side of the colon.
{
"portals": [
{
"url": "https://your.oauth.org.domain/webadaptor",
"appId": "YourAppIDHere",
"authentication": "OAuth2"
},
{
"url": "https://your.IWA.org.domain/webadaptor",
"appId": "",
"authentication": "IWA"
}
],
"debugMode": false
}For each ArcGIS Organization you would like to appear in the dropdown, add a new index with the required properties. ArcGIS Organizations using OAuth2 will require an App ID. ArcGIS Organizations using IWA will not need an App Id, but the field will need to be included. An empty string "" is sufficient for a value.
{
"portals": [
{
"url": "https://your.oauth.org.domain/webadaptor",
"appId": "Your ArcGIS AppID Here",
"authentication": "OAuth2"
},
{
"url": "https://arcgis-org.example.site/arcgis",
"appId": "Another ArcGIS AppID Here",
"authentication": "OAuth2"
},
{
"url": "https://your.IWA.org.domain/webadaptor",
"appId": "",
"authentication": "IWA"
}
],
"debugMode": false
}Once you are finished adding your ArcGIS Organizations, save and close the file.
Step 4: Restart the Admin Tools Service.
In the Services Window, navigate to the Admin Tools Service and start the service stopped in step one.
Step 5: Confirm Success
Open Admin Tools for ArcGIS in your preferred browser. Your connectors/portal URL(s) should now be listed in your Admin Tools dropdown list for logins.
If you already had the webpage open, you will need to clear your cache and refresh the page for the list to update.
