Configure the UC port
This section provides information about how you can configure the UC port.
About the UC port
A UC port is the network port that UC uses to accept incoming connections from web browsers. The UC port is defined by the port number in the mc.uchostname setting in the console.properties file. For example:
mc.uchostname=https://uc-host.example.com:8433
In this example:
- https://uc-host.example.com is the UC host name.
- 8433 is the UC port.
- UC accepts HTTPS connections on port 8433.
Configure the UC Port
Configure the UC port to ensure that UC can accept incoming connections without conflicting with other services running on the host.
Overview
Administrators configure the UC port during installation or when resolving network port conflicts. UC uses the port specified in the mc.uchostname setting in the console.properties file. After you configure the UC port and restart UC, users should be able to access UC through the configured URL.
Step 1: Locate the configuration file
This step identifies the file that controls the UC endpoint and listening port.
Why it matters UC reads this setting at startup.
Configuration file /opt/vconsole/config/console.properties
Step 2: Configure the UC port
Edit the mc.uchostname property and specify the required port number.
Example
mc.uchostname=https://<host>:8433
To change the port, update only the port number.
mc.uchostname=https://uc-host.example.com:8434
Expected result The URL contains the required host name and port number.
- The URL format remains valid.
- The UC port is unique and available.
- Only the UC port number is changed.
Step 3: Restart UC
Restart the UC service to apply the configuration change.
Success UC starts normally and the login page loads on the configured UC port.
Failure The browser displays connection refused, page unavailable errors, or the UC login page does not load.
Example UC port in mc.uchostname
mc.uchostname=https://<host>:8433
Valid UC port range
| Requirement | Value |
|---|---|
| Type | Numeric only |
| Minimum | 1024 |
| Maximum | 49151 |
Provide only numeric identifiers for UC ports, as UC accepts only numeric values. UC rejects non-numeric values, negative values, values between 0 and 1023, and values above 49151.
Example errors
ERROR: port 80 in mc.uchostname is outside the usable range 1024-49151
ERROR: cannot start the service like this - refusing to start
Use different ports for MC and UC
Use separate ports for MC and UC because a port supports only one service at a time.
Example error
ERROR: UC BFF port 5450 conflicts with the MC port (console.port=5450)
Resolution Configure a unique port in mc.uchostname that differs from console.port and restart UC.