Installation Overview

There are three parts to the installation process:

• Install program
• Merge gINT library objects
• Validate the product license

The first two steps can be performed in any order and are described below. The validation procedure must be done last and is described in the Datgel Product Licensing System User Guide.

Package Contents

Your software purchase may have come with the following contents:

• Zip download from datgel.com which normally has the following folders: 
  • \gINT Files
  • \Documentation
  • \Installation files
• A hardware license key

Before Installation

A few basic preparations can help ensure an effortless installation.

• Make sure that the computer where you plan to install the program meets the minimum hardware and software requirements.
• Connect your PC to the Internet before installation (must have a working Internet connection).
• The Administrator Tools requires that the Microsoft .NET 4.5.1 framework is installed on the PC prior to the installation of the Tool. If your PC does not have the .NET 4.5.1 framework installed, then it will be automatically downloaded and installed during the Tool installation process.
• Log into the PC with Administrator privileges before starting installation.
• It is recommended that you exit out of other applications that maybe running on your PC.
• Close gINT before you start installation.
• Keep the serial number and license number handy.

Install Program

1. Extract the ZIP download, and Browse to the folder \Installation Files
2. Double click the file named Setup.exe
3. Click Run to begin installation.
   Follow the on screen instructions when installation begins.
4. Click Next on the Welcome to the Datgel Administrator Tools Setup Wizard dialog.
   
5. Scroll and carefully read the License Agreement, and choose option I Agree, and click Next.
   
   Alternatively choose I Do Not Agree and click Cancel if you disagree with the license agreement. The installation will stop and exit.
   The EULA is deployed to C:\Program Files (x86)\Datgel\Datgel Administrator Tools\End User License Agreement.rtf.
6. On the Select Installation Folder dialog, either accept the default folder (recommended) or select Browse to specify the folder where you want to install the Administrator Tools.
7. Leave Everyone bulleted to indicate that anyone logged onto the PC can use the Administrator Tools.
   Click Next when ready.
   
    OPTIONAL Click on Disk Cost to view the disk space statistics. Click OK when done.
   
8. Click Next to start installation.
   
9. Observe the progress bar to monitor installation progress
   
10. Click Close when the Installation Complete dialog is displayed.
    

Merge gINT Library Objects

Proceed with the following steps to merge the gINT Library components into your Library file.

1. Make a backup copy of your existing library file. By default this is located at:
   C:\Users\Public\Documents\Bentley\gINT\libraries
2. Start gINT, open the library and the project file you wish to use with Datgel Administrator Tools gINT Add-In.
   The opened project and library files are displayed at the top of the gINT Window.
   
3. Select UTILITIES | Lib Merge/Copy
   
4. Check the bullet that reads Merge From.
5. In the Source Library File pane, browse the installation CD for file Datgel Administrator Tools lib #.##.glb where #.## is the version number.
6. Check the bullet that reads Select All.
7. Check the bullet that reads Query on Overwrite.
8. Select the Add-Ins and gINT Rules Modules source tables and click button to move selected tables from the Available Source Tables pane on the left to the Tables to Merge/Copy pane on the right side.
   
9. Click Execute.
10. Click button to move the selected items (highlighted blue) from the Available Items pane to the Items to Process pane on the Add-Ins dialog.
    
    
11. Click OK to process selected items.
12. Repeat steps 10 and 11 for all other items.
13. Take care to read the overwrite dialog and click Yes if you wish to overwrite the file, ELSE click No.
    
    This will merge in the Add-Ins and gINT Rules Modules related to the Tool.
14. Click OK to finish the merge.
    

Validate License

After installation (and before using the Administrator Tools), validate the user license as described in Validate License.

Upgrading from a previous version to Version 3.1

Considering the Tool is independent of the project files and tables, it is a simple task to upgrade to version 3.1.

1. Delete existing Add-In commands related to the Administrator tools from INPUT | gINT Rules > Add-Ins Manager.
2. Merge the new gINT Library Objects into your library file as described in Merge gINT Library Objects. Overwrite existing objects.
3. Datgel will email you a URL for the license update file. Download the file, but do not unzip the file. Follow  Update the Network Hardware Key or Update the Single User Hardware Key to update your hardware key to be licensed for version 2.

Product Compatibility Upgrade

This upgrade is necessary if you install a new Datgel product after February 2015, and also have an existing Datgel product from prior to February 2015. The change is necessary as a result of changes to the Microsoft.NET framework.

There are two scenarios, based on your system privileges.

Scenario 1: you do not have privileges to do the upgrade.

The following message is displayed after starting a Datgel product.

1. Click OK.
2. Advise your system administrator that the upgrade is needed.

Note: You might be able to continue working without the upgrade, but the products could be unreliable

Scenario 2: you do have privileges to do the upgrade.

The following message is displayed after starting a Datgel product.

1. Click Yes.
   The procedure must be completed by a user that has administrative privileges for the PC. 
   The software makes a backup copy of the existing gINT configuration file and inserts the changes Datgel software needs.
   The following message is displayed if the process completes successfully.
   
2. Click OK.
3. Restart gINT.