Networking for BMS 4 server installation - IntegratedBreedingPlatform/Documentation GitHub Wiki

Note

See 4.0 Server Installation Instructions for the initial steps.

Whitelist ports to make BMS URL accessible

The BMS link takes the form: http://<IP_address_of_the_server>:48080/ibpworkbench/controller/auth/login

To allow users to access the BMS from any browser, the firewall of the server has to be modified to whitelist port 48080.

Launch Windows Firewall of the server and go to Advanced Settings. Create new Inbound and Outbound rules for the port 48080.

a. Create New Inbound rule

Click Inbound rule › New Rule and choose Port.

Add 48080 on Specific local ports.

Choose Allow the connection on the next screen.

  • Choose all (or a few) profiles this rule applies to.
  • Provide a name for this rule – Ex. BMS 4 and click Finish.

b. Create New Outbound rule

Add a new Outbound rule for port 48080 similar to adding an inbound rule.

  • Click Outbound rule › New Rule and choose Port.
  • Add 48080 on Specific local ports.
  • Choose Allow the connection on the next screen.
  • Choose all (or a few) profiles this rule applies to.
  • Provide a name for this rule – Ex. BMS 4 and click Finish.

How to Edit BMS SMTP Settings

These directions apply to the settings for the Forgot Password and Ask Support emails that the BMS will send to users.

Default SMTP Settings

Below are the default SMTP values for both Forgot Password and Ask Support widget.

  • host: ibpmail.imgx.ca
  • port: 465
  • protocol: SMTPS
  • username: (hidden)
  • password: (hidden)

Using Different SMTP Settings

Clients may use their preferred server that adheres to their network policies. If you prefer to use your own SMTP server, you will need to provide these details:

  • SMTP Host
  • Protocol
  • Port
  • Username
  • Password

Example using YahooMail:

A. Edit workbench.properties located here:

C:\BMS4\infrastructure\tomcat\webapps\ibpworkbench\WEB-INF\classes

Find the similar lines below, replace the values with your own SMTP details

Settings for smtp

  • mail.server.host=(SMTP Host)
  • mail.server.port=(Port)
  • mail.server.protocol=(SMTPS or SMTP)
  • mail.server.username=(username or email)
  • mail.server.sender.email=(username or email)
  • mail.server.password=(ThePassword)
  • reset.expiry.hours=24

B. Save the changes

C. Restart TomCat

Most companies and service providers block ports 25 and 465 to prevent spam. Below are some possible scenarios if a user does not receive email after requesting a password reset (the following requires familiarity with technical terms and server interface – when in doubt please contact your IT helpdesk or request IBP support):

  • The server where BMS is installed is not connected to the internet
  • Your Windows Firewall or personal anti-virus is blocking the connection, please allow port 465 (see instructions for whitelisting ports at the top of this page.)
  • Port 465 is blocked by your service provider, please request if it can be opened
  • Use a different port number and configure BMS to follow that

For deployments without internet access, you will need to setup your own SMTP server and modify workbench.properties, otherwise the Forgot Password feature won’t work. Please ask assistance from your server administrator.

How to test if your outgoing port 465 is open

(free online tool)

Open Windows Powershell where BMS is installed, copy and paste the following command:

Test-NetConnection -InformationLevel detailed -ComputerName portquiz.net -Port 465

Result when port is Open

Result when port is Closed

Update Microsoft Runtime Libraries when Resolvable Incomplete Block design via Manage Trial is failing

Breeding View is a 32-bit app built using Visual Studio 2008 and so it requires the runtime libraries x86 version for 2008 SP1. BMS runs the package from the Breeding View when generating trial designs. When choosing Resolvable Incomplete Block design from Manage Trials is giving an error (pls. see image & JIRA below), pls. download the file and follow the installation steps to update the Microsoft runtime libraries on the server.

More information: https://www.microsoft.com/en-us/download/details.aspx?id=29

This resolves the previous issue encountered when selecting the Resolvable Incomplete Block Design.
and displays this error:

Deploying BMS from an Amazon EC2 service

After BMS has been installed on Amazon’s EC2 instance, whitelist port 48080 thru EC2 dashboard › Network and Security › Security Groups

Add inbound rule for port 48080 via Custom TCP Rule. It’s recommended to specify the source or IP addresses, if known, for added security.

This is the default outbound rule that allows all outgoing traffic from the server. Customize outbound rule as needed.