Web Manager network configuration

Basics

The Web Manager 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

The default TCP ports are

Application

HTTP

HTTPS

Web Manager2100021001
Web Visualization80443

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.
Always make sure to 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

Please note that the Web Manager needs to be restarted for any changes to take effect.


To use different ports to access the Web Manager, change the configuration 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, 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 <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:

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\WebManager\log_files\nxaWebManagerLog.txt.
  • Scroll to the top and look for log entires similar to those shown below