Installing setup R3 (4.3.xxxx)
General information
This information assumes a system where our software gets installed the first time, i.e. when no upgrade needs to be performed. For upgrading, visit this guide: https://netxautomation.atlassian.net/wiki/x/A4Auvw
When the setup gets executed, you will be guided through the installation steps that are described in this article. You can download the setup from our homepage. You may need to create an account to get to the download section. The setup contains the MP Server as well as the BMS platform. Both get installed with this single setup (compared to version R2, which had two different setup files). The product will be chosen during the setup.
The installation does not require a license. After the installation, the software runs in a demo mode, if there is no NETx dongle found.
Prerequisites
Executing the setup will prompt for administrator rights. Confirm that and you start the setup. Our software requires some libraries, which may be installed on the system already, due to other software that had installed them. If this is not the case, they will be installed by the setup. So the first step will likely be:
Click install to install the prerequisite. It may require to restart the machine for this step. The setup should be started automatically after the restart, to continue the installation. If this is not the case, just start the setup again. It will detect that the libraries are installed now and do show this step again.
Configuration of the installation
The next step is starting the wizard of the installation which will guide through the things that can be configured.
Click Next to proceed and accept the License Agreement in the next step.
Click Next and confirm or change the installation location. We recommend to leave the predefined location. If you change it, please keep in mind that articles in the knowledge base often refer to this path. If you use a different one, you need consider that when you see those paths in the knowledge base.
Product selection
In the next step you can choose the product. The three options are:
BMS Platform R3
MP Server
Visualization only (relevant only if a BMS Platform instance is already installed on a different host)
Additional configuration steps for BMS Platform
Skip this if you install MP Server or Visualization. If you install the BMS Platform, some further configuration steps need to be carried out.
Set a password
As the BMS Platform contains a user management, a first user must be created, whose name will be admin. Choose a password according to the described rules or accept the suggested one. Safe this password in order to log in Web Manager and Visualization later.
Write the password down or remember it in some other way. If you do not remember the password later, you need to contact the support or uninstall and reinstall the software.
Choose a database system
The BMS Platform works with a database. The setup contains a database MariaDB that can be installed as well.
Option 1: Install a MariaDB instance
If you go with this option, you need to provide a name for the service (MariaDB runs as a Windows Service in the background), a port and a password for the database user root. These settings will be entered in the next two steps. You can write down the password, though the password can be found in the configuration of the first created password after the installation has completed.
The installation of MariaDB includes the database client HeidiSQL by default. You can use this software to open and look into the databases of the BMS Platform. A link will be created on the desktop.
If the setup detects an already existing MariaDB instance on the machine, a warning will be shown and the installation must be continued with one of the two other options (use existing or no database). Please note: If the existing instance is an older one, a warning will be logged, telling that MariaDB should be updated. This is just in information and not an error. BMS Platform will run also with older versions. You can find a new version of MariaDB in the Core\Setup folder within the installation directory. Update can be installed when the server does not run.
Option 2: Use an existing SQL database
Configure how the database can be accessed. The BMS Platform allows to use an existing MariaDB or MS SQL Server database.
Leave Database name empty, as it will be automatically set when a new workspace gets created. Instance is the Windows service name of the MS SQL Server database system and is only required if that kind of database shall be used.
Option 3: Do not use SQL Database
The BMS Platform can also run without a database. Some features will not be available with this option then. However, it is possible to install a database at a later point in time. The workspace can be configured later, to use a database.
Start of the installation process
Now the installation can be started by clicking on the the Install button. The process may take some time until it gets finished (between 1 to 5 minutes, approximately).
The process may open console, which will be automatically be closed. Just let the installation process run.
After installation
When the installation is completed, the last step will be shown. Depending on your system, you may be prompted to restart it.
If the BMS Platform has been installed, the Service Control will be started automatically and gets shown:
If the BMS Platform or the MP Server was installed (not the Visualization), the server will be started in the background. This can be also seen in the Service Control. You can now start the Core Studio to set up your workspace. Links to the major parts of the software will be created on the desktop.
Changing the installation
If the setup gets executed again, the installed product can be changed. If you have installed the Visualization or MP Server, you can upgrade to BMS Platform.