Install the ArcGIS Enterprise geoprocessing services

There are seven steps to enable the geoprocessing service on the ArcGIS GeoBIM Tools page for ArcGIS Enterprise.

Complete these steps, which will be detailed in the following sections:

1. Publish the GeoBIMUtilities service.
2. Update the GeoBIMUtilities service.
3. Publish the GeoBIM geoprocessing service.
4. Update the geoprocessing service configuration file for GeoBIM.
5. Publish the GeoBIMAuth geoprocessing service.
6. Update the geoprocessing service configuration file for GeoBIMAuth.
7. Configure ArcGIS Server Helper URL.

Publish the GeoBIMUtilities

Follow these steps to publish the GeoBIMUtilities:

1. Locate the service definition file (geobimutilities-12.0.0.sd) installed on the Portal machine at \apps\geobim\SD\.
2. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/

3. Click the Publish Service button.
4. Click the Choose File button and select the geobimutilities-12.0.0.sd file that was located in step 1.
5. Click Next.
6. Select the folder for the service to be published to or leave as Site (root).
7. Click Next.
8. Click Next again.
9. Check the box to share the service with portal.
10. Click Publish.

    After the service is published, edit the service properties.

    You must update three settings in the Pooling section based on your needs:

    • Minimum number of instances per machine: This is the number of instances that are always on. Starting a new instance has a slight delay before starting.
    • Maximum number of instances per machine: This is the maximum number of concurrent services that can be run.
    • The maximum time a client can use a service: This specifies how long the service can run for and is the most important setting for GeoBIMUtilities service.

      Large projects with many documents or issues will take longer, requiring this time-out to be set higher than typical services. The maximum time a client can use a service should be set to a minimum of 3600 (seconds). This can be increased as needed if the GeoBIMUtilities geoprocessing service is timing out.

    See Tune and configure services.

11. Click Save and Restart to apply the changes.

Update the geoprocessing service configuration file for GeoBIMUtilities

After the service is published, follow these steps to update the configuration file for the service:

1. On the ArcGIS Server machine, go to <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\GeoBIMUtilities.GPServer\extracted\cd\geobim\config.dat. If the directories for the ArcGIS Server machine have been changed from default, use your corresponding path.
2. Update the login URL to your portal URL.

   This URL looks like https://webadaptorhost.domain.com/webadaptorname/

   Note:

   Adding a trailing slash (/) to the end of the URL is crucial to ensure proper API functionality, preventing errors that can occur when the URL is interpreted incorrectly without the slash.

3. Save and close the file.
4. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/

5. Click the GeoBIMUtilities service to edit it.
6. Click Save and Restart to apply the changes made to the configuration file.

Publish the GeoBIM geoprocessing service

Follow these steps to publish the GeoBIM geoprocessing service:

1. Locate the service definition file (geobim-12.0.0.sd) installed on the Portal machine at \apps\geobim\SD\.
2. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/.

3. Click the Publish Service button.
4. Click the Choose File button and select the geobim-12.0.0.sd file that was located in step 1.
5. Click Next.
6. Select the folder for the service to be published to or leave as Site (root).
7. Click Next.
8. Click Next again.
9. Check the box to share the service with portal.
10. Click Publish.

    After the service is published, edit the service properties.

    You must update three settings in the Pooling section based on your needs:

    • Minimum number of instances per machine: This is the number of instances that are always on. Starting a new instance has a slight delay before starting.
    • Maximum number of instances per machine: This is the maximum number of concurrent services that can be run.
    • The maximum time a client can use a service: This specifies how long the service can run for and is the most important setting for ArcGIS GeoBIM.

      Large projects with many documents or issues will take longer, requiring this time-out to be set higher than typical services. The maximum time a client can use a service should be set to a minimum of 3600 (seconds). This can be increased as needed if the GeoBIM geoprocessing service is timing out.

    See Tune and configure services.

11. Click Save and Restart to apply the changes.

Update the GeoBIM geoprocessing service configuration file

After the service is published, follow these steps to update the configuration file for the service:

1. On the ArcGIS Server machine, go to <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\GeoBIM.GPServer\extracted\cd\geobim\config.dat. If the directories for the ArcGIS Server machine have been changed from default, use your corresponding path.
2. Open the config.dat file with a text editor running in administrator mode.
3. Add your APS application client ID to the GEOBIM_CLIENT_ID= line.
4. Add your APS application secret to the GEOBIM_CLIENT_SECRET= line.
5. Update the login URL to your portal URL.

   This looks like https://webadaptorhost.domain.com/webadaptorname/

6. Add your GeoBIMUtilities REST URL to the CreateShellsGPServiceUrl=.

   The URL should look like https://webadaptorhost.domain.com/webadaptorname/rest/services/GeoBIMUtilities/GPServer/CreateShellsService

7. Save and close the file.
8. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/

9. Click the GeoBIM service to edit it.
10. Click Save and Restart to apply the changes made to the configuration file.

Note:

Some functionality requires a certificate created by a known Certificate Authority. When using a self signed certificate in a testing or sandbox environment, the VerifySSL value can be set to False to allow the functionality without a CA issues certificate.

Publish the GeoBIMAuth geoprocessing service

Follow these steps to publish the GeoBIMAuth geoprocessing service:

1. Locate the service definition file (geobimauth-12.0.0.sd) installed on the Portal machine at \apps\geobim\SD\.
2. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/

3. Click the Publish Service button.
4. Click the Choose File button and select the geobimauth-12.0.0.sd file that was downloaded earlier.
5. Click Next.
6. Select the folder for the service to be published to or leave as Site (root).
7. Click Next.
8. Click Next again.
9. Check the box to share the service with portal.
10. Click Publish. Keep the default setting for the service.

Update the geoprocessing service configuration file for GeoBIMAuth

After the service is published, follow these steps to update the configuration file for the service:

1. On the ArcGIS Server machine, go to <ArcGIS Server installation drive>\arcgisserver\directories\arcgissystem\arcgisinput\GeoBIMAuth.GPServer\extracted\cd\geobim\config.dat. If the directories for the ArcGIS Server machine have been changed from default, use your corresponding path.
2. Repeat steps 2 through 4 in the Update the geoprocessing service configuration file section above.
3. Save and close the file.
4. Go to the ArcGIS Server Manager console that is federated with your Portal installation.

   The URL looks like https://webadaptorhost.domain.com/webadaptorname/manager/

5. Click the GeoBIMAuth service to edit it.
6. Click Save and Restart to apply the changes made to the configuration file.

Configure ArcGIS Server Helper URL

After the geoprocessing service is published, follow these steps to update the ArcGIS Server configuration for ArcGIS GeoBIM to locate the service:

1. In ArcGIS Server Manager, edit the service and go to the capabilities section.
2. Copy the REST URL.
3. Open the ArcGIS Portal Directory using the URL https://webadaptorhost.domain.com/webadaptorname/sharing/rest/
4. Click Log in to sign in with an administrator account.
5. Click Home to return to the ArcGIS Portal Directory.
6. Click Portals.
7. Click Self.
8. At the bottom of the page, under Supported Operations, click Update.
9. Go to the GeoBIM Service entry and provide the REST URL copied earlier using the following format: {"url":"https://webadaptorhost.domain.com/webadaptorname/rest/services/GeoBIM/GPServer","authUrl":"https://webadaptorhost.domain.com/webadaptorname/rest/services/GeoBIMAuth/GPServer"}

   The url entry must match the path to the GeoBIM service. The authurl entry must match the path to the GeoBIMAuth service.

After completing these steps, you are ready to access ArcGIS GeoBIM and create an ArcGIS GeoBIM project.