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, 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 application uses the following ports by default:

• 21000 (http)
• 21001 (https for secure access)

Default values for ports for web-based visualization are

• 80 (http)
• 443 (https)

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 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:

• http://localhost:21000
• https://john-pc:21001
• http://127.0.0.1:21000
• https://172.16.1.150:21001

Advanced

...

• 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, change them accordingly and restart the Web Manager.

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, 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 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
urls urls

How do I find out all URLs the Web Manager is listening on?

• 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
  
  

...