Framework Logistics Tablet Hosted Environment Setup

Article Index

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.

1. Open Windows Explorer.

2. Browse to: \[fw folder]\Setup\Insula Software Core Components\v16.x\

3. Double-click setup.exe. The Insula Software Components installation will begin.

4. Click the Next The Licence Agreement step will be displayed.

5. Select I accept the terms in the licence agreement.

6. Click the Next The Customer Information step will be displayed.

7. Enter User Name and Organisation

8. Select Anyone who uses this computer (all users).

9. Click the Next The Setup Type step will be displayed.

10. Select Complete.

11. Click the Next The Ready To Install the Program step will be displayed.

12. Click the Install button to begin the installation.

13. Click the Finish button to complete the installation.

Step 2 - Install Framework Logistics Tablet

1. Open Windows Explorer.

2. 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).

3. Double-click Framework Logistics Tablet.msi. The Welcome step will be displayed.

4. Click Next . The Licence Agreement step will be displayed.

5. Select I accept the terms in the licence agreement.

6. Click Next. The Customer Information step will be displayed.

7. Enter User Name and Organisation

8. Select Anyone who uses this computer (all users).

9. Click Next. The Setup Type step will be displayed.

10. Select Complete.

11. Click Next. The Ready To Install the Program step will be displayed.

12. Click Install to begin the installation.

13. 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.

1. Open Windows Explorer.

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

   
   
   

3. Double-click the relevant setup file. The Microsoft SQL Server Native Client installation will begin.

4. Click the Next The Licence Agreement step will be displayed.

5. Select I accept the terms in the licence agreement.

6. Click the Next The Registration Information step will be displayed.

7. Enter the registration details.

8. Click the Next The Feature Selection step will be displayed.

9. Click the Next The Ready To Install the Program step will be displayed.

10. Click the Install button to begin the installation.

11. Click the Finish button to complete the installation.

Step 4 - ODBC DSN Configurations

Provides the system with connections to the Framework databases.

ODBC DSN Configuration - Framework ECM

1. Open Data Sources (ODBC).

2. Select the System DSN

3. Click the Add The Create New Data Source dialog will be displayed.

4. Select SQL Server Native Client 10.0 (for SQL 2008, or SQL 2008R2) or SQL Server Native Client 11.0 (for SQL 2012)

5. Click the Finish The Create a New Data Source to SQL Server dialog will be displayed.

6. 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.

      

7. Click the Next

8. Click the Next

9. Tick: Change the default database to

10. From the drop-down list select: FworkSQLEcm

11. Click the Next

12. Click the Finish The ODBC Microsoft SQL Server Setup dialog will be displayed.

13. Click the Test Data Source...

14. If successful, click the OK

15. Click the OK The ODBC Microsoft SQL Server Setup dialog will close.

16. Click the OK The Data Sources (ODBC) Administrator dialog will close.

ODBC DSN Configuration - Framework Construction Logistics Tablet

1. Open Data Sources (ODBC).

2. Select the System DSN

3. Click the Add The Create New Data Source dialog will be displayed.

4. Select SQL Server Native Client 10.0.

5. Click the Finish The Create a New Data Source to SQL Server dialog will be displayed.

6. 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.

      

7. Click the Next

8. Click the Next

9. Tick: Change the default database to

10. From the drop-down list select: FworkSQLCstLTablet

11. Click the Next

12. Click the Finish The ODBC Microsoft SQL Server Setup dialog will be displayed.

13. Click the Test Data Source...

14. If successful, click the OK

15. Click the OK The ODBC Microsoft SQL Server Setup dialog will close.

16. 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.

1. Login to the hosted environment (e.g., Citrix or RDP).

2. Right-click a blank area of the Windows desktop and select New > Shortcut. The Create Shortcut dialog will be displayed.
   
   
   

   Open

   

   
   
   

3. 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\

4. 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.
   
   
   

   Open

   

   
   
   

5. Click the Next

6. Enter a shortcut name (e.g., Framework Logistics Tablet (Skip Host Validation)).

7. Click the Finish A shortcut will be created on the desktop.

8. Click the OK

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

Step 6 - Test Framework Logistics Tablet

Tests the installation of Framework Logistics Tablet.

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

    

2. 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.