Basic
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 also uses an automatically generated certificate.
IP addresses / host names
The Web Manager always listens on the following IP addresses and host names:
- localhost
- 127.0.0.1
- Computer name (for example john-pc)
- Full computer name (for example john-pc.company, in case your computer is part of a domain)
- All available IP addresses (for example 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:
- 21000 (http)
- 21001 (https for secure access)
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.
Remember to always use the https protocol in combination with the secure port and vice versa. 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:
and so on ...
Advanced
Please note that the Web Manager needs to be restarted for any changes to take effect.
If you wish to use different ports or a custom certificate to access the Web Manager, you can change the configuration file accordingly.
- In the insallation folder of BMS Platform 2018 (usually C:\Program Files (x86)\NETxAutomation\BMS.Platform.2018), open the folder WebManager\global_config
- Open the file config.xml in a notepad
- The file should look similar to this
Ports
If you want to access the Web Manager or Visualization on different ports, just change them accordingly
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 manager, for example when accessing the Web Manager externally, change the configuration as follows:
- 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 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:
Have a look at the official documentation to learn more about this topic.
Help
How do I find out my IP address(es)?
- Open a command line window (Press the windows key or click the windows button in the taskbar, enter "cmd" and open the command prompt)
- Type "ipconfig" and press enter, then note the "IPv4 Address" (in this case "172.16.1.150")
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 full computer name
How do I find out all URLs the Web Manager is listening on?
- Have a look at the Web Manager log file
- In the insallation folder of BMS Platform 2018 (usually C:\Program Files (x86)\NETxAutomation\BMS.Platform.2018), open the folder WebManager\log_files
- Open the file nxaWebManagerLog.txt
- Scroll to the top and look out for log entires similar to this, these are the listener URLs of Web Manager and Web Visualization:
