Manually Configuring the Core Server Connection to Ingress

Recommended reading: Ingress

This guide will walk you through connecting your Core Server to Ingress, assuming you have already installed or upgraded the Core Server before installing Ingress. Follow the set of instructions for your installation scenario:

• Core Server and Ingress are on the same machine
• Core Server and Ingress are on separate machines

Core Server and Ingress are on the same machine

Windows

1. Open the Task Manager.

2. Click Services.

3. Search for OpeniTRegistrar and restart it.

4. Open a command prompt with Administrator level privileges.

5. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd <bin_dir>
   Example

   cd C:\Program Files\OpeniT\Core\bin

6. Specify the Ingress API URI, run the command:

   Command Syntax

   openit_confinit -c "apicontroller.uri=https://<hostname>:<port>"

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   openit_confinit -c "apicontroller.uri=https://WIN-HOST01:443"

7. Update the configuration file, run the command:

   Command Syntax

   openit_confbuilder --server

   Make sure that there are no errors encountered.

Unix

1. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd <bin_dir>
   Example

   cd /opt/openit/bin

2. Restart the Open iT services, run the command:

   Command Syntax

   ./openit-all restart

3. Specify the Ingress API URI, run the command:

   Command Syntax

   ./openit_confinit -r /var/opt/openit/ -d /var/opt/openit/etc/ -c "apicontroller.uri=https://<hostname>:<port>"

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   ./openit_confinit -r /var/opt/openit/ -d /var/opt/openit/etc/ -c "apicontroller.uri=https://host01:443"
   note

   This command may display an error message but it actually completes successfully.

4. Update the configuration file, run the command:

   Command Syntax

   ./openit_confbuilder --server

   Make sure that there are no errors encountered.

Core Server and Ingress are on separate machines

Windows

1. Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration.

2. Look for the configuration file ingress.json and open with a text editor.

3. Modify the value of uri with the specific Ingress installation you want to connect to.

   ingress.json

   {
    "uri": "https://<hostname>:<port>",
    "checkSslValidity": false
   }

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   {
    "uri": "https://WIN-HOST01:443",
    "checkSslValidity": false
   }

4. Save the changes.

5. Open the Task Manager and restart the OpeniTRegistrar service.

6. Open a command prompt with Administrator level privileges.

7. Go to the bin directory, which is by default in C:\Program Files\OpeniT\Core\bin, run the command:

   Command Syntax

   cd <bin_dir>
   Example

   cd C:\Program Files\OpeniT\Core\bin

8. Specify the Ingress API URI, run the command:

   Command Syntax

   openit_confinit -c "apicontroller.uri=https://<hostname>:<port>"

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   openit_confinit -c "apicontroller.uri=https://WIN-HOST01:443"

9. Update the configuration file, run the command:

   Command Syntax

   openit_confbuilder --server

   Make sure that there are no errors encountered.

Unix

1. Go to the Configuration folder, which is by default in /var/opt/openit/etc/.

2. Look for the configuration file ingress.json and open with a text editor.

3. Modify the value of uri with the specific Ingress installation you want to connect to.

   ingress.json

   {
    "uri": "https://<hostname>:<port>",
    "checkSslValidity": false
   }

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   {
    "uri": "https://host01:443",
    "checkSslValidity": false
   }

4. Save the changes.

5. Go to the bin directory, which is by default in /opt/openit/bin, run the command:

   Command Syntax

   cd <bin_dir>
   Example

   cd /opt/openit/bin

6. Restart the Open iT services, run the command:

   Command Syntax

    ./openit-all restart

7. Specify the Ingress API URI, run the command:

   Command Syntax

   ./openit_confinit -r /var/opt/openit/ -d /var/opt/openit/etc/ -c "apicontroller.uri=https://<hostname>:<port>"

   where:

   • <hostname> - is the hostname of the machine installed with Ingress
   • <port> - is the port specified during Ingress installation
   
   
   Example

   ./openit_confinit -r /var/opt/openit/ -d /var/opt/openit/etc/ -c "apicontroller.uri=https://host01:443"
   note

   This command may display an error message but it actually completes successfully.

8. Update the configuration file, run the command:

   Command Syntax

   ./openit_confbuilder --server

   Make sure that there are no errors encountered.

Next Step?

After connecting the Core Server to Ingress, you may proceed with verifying the access to the Open iT Core Server web interface.

Accessing the Core Server Web Interface