This guide will assist administrators in the setup and installation of Framework Logistics Tablet in a hosted environment.

Pre-Requisite Checklist

The following pre-requisite items are required:

A server with the hosted Framework Logistics Tablet database.

Step 1 - Install Core Components

Installs a set of common software tools used by the Framework Product Suite.

If installing on Microsoft Windows Vista or above, the User Account Control (UAC) Consent prompt may be displayed.

Open Windows Explorer.
Browse to: \[fw folder]\Setup\Insula Software Core Components\v16.x\
Double-click setup.exe. The Insula Software Components installation will begin.
Click the Next The Licence Agreement step will be displayed.
Select I accept the terms in the licence agreement.
Click the Next The Customer Information step will be displayed.
Enter User Name and Organisation
Select Anyone who uses this computer (all users).
Click the Next The Setup Type step will be displayed.
Select Complete.
Click the Next The Ready To Install the Program step will be displayed.
Click the Install button to begin the installation.
Click the Finish button to complete the installation.

Step 2 - Install Framework Logistics Tablet

If installing on Microsoft Windows Vista or above, the User Account Control (UAC) Consent prompt may be displayed.

Open Windows Explorer.
Browse to: \[fw folder]\Setup\Framework Logistics Tablet\vx.x.x\Setup\ (where x.x.x refers to the latest version of Framework Logistics Tablet).
Double-click Framework Logistics Tablet.msi. The Welcome step will be displayed.
Click Next . The Licence Agreement step will be displayed.
Select I accept the terms in the licence agreement.
Click Next. The Customer Information step will be displayed.
Enter User Name and Organisation
Select Anyone who uses this computer (all users).
Click Next. The Setup Type step will be displayed.
Select Complete.
Click Next. The Ready To Install the Program step will be displayed.
Click Install to begin the installation.
Click Finish to complete the installation.

Step 3 - Install Microsoft SQL Server Native Client

Installs the native client for Microsoft SQL Server. This driver allows the hosted environment to connect to the Microsoft SQL Server that hosts the Framework Logistics Tablet database.

Open Windows Explorer.
Browse to: \[fw folder]\Setup\Database - MSSQL\Microsoft - SQL Server Native Client Driver\

Install the correct Microsoft SQL Server Native Client Driver (2008 or above) based on the version of Microsoft SQL Server installed on the server.
Double-click the relevant setup file. The Microsoft SQL Server Native Client installation will begin.
Click the Next The Licence Agreement step will be displayed.
Select I accept the terms in the licence agreement.
Click the Next The Registration Information step will be displayed.
Enter the registration details.
Click the Next The Feature Selection step will be displayed.
Click the Next The Ready To Install the Program step will be displayed.
Click the Install button to begin the installation.
Click the Finish button to complete the installation.

Step 4 - ODBC DSN Configurations

Provides the system with connections to the Framework databases.

Microsoft 64-Bit Operating Systems include two ODBC Data Source Administrator executable files.

Depending on the operating system, use the following to open the correct ODBC Data Source:
On 32-Bit Operating Systems: Use either:
Start Menu > Control Panel > Administrative Tools > Data Sources (ODBC)
OR
\\%SystemRoot%\system32\odbcad32.exe (e.g., C:\Windows\system32\odbcad32.exe).

On 64-Bit Operating System: Use:
\\%SystemRoot%\SysWOW64\odbcad32.exe (e.g., C:\Windows\SysWOW64\odbcad32.exe).

ODBC DSN Configuration - Framework ECM

Open Data Sources (ODBC).
Select the System DSN
Click the Add The Create New Data Source dialog will be displayed.
Select SQL Server Native Client 10.0 (for SQL 2008, or SQL 2008R2) or SQL Server Native Client 11.0 (for SQL 2012)
Click the Finish The Create a New Data Source to SQL Server dialog will be displayed.
Enter the following details:
- Name: FworkSQLEcm
- Description (optional): Enter a description for the database connection. For example, Framework ECM.
- Server: Select the SQL Server from the Server drop-down list.
  OR
  Enter the SQL Server name.
  
  If there is an error following Step 8, change the server name above to: \[server name]\SQLEXPRESS
Click the Next
Click the Next
Tick: Change the default database to
From the drop-down list select: FworkSQLEcm
Click the Next
Click the Finish The ODBC Microsoft SQL Server Setup dialog will be displayed.
Click the Test Data Source...
If successful, click the OK
Click the OK The ODBC Microsoft SQL Server Setup dialog will close.
Click the OK The Data Sources (ODBC) Administrator dialog will close.

ODBC DSN Configuration - Framework Construction Logistics Tablet

Open Data Sources (ODBC).
Select the System DSN
Click the Add The Create New Data Source dialog will be displayed.
Select SQL Server Native Client 10.0.
Click the Finish The Create a New Data Source to SQL Server dialog will be displayed.
Enter the following details:
- Name: FworkSQLCstLTablet
- Description (optional): Enter a description for the database connection. For example, Framework Construction Logistics Tablet.
- Server:Select the SQL Server Database on which Framework ECM is installed on your Network.
  OR
  Enter the SQL Server name.
  
  If there is an error following Step 8, change the server name above to: \[server name]\SQLEXPRESS
Click the Next
Click the Next
Tick: Change the default database to
From the drop-down list select: FworkSQLCstLTablet
Click the Next
Click the Finish The ODBC Microsoft SQL Server Setup dialog will be displayed.
Click the Test Data Source...
If successful, click the OK
Click the OK The ODBC Microsoft SQL Server Setup dialog will close.
Click the OK The Data Sources (ODBC) Administrator dialog will close.

Step 5 - Create A New Framework Logistics Tablet Shortcut

Before creating a new Framework Logistics Tablet shortcut, please ensure that Framework Logistics Tablet is installed in the hosted environment.

Login to the hosted environment (e.g., Citrix or RDP).
Right-click a blank area of the Windows desktop and select New > Shortcut. The Create Shortcut dialog will be displayed.
Enter or browse to the location of the Framework Logistics Tablet executable file (exe).
- Typically: C:\Program Files\Insula Group Pty Ltd\Framework CstLTablet\Bin\
Once the location of the .exe file has been entered or selected, add the following command line switch after the end quote ("): -skipHostValidation. The following image is an example.
Click the Next
Enter a shortcut name (e.g., Framework Logistics Tablet (Skip Host Validation)).
Click the Finish A shortcut will be created on the desktop.
Click the OK

To run the software, double-click the new Framework Logistics Tablet desktop icon.

The shortcut:

Can be published to the hosted environment.
Can be copied to the appropriate Windows Start Menu location, if required.

Step 6 - Test Framework Logistics Tablet

Tests the installation of Framework Logistics Tablet.

Start Framework Logistics Tablet (Start > All Programs > Insula Software > Framework Logistics Tablet).

Double-click the Logistics Tablet desktop icon.
Logon to the system using the password created in the Logistics Tablet Database setup.

Troubleshooting

When opening the Framework Logistics Tablet software, the system checks if the local site name (in this case, the hosted environment site name) is configured in Framework Logistics Desktop. If the following error occurs, ensure the -skipHostValidation command line switch was correctly implemented in Step 5 - Create a New Framework Logistics Tablet Shortcut.

Step 7 - User Acceptance Tests

The following is a list of view only tests that should be performed after updating the application.

Screen / View	Menu Path	Completed
Start Framework Construction Logistics Tablet
Log in as the assigned user for the Tablet PC
View all screens using the Home page
View all screens using the Toolbar

Browser not supported