CCLAS EL 3.0.6 Initial Installation Guide
The topics in this section cover how to install and configure the necessary components of CCLAS EL 3.0.6 for your laboratory.
Important: Contact your network administrator or Datamine representative for the location of the CCLAS EL software, or for assistance with its installation.
These activities must be conducted with adequate network, domain and administrator permissions to the installation machines.
CCLAS EL version 3.0.5 must be uninstalled (if applicable), prior to installing version 3.0.6 except if your installation has the MSOLEDBSQL19 driver defined in the CCLAS.INI file. The CCLAS.INI file is located under the CCLASEL directory. Do not uninstall version 3.0.5.x if this is the case and continue to use this version's license application from the 3.0.5 exe directory.
To check if the CCLAS.INI file has the driver defined, open the INI file using a text editor (ex. Notepad) and look for the MSOLEDBSQL19 mentioned in the declarations. Here is an example highlighted in red:
Requirements
Refer to the CCLAS EL 3.0 System Requirements documents for requirements on the dedicated CCLAS EL application file server and dedicated CCLAS EL database server.
Those users running a CCLAS EL version older than 2.0.2 should contact CCLAS Support for a quote to migrate to the latest CCLAS generation.
These requirements should be satisfied prior to installation of CCLAS EL 3.0.6 onto the application server.
Installation Options
The selection of the various options presented during the installation is dependent upon the installation configuration at your site.
CCLAS EL can be installed with the following configurations:
-
Local
The CCLAS EL executables reside on each laboratory computer.
The CCLAS EL database and folders reside on a traditional network server or cloud server.
Although a CCLAS patch or upgrade requires updating each laboratory computer, the performance of CCLAS EL for each user is far superior compared to running executables on a remote server from a workstation.
-
Application Server and Workstations—This guide covers the initial installation on an application server.
Presumption: It is presumed that CCLAS Support consultants have already configured the CCLAS EL database and directories (folders) on a traditional network server or cloud server. These servers could be the same or different servers, typically determined by load.
Procedure
This procedure has to be done once on the application server.
Note:
CCLAS EL version 2 uses the CCLAS.INI initialisation file, located in the version 2 Exe folder, to map connection settings and server names, etc.
CCLAS EL version 3 uses the appsettings.json initialisation file, located in the version 3 Exe folder, to map connection settings and server names, etc.
A full installation of CCLAS EL version 3.0.6.0 or later creates a default appsettings.json initialisation file, located in the version 3.[n].[n].[n] Exe folder, for the version you are installing.
-
If you have already installed version 3.0.5.0 or later on your server, then make a backup of the appsettings.json file outside of the CCLAS EL folders so that it can be reinstated after installation as the installation procedure puts a default one in place. Refer to the post-installation steps below.
-
If you only have version 2 installed, or you have already installed version 3 but earlier than 3.0.5.0, on your server, then the appsettings.json file will not exist as yet on your server. Refer to the post-installation steps below for what happens if you run cclas.exe after installation where the appsettings.json file is not in place.
Installation:
-
Download and unzip the CCLAS EL 3.0.6.0 Release.zip package.
Note: Check the properties of the downloaded zip file to ensure that the zip file is unblocked before it is unzipped.
Note: Due to the system changes applied during the installation of CCLAS EL 3.0.6, it is expected that the installer has Administrator privileges on the machine.
-
Right-click Setup.exe file and select Run as administrator to display the welcome screen.
-
Allow the install application to make changes to your device.
-
Wait while the InstallShield Wizard prepares the setup.
-
When the Welcome screen displays, click Next to proceed with the installation.
-
Review the CCLAS Software Licence Agreement, then click Yes to accept the terms and conditions.
-
Select a Full installation. then click Next to proceed with the installation.
-
Select Programs and optionally Icons to get the latest CCLAS EL applications and icons, then click Next to proceed with the installation.
-
Chose the parent folder that is to contain the 3.0.6.0 Exe folder, using the Browse button to locate and open a different location on the local drive or network share, then click Next to proceed with the installation.
-
The Choose Data Directory screen only displays where the Icons component was selected. If this is the case, chose the parent folder that is to contain the Icons folder, using the Browse button to locate and open a different location on the local drive or network share, then click Next to proceed with the installation.
-
Select the program folder to contain the CCLAS EL application, then click Next to proceed with the installation.
-
When the Start Copying Files screen displays, click Next to proceed with the installation. To amend any of the previous selections, click Back, then return to this point and proceed.
-
Wait while the InstallShield installs the executables.
-
Wait while the InstallShield registers the executables.
-
Wait while the InstallShield updates the CCLAS EL program folders.
-
When the InstallShield Wizard Complete screen displays, click Finish to end the installation procedure.
-
Upon successful installation, access the computer's Settings » Apps » Programs and Features list to see the CCLAS EL 3 application.
-
To pin the CCLAS EL 3 application to the taskbar, using Windows Explorer, locate the folder containing the CCLAS EL Version 3 executables, as configured during the install on the Choose Program Directory screen, then right-click cclas.exe and select Pin to taskbar to display the CCLAS EL icon
in the taskbar. -
If the taskbar shows the CCLAS EL 3 application icon as
, then a restart of the Windows Explorer process fixes this. To do this, ensure that a Windows Explorer window is open, then click Ctrl-Alt-Del » Task Manager, locate the Windows Explorer application on the Processes tab and right-click Restart.
Post installation:
-
Locate and open the default appsettings.json initialisation file located in the version 3.[n].[n].[n] Exe folder, for the version you have installed. You will see that it contains no configuration to map connection settings and server names, etc.
-
Use your CCLAS.INI file to gather the information and update the appsettings.json file accordingly.
Example of a configured appsettings.json file:
appsettings.json
{
"CCLASConfiguration": {
"PreferredConnections": {
"DESKTOP-JAVETBN": "CCLAS"
},
"Connections": {
"CCLAS": {
"Language": 0,
"ConnectionName": "CCLAS_GENERIC",
"ConnectionString": "Server=DESKTOP-JAVETBN;Database=CCLAS_GENERIC;Encrypt=false;TrustServerCertificate=Yes",
"Uid": "CCLASMGR",
"Pwd": "myPassword"
}
"TEST": {
"Language": 0,
"ConnectionName": "CCLAS_TEST",
"ConnectionString": "Server=DESKTOP-JAVETBN;Database=CCLAS_TEST;Encrypt=false;TrustServerCertificate=Yes",
"Uid": "CCLASTEST",
"Pwd": "testPassword"
}
}
}
}
-
When cclas.exe in the C:\CCLASEL\3.0.6.0 Exe folder is launched, if a configured appsettings.json file is not in place or it is configured incorrectly, when version 3 cclas.exe is launched, then the Connection String screen displays for you to enter the Connection String, User Id and optional Password.
You can enter the details in this screen, and it will update the appsettings.json file. For example:
-
When cclas.exe in the C:\CCLASEL\3.0.6.0 Exe folder is launched, if a configured appsettings.json file is in place, then the normal login form displays.
-
Now refer to:
