| Table of Contents |
|---|
Basics
The Web Manager uses a predefined startup configuration to listen on a set of endpoints to be accessible from a web browser.
In order to access the Web Manager in a secure manner via HTTPS, the application uses a certificate which network configuration specifies:
- http and https ports for the Web Manager application
- http and https ports for web-base visualizations
- the used certificate for https connections
The certificate for https connection can either be automatically generated or provided by the integrator.
IP addresses / host names
The Web Manager always listens on the following IP addresses and host names:
- localhost
- 127.0.0.1
- Computer name (e.g. john-pc)
- Full computer name (e.g. john-pc.company.com, in case your computer is part of a domain)
- All available IP addresses (e.g. 172.16.1.150)
Ports
...
To avoid conflicts with other web applications on the same machine, the Web Manager uses the following ports by default:
...
The default TCP ports are
Application | HTTP | HTTPS |
|---|---|---|
| Web Manager | 21000 | 21001 |
| Web Visualization | 80 | 443 |
Emerging URLs
For each pair of IP address/host name and port, the Web Manager listens on the http port as well as on the https port using the respective protocol.
Make Always make sure to always use the http protocol with the regular part and the https protocol with the secure port. The URLs are concatenated as follows: <http|https>://<ip|host>:<port|secureport>
Find out which URLs are being used on your machine
Some examples are:
Advanced
| Note |
|---|
Please note that the Web Manager needs to be restarted for any changes to take effect. |
If you want to To use different ports or a custom certificate to access the Web Manager, you can change the configuration file accordingly.
...
Ports
If you want to access the Web Manager or Visualization on different ports, change them accordingly and restart the Web Manager.
using the Service Control application.
Certificate
As mentioned in the basic setup above, the Web Manager uses an automatically generated certificate by default in order to access the Web Manager using https.
However, if you want to use a custom certificate for the web managerWeb Manager, for example when accessing the Web Manager externally, do the following:
- To import a certificate or determine where a certificate you want to use is located, open the windows certificate manager (Press the windows key or click the windows button in the taskbar, enter certmgr and open the certificate manager)
- Select the desired store (for example Personal\Certificates)
- Double click the certificate you want to use (for example localhost)
- Select the Details tab and note the subject name of the certificate.
- Open the configuration file file <install-dir>\WebManager\global_config\config.xml and remove the start and end of the comment ("<!–" and "-->") in the certificate section so that it looks like this:
- Use "storename" and "subject" to point to the certificate you just opened.
- As "storename", use the identifier of the certificate's store (for example My is the identifier of the store Personal\Certificates), which can be one of the following:
Refer to the official documentation to learn more about this topic.
Help
How do I find out my IP address(es)?
- Open a command line window and run the ipconfig command.
- The IP address for each interface is shown in the resepctive IPv4 Address line.
How do I find out my computer name?
- Press and hold the Windows key, then press the "Pause" key => the system configuration opens. Note the computer name and the full computer name:
| Anchor | ||||
|---|---|---|---|---|
|
- Open the Web Manager log file. In a typical installation this is C:\Program Files (x86)\NETxAutomation\BMS . Platform.2018\WebManager\log_files\nxaWebManagerLog.txt.
- Scroll to the top and look for log entires similar to those shown below
...