MCS Server Installation

From MCS

Info

Latest builds can be found in the following directory on the projects drive

P:\Development\MCS\Release Logs\Release

The release notes and change log can be found at the following location, it will be the developers responsibility to fill in these documents

P:\Development\MCS\Release Logs

LFS is currently the only client which uses MCS the QA box can be accessed from IP 172.151.45.173

Dependencies

  1. .NET Framework 4.7 Runtime
  2. Oracle Client 11.0.2 or 11.0.3
  3. Oracle ODT with ODAC 11.2.0.3

General Release Process

Copy the latest build zip file to server(I usually do to the desktop for convenience, then delete when I’m finished)

Extract zip file to a new directory somewhere on the box( for example C:\Program Files (x86)\OBS Logistics\MCS)

Contents of directory should looks as follows

MCS ServerInstall1.png


Open the "inetmgr" program

MCS ServerInstall2.png


Right click sites, then "Add Web Site.." Enter the site information in the following popup,

  • Site name – internal reference(product name and client e.g. "MCS_NOMS")
  • Physical path should be the directory the MCS source files where extracted to
  • The "connect as" button is used for configuring security settings, this should be left at the default "pass-through authentication"
  • The port will need to be unique for the box
  • I believe https certificates are usually applied using a reverse-proxy apache server, so leave the type on "http"

MCS ServerInstall3.png


By default, creation of a new site in IIS will create a new Application Pool of the same name. This must be capable of running 32bit apps. To achieve this:

Note the Application Pool created, or find by clicking the site in the Connections explorer, and clicking Advanced Settings in the action pane.

MCS ServerInstall3a.png


Click Application Pools in the Connections explorer, click the application pool and click Advanced Settings in the Actions pane. Double-click Enable 32-Bit Applications to set the value to True and click OK.

MCS ServerInstall3b.png


The app configuration is done through the web config file, the "MessageFile" and "knownBadListFile" will need their location updating, while the email addresses and the "connectionString" will need updating for the specific client.

MCS ServerInstall4.png


Session State Service

In addition to the site setup the following service may need some setup as well

The application uses the ASP session state service to handle sessions. You’ll need to ensure that the session state service is enabled and started on your pc.

MCS ServerInstall5.png


Advise that you change it to automatic startup if it is currently set to "Manual"

MCS ServerInstall6.png