Manually Configuring the Application Launcher Connection to Ingress

Recommended reading: Ingress

If you installed or upgraded the App Launcher Server first before installing Ingress, establish their connection by following these steps depending on your installation or upgrade scenario:

Local Setup

If the App Launcher Server and Ingress are installed on the same machine, you only need to restart the App Launcher Server website in IIS:

1. Open the Internet Information Services (IIS) Manager.

2. Under the Connections pane, expand the root node and Sites.

   

   IIS: Home
   
   

3. Select Open iT Launcher Server.

4. Under the Actions pane, in Manage Website, click Stop.

   

   IIS: Stop Website
   
   

5. Click Application Pools.

   

   IIS: Application Pools
   
   

6. Select Open iT Launcher Server Application Pool.

7. Under the Actions pane, in Application Pool Tasks, click Stop.

   

   IIS: Stop Application Pool
   
   

8. Select Open iT Launcher Server again.

9. Under the Actions pane, in Manage Website, click Start.

   

   IIS: Start Website
   
   

10. Click Application Pools again.

11. Select Open iT Launcher Server Application Pool.

12. Under the Actions pane, in Application Pool Tasks, click Start.

    

    IIS: Start Application Pool

Remote Setup

If the App Launcher Server and Ingress are installed on separate machines, make sure that the App Launcher Server knows the Ingress URL to connect to, then restart the App Launcher Server website in IIS.

If the Ingress URL was not specified during App Launcher Server installation:

1. Go to the installation folder, which is C:\Program Files\OpeniT\Launcher by default.

2. Open the Ingress.json file.

3. Change the value of uri to the Ingress URL (e.g., https://customer.openit.com).

   Sample Ingress.json

   {
       "uri": "https://customer.openit.com",
       "checkSslValidity": false
   }

4. Save the file.

Once the Ingress URL is specified on the necessary configuration file:

1. Open the Internet Information Services (IIS) Manager.

2. Under the Connections pane, expand the root node and Sites.

   

   IIS: Home
   
   

3. Select Open iT Launcher Server.

4. Under the Actions pane, in Manage Website, click Stop.

   

   IIS: Stop Website
   
   

5. Click Application Pools.

   

   IIS: Application Pools
   
   

6. Select Open iT Launcher Server Application Pool.

7. Under the Actions pane, in Application Pool Tasks, click Stop.

   

   IIS: Stop Application Pool
   
   

8. Select Open iT Launcher Server again.

9. Under the Actions pane, in Manage Website, click Start.

   

   IIS: Start Website
   
   

10. Click Application Pools again.

11. Select Open iT Launcher Server Application Pool.

12. Under the Actions pane, in Application Pool Tasks, click Start.

    

    IIS: Start Application Pool