Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 also uses an automatically generated certificateuses a certificate which 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 (for example e.g. john-pc)
  • Full computer name (for example e.g. john-pc.company, in case your computer is part of a domain)
  • All available IP addresses (for example 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:

  • 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 Make sure to always use the http protocol with the regular part and 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

Note

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


If you wish want 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 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 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  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 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 (Press the windows key or click the windows button in the taskbar, enter "cmd" and open the command prompt)
    Image Removed
    Type "ipconfig" and press enter, then note the "IPv4 Address" (in this case "172.16.1.150")
    Image Removedand run the ipconfig command.
    Image Added
  • 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 Windows key, then press the "pausePause" key => the system configuration opens, note . 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?

  • Have a look at Open the Web Manager log fileIn the insallation folder of BMS Platform 2018 (usually . In a typical installation this is C:\Program Files (x86)\NETxAutomation\BMS.Platform.2018), open the folder \WebManager\log_filesOpen the file \nxaWebManagerLog.txt.
  • Scroll to the top and look for log entires similar to those shown below

...