Installing Argos Bailment Website

Installing Argos Bailment Website

Installing Argos Bailment Website

Ensure ALL users are logged out of the Bailment Website. 
Double click on the "Setup" icon in the Bailment Web folder of the latest Argos Vault Release, \Bailment.Web.
Refer to the section Upgrading Argos Vault for further Instructions.
 

New Installation

If this is a new installation of a Bailment the following dialog will display:

 



Select the Application Pool - .NET v4.5 Classic


 




 
 

Upgrade of same version

If this is an upgrade of the same version of the Bailment Website the following dialog will display:


Click Repair Argos Bailment and to complete the upgrade.

Version Error on Install

Rarely, the user may get a version error after installing the Bailment Web site.  If this happens, a reset of IIS (Internet Information Services) is required.
Click Start – Type cmd in the box which reads Search program and files.  The following screen will appear.

 

Right mouse click on cmd.exe and select Run as administrator

 

If a screen asks for confirmation to run the cmd application, click Yes

The following screen will appear.

 

Type iisreset at the prompt and [Enter]

 

Type exit at the prompt to return to the Windows desktop / the applications you previously had running.

Configuring the Argos Bailment Website

It is important that the system is properly set up for the website to operate correctly.  That requires a number of applications to be installed on the web server and some system security settings to be in place.

Required Supporting Applications 

Ensure the following applications are installed on the web server
  1. IIS 
  2. .Net 4.8 Framework
  3. ASP.Net 4.5
  4. VC++ 2017 Redistributables
  5. Adobe Acrobat Reader

Required System Files

In order to run the website a number of dependent files need to be copied to the System32 folder.  These are found on the Release download file under Utils\SystemFiles. 
  1. crpaig32.dll
  2. crpe32.dll
  3. implode.dll
  4. boost_thread-vc100-mt-1_44.dll
In the event that these files already exist in the system32 folder DO NOT overwrite the existing files.  Attempt to run the website with the existing files and if this results in an error then you should contact Argos Support for assistance.

Impersonation Settings

The website needs to run under a windows user account in order to access resources on the network such as the SQL Database and the ASP.Net folders which the web server uses to run the application.    
  1. Set up a windows user account which the website will use as the impersonation identity.
  2. Set this user up within SQL Server so that it has permissions to access the Argos Vault SQL Database
  3. Set the security permissions for the C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files folder so that this user has ‘modify’ permissions.
  4. Create the IdentitySettings.config file and specify the user details.  
    1. Copy the IdentitySettings.config.example file and rename it IdentitySettings.config. 
  5. The example file can be found in the root folder of the installed website.  
    1. Open the file in notepad and set the username and password details
      <identity impersonate="true" userName="<domain>\<username>" password="<password>"/>

Database Connection Settings

Create a ConnectionSettings.config file to specify the Argos Vault database connection to use for the Websites.
  1. Copy the ConnectionSettings.config.example file and rename it ConnectionSettings.config.  The example file can be found in the root folder of the installed website.  
  2. Set the connection details. Note that an ODBC DSN must be set up on the Web Server to connect to the Argos Vault database.  (For further information on setting up the ODBC DSN refer to the document Argos Vault Installation Instructions.)  The name given to this DSN should be specified in the name=<dsn_name> parameter.  
  1. <add name="<dsn_name>" connectionString="Data Source=<server_name>;Initial Catalog=<database_name>;Integrated Security=True" providerName="System.Data.SqlClient" />

Themes

Themes allow the web site to be personalised to reflect your marketing standards. The Bailment website has a default theme/style, but an alternative theme can be used.

Theme names are determined by the folder names under the \Assets\Themes folder in the root folder of the installed website. The theme is specified in the CssThemes.config file. 

To change the theme:
  1. Copy the CssThemes.config.example file and rename it CssThemes.config.  The example file can be found in the root folder of the installed website.  
  2. Add a new theme by adding a new folder under the themes folder and setting that as the theme name in the CssThemes.config.
  3. If the name of the theme specified in the CssThemes.config cannot be found, the "Default" theme will be used.
  1. <?xml version="1.0"?>
  2. <!-- Css Themes
  3. themeName - The name of the style folder to use. Default is "Default"
  4. rootCssFilename - Filename of css file. Default is "Root.css"
  5. themePath - Path (virtual, absolute or full url) to styles folder. Default is "~/Styles"-->
  6. <cssThemes themeName="default"></cssThemes>

Log Files

These are written to the directory \App_Data\Logs found in the root folder of the installed website.  

    • Related Articles

    • Installation Instructions

      Summary This set of documents details the initial setup requirements for the Argos software. It is recommended that the installation checklist from the appendices is printed as a step by step guideline for the installation task being undertaken. The ...
    • Installing Argos Bailment

      Argos Bailment Installing the Bailment Module Application Note: Argos Bailment is a licenced module that is run independently of Argos Vault. If you are not licenced for this module, then this section can be disregarded. New Installations Double ...
    • Installing Argos Internal API

      The Argos Internal API is used to power the Vault and Bailment applications. Note, this is available from Argos v6.0 onwards Installation Types The installer can be used to install a production instance of the Argos Internal API. Instructions to ...
    • Bailment.Web Server Configuration

      Purpose This document outlines the steps required to install Bailment.Web on a Windows Server Windows Server 2012 is used as an example Windows Components From the Server Manager Dashboard select “Add Roles and Features”. Select the server you wish ...
    • Installation Prerequisites

      Prerequisites The following section outlines the third-party applications required to successfully run Argos. The below applications are not provided as part of the Argos application and it is the responsibility of the client to purchase/licence, ...