Install MongoDB on the primary replica set member

Install MongoDB

The MongoDB installation, and the replica set initialization and configuration, should be done on the primary through the scripts with the settings as defined in the Setup.xml. The script execution should not require user interaction (aside from that to execute the script and enter the MongoDB user’s password).

# Procedure Expected Result

1

Log into the server, where MongoDB primary instance is to be installed with an administrative account (domain user) using Remote Desktop console session.

In CMD Shell, type:

MSTSC /v:D-GXPC-RepA

Execute this command by pressing ENTER/RETURN.

Successful login on machine with administrative account.

2

Open File Explorer and browse to the installation directory (e.g. D:\installation)

Folder contains 7 files as shown in pre-requisites.

3

In File Explorer, go to the File Menu, select Open Windows PowerShell, and select "Open Windows PowerShell as administrator"

Start PowerShell

PowerShell with administrative privileges is available.

4

Execute the command to run the installation script by typing

.\install.ps1

The script starts, executes without user intervention, and ends successfully.

5

During the installation you will be asked to enter the MongoDB admin user’s password.To do that, go to the Master-Core machine, Open Data Studio and select System. In the Object Properties Panel, select Time Series Data Stores, then underneath MongoDB Connection select Password and copy it.

MongoDB Copy Password

MongoDB admin user’s password was copied to the clipboard.

6

Go back to the Primary replica set node and paste the password in the Powershell Window and hit enter.

(If the clipboard is not shared between servers, use a secondary method to transfer the password between machines - such as temporarily visualizing in a document and typing manually with care.)

Paste dbadmin password

the script ends successfully with the message "Installation Complete". No errors are shown.

Test Installation - Log file

Ensure there is no error recorded in the log file during the installation.

# Procedure Expected Result

1

Go to the installation directory (D:\installation) and open the install log file (install.log.txt) Make sure that the installation was completed without errors.

No error recorded in the log file during the installation.

Detailed Testing

The following sections are intended for use only during the initial deployment (first use) of the installer script (install.ps1) following which successful execution of the script (step 4 in the previous section) will be assumed to have deployed as per the detailed sections below. Therefore it is only necessary to check deployment with the sections below once (although any user may decide to implement the detailed tests on an ad-hoc basis).

Test Installation - Firewall

Ensure Windows Firewall settings reflect requirements as defined in the Setup.xml file.

# Procedure Expected Result

1

Open a Window command prompt and type wf.msc.

Windows Firewall with advanced security is opened.

2

Inbound Rules - order rules using "Name" by clicking the Name column header. Scroll down to find the two created inmation rules as shown below. Check the highlighted items for consistency with the setup XML file.

Inbound Firewall Rules
  • Connector Service rule reflects the "Name" set in the settings XML file (e.g. AspenTech Inmation Connector Service (D)).

  • Program locations reflect the "InstallationFolder" set in the XML file (e.g. D:\AspenTech\inmation.root\).

  • The Local Port for the Core Service reflects the ConnectorCoreServerPor set in the XML file (e.g. 6512).

3

Outbound Rules - order rules using "Name" by clicking the Name column header. Scroll down to find the single created inmation rule as shown below. Check the highlighted items below for consistency with the setup XML file.

Outbound Firewall Rules

Close the Windows Firewall application when checks are completed.

  • Connector Service rule reflects the "Name" set in the settings XML file (e.g. AspenTech Inmation Connector Service (D)).

  • Program locations reflect the "InstallationFolder" set in the XML file (e.g. D:\AspenTech\inmation.root\).

Test Installation - Service

Ensure that the correct windows service has been installed.

# Procedure Expected Result

1

Open a Window command prompt and type services.msc.

Windows Services application is opened.

2

Check the expected MongoDB installed service is present and running by verifying the item highlighted as below.

MongoDB Service

Close the Services application when verification is complete.

MongoDB service is present and running; the Name as set in the XML file is reflected in the service name.

3

Check the installed Connector service is present and running by verifying the item highlighted as below.

AspenTech Inmation Services

Close the Services application when verification is complete.

Connector service is present and running; the Name as set in the XML file is reflected in the service name.

4

Go back to the Master Core machine and use DataStudio to check the Connector, the System object and the custom Data Store objects' status.

MongoDB Connector Object Properties

The status the Connector, the System object and the custom Data Store objects is good (Green).

Common, Object Name reflects OverrideObjectName setting of the XML file.