Installing LabelTrace® Central – SQLite Database

Installing LabelTrace® Central – SQLite Database
Installing LabelTrace® Central – SQLite Database
These installation instructions are intended to be utilised by IT support staff or other persons
familiar with SQLite databases and typical software installation procedures. Do not attempt to
install LabelTrace® Central if you are uncertain of these. The options available now include
those specifically related to operation in a Terminal Services or Citrix environment.
LabelTrace® Central is the term used to describe the LabelTrace® SQLite database along with
label templates and other central information, stored in a folder (normally called LTDATA and
shared with that name) on the server. The installer creates the database as well as the folder.
The installer will also copy Client and Manager installers to a folder LTINSTL alongside the
LTDATA folder on the server and configure them appropriately.
LabelTrace® is designed to operate in diverse scenarios:1. Single practice, single server, “thick” client configuration (the “standard” setup).
2. As above but with some/all Terminal Services (aka “thin”) clients
3. Multiple clinical systems and/or practices sharing workstations using multiple LabelTrace®
central folders (named as practice code) under a master LTDATA folder on a single server.
4. Multiple clinical systems and/or practices on one or more shared workstations with
LTDATA folders on separate servers. (This requires manual configuration of individual
workstations after client installation)
5. Terminal Services based Enterprise configuration, e.g. Vision Enterprise with multiple
LTDATA folders presented to users on a standardised mapped drive configuration.
6. Hosted server configuration e.g. PCS Enterprise with multiple LTDATA folders presented to
users on a standardised mapped drive configuration.
7. Distributed Citrix Presentation Manager based configuration eg NHS Scotland Managed
Server configuration with multiple LTDATA folders presented to users on a standardised
mapped drive configuration.
8. Various combinations – call for advice on 0131 467 5906
Preconfiguring the Installer
The LT Central Installer may be preconfigured to set options to default values. This
customises the installation. See “howtouse.txt” within the installer folder for full details.
1. If standard data needs to be preset in any of the tables in LabelTrace®’s own database,
then a prepopulated database file (labeltrace.db) can be included in the Installer folder at the
same level as the setup.exe program. This will be copied on during installation instead of
generating an empty database file.
2. Label templates are copied from the "labels" sub folder of the installation folder to the
template folder specified during the installation.
A licence file (labeltrace.lic) is required to operate fully. The licence file contains the product
name , the name of the organisation to whom the software is licensed and “capabilities”. The
file is stored in the central LTDATA folder. In the absence of a licence file the system will
operate but data on labels is modified - “1” prints as “0”, “0” prints as “1”, “a” prints as “e” and
“e” prints as ”a”. In addition, every label printed will include the words “demo mode” at the top
to visually confirm that these are dummy labels.
The licence file may be
- included in the LabelTrace® Central installation set, at the same level as the setup.exe
- provided on a floppy during LabelTrace® Central installation
- manually “browsed” to during LabelTrace® Central installation (eg if supplied by email)
- generated after installation through LabelTrace® - via “About/Update Licence'. This is
achieved by pasting in an ASCII version of the licence key, of the formA
QT0051.doc (last modified 04/08/2016 14:02:00)
LabelTrace® will display the owner's name in the titlebar and at the foot of the window.
Other options may be set in by entries in the SETUP.INI file for LT Central.
- The help file is a PDF or other document accessed via the web and the appropriate URL
may be set (eg helpURL=http// )
This allows users in a specific area to access “customised” help files for their own area.
- The normal option to select the database type may be forced to a default value and the
option bypassed during installation.
set DBOption = 2 (where 2 = Create SQLite Database (default))
set CanSetDB = FALSE
A similar option allows only installation for a single clinical system eg EMIS PCS
Installation of LabelTrace Service (a web based automatic updating mechanism) is
enables/disabled as required.
Running the Installer
Ensure you are logged on as Administrator (or at least with Admin rights) then browse to the
LabelTrace® Central install folder.
Double click SETUP.EXE to start installation. (Click Next to proceed after each step.)
Specify where the licence file is to be obtained (floppy, install CD etc) or leave blank if it will be
installed later.
Terminal Services Support – select N, unless installing on a TS Server or in a Managed
Services (aka Enterprise) environment with multiple TS servers. The effect if set is to store
client settings in the User’s Windows Directory. Note that the ltrace.ini file will not appear in
the User’s Windows directory until they run LabelTrace® for first time when it is copied from
the machine’s Windows directory. It also sets the Lock DBLocation and LabelsDir
entrieswhich prevents the user from changing the LTDATA folder and label templates location.
Now specify whether a single LTDATA folder will be created (folder will then be shared) or
additional LTDATA folders will be subsquently added (folders not shared). A single LTDATA
folder is used in normal single practice configurations or multiple practice situations with
practice specific subfolders of LTDATA. Multiple LTDATA folders are generally only utilised in
the context of “Enterprise” configurations where all users have a mapped drive eg “P” on
which the LTDATA folder will be created.
Now specify whether LabelTrace® needs to be able to support multiple practices on any
single PC. (normally N). This will allow you to specify the practice codes which will be used as
sub folder names under LTDATA. (This option is only presented if a single LTDATA folder has
been specified above - multiple LTDATA folders and practice specific sub folders of a master
LTDATA folder are not generally mixed).
IF Y was selected to multiple practices above, now enter the relevant practice codes
separated by commas. These entries MUST match the practice code passed to LabelTrace®
when it is launched from a practice’s clinical system.
Select the Clinical system(s) with which LabelTrace® needs to operate.
QT0051.doc (last modified 04/08/2016 14:02:00)
Specify the type of database to be used. Normally SQLite. [IF SHOWN- may be disabled]
Now select a drive on which to install the shared folders (“LTDATA” and “LTINSTL”) for
LabelTrace® - about 50Mb is required. This will normally be a physical drive on the server - the
default is “C:\”. Use the Browse button to specify an alternative location, if required. In the
special case of EMIS sites where it is not possible to work directly on the server, carry out the
Central installation on a nominated workstation but specify the location for creation of the
LTDATA folder as the “Shared” folder on the EMIS server.
If a single LTDATA folder was specified above, you will now be prompted for the share name
for the central folder, defaults to LTDATA. You may enter another share name, if required.
Note that share names longer than eight characters may not be accessible from some of your
client PCs.
The data entered so far is now confirmed on an installation summary. Check that this is as
required. Use the Back button to make any modifications or Next to Proceed. Installation will
now be carried out. Click Finish to complete.
Now continue to install the client and manager where required and configure extensions, as
Re-installing/Updating LabelTrace® Central
NB LabelTrace® Central installers which include label templates may overwrite existing
templates. It is recommended that an installer intended to be used to update an existing
installation have no template files included.
Re-installing/Updating LabelTrace® Central may be done to:a. Update an installation with a new version
(run the LT Central installer from the new version’s installer and select the appropriate options.
In particular you can update
- the Master LTDATA folder {also updates the client and manager installers]
- a selected LT Central folder
- all LT Central folders underneath a specified folder)
b. Add another LTDATA folder
c. Add another practice specific folder under the master LTDATA folder.
(use the Add/Remove Programs option to select LabelTrace Central and select the
appropriate options)
De-installing LabelTrace® Central
To de-install LabelTrace® Central, select the “Start/Settings/Control Panel/Add_Remove
Programs” option. Select LabelTrace® Central from the list of software which can be removed
and click "Add/Remove". Select to Remove LabelTrace® Central and click OK to confirm. The
deinstallation process will remove all shared folder components.
Note that additional LTDATA folders added manually after installation of the master LTDATA
folder will NOT be removed during this process and can simply be manually deleted.
QT0051.doc (last modified 04/08/2016 14:02:00)
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF