We’re upgrading your documentation experience!

A new doc website is live at docs.openit.cloud — a temporary preview during our transition. This website is now in maintenance-only mode (only critical issues will be addressed).

Explore the new website and send us your feedback!

# Manually Configuring the Core Server Connection to Ingress

Recommended reading: Ingress

Here are the required steps if you installed/upgraded the Core Server first before installing Ingress.

Follow the set of instructions for your installation scenario.

# Core Server and Ingress are on the same machine

Open the Task Manager.
Click Services.
Search for OpeniTRegistrar and restart it.
Open a command prompt with Administrator level privileges.
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
```
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://desktop123win:443"
```
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

Go to the Configuration folder, which is by default in C:\Program Files\OpeniT\Core\Configuration.
Look for the configuration file ingress.json and open with a text editor.
Modify the value of uri with the specific Ingress installation you want to connect to.
ingress.json
```
1 |  {
2 |    "uri": "https://<hostname>:<port>",
3 |    "checkSslValidity": false
4 |  }
```
where:
- <hostname> - is the hostname of the machine installed with Ingress
- <port> - is the port specified during Ingress installation
Example
```
1 |  {
2 |    "uri": "https://desktop123win:443",
3 |    "checkSslValidity": false
4 |  }
```
Save the changes.
Open the Task Manager and restart the OpeniTRegistrar service.
Open a command prompt with Administrator level privileges.
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
```
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://desktop123win:443"
```
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 the same machine

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
```
Restart the Open iT services, run the command:
Command
```
 ./openit-all restart
```
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://desktop123win:443"
```
This command may display an error message but it actually completes successfully.
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

Go to the Configuration folder, which is by default in /var/opt/openit/etc/.
Look for the configuration file ingress.json and open with a text editor.
Modify the value of uri with the specific Ingress installation you want to connect to.
ingress.json
```
1 |  {
2 |    "uri": "https://<hostname>:<port>",
3 |    "checkSslValidity": false
4 |  }
```
where:
- <hostname> - is the hostname of the machine installed with Ingress
- <port> - is the port specified during Ingress installation
Example
```
1 |  {
2 |    "uri": "https://desktop123win:443",
3 |    "checkSslValidity": false
4 |  }
```
Save the changes.
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
```
Restart the Open iT services, run the command:
Command
```
 ./openit-all restart
```
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://desktop123win:443"
```
This command may display an error message but it actually completes successfully.
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