LinearPlus v3.

5 Installation Guide

INSTALLATION GUIDE
LinearPlus Version 3.5

LinearPlus v3.5 Installation Guide

Contents
1: Preparation for Installation............................................................................................................................ 3 1.1: 1.2: 1.3: 1.4: What's on the CD-ROM?............................................................................................................................ 3 LinearPlus installation type ........................................................................................................................ 3 System Requirements ................................................................................................................................. 3 Getting a license file ................................................................................................................................... 3

2: Standalone Installation ................................................................................................................................... 6 2.1: Installing LinearPlus................................................................................................................................... 6 2.2: Changing License details on a standalone system .................................................................................... 12 3: Uninstalling LinearPlus ................................................................................................................................ 13 3.1: Standalone ................................................................................................................................................ 13 4: FAQs............................................................................................................................................................... 14 4.1: 4.2: 4.3: 4.4: 4.5: Installer ..................................................................................................................................................... 14 License management ................................................................................................................................ 14 System startup .......................................................................................................................................... 14 General ..................................................................................................................................................... 15 Getting help from PCF ............................................................................................................................. 15

Appendix A - Registry keys used by LinearPlus.............................................................................................. 16

LinearPlus v3.5 Installation Guide

1: Preparation for Installation

1.1: What's on the CD-ROM?
The LinearPlus CD-ROM contains the following items: LinearPlus LinearPlus Documentation Adobe Acrobat Reader Adobe SVG Viewer

1.2: LinearPlus installation type

LinearPlus is normally installed as a standalone application on a single PC. It is possible to configure LinearPlus to operate as a deployed application in a Citrix/Terminal Server environment; please refer to PCF for more information on this process as it is not covered in this document.

1.3: System Requirements

Any modern PC is more than adequate to run LinearPlus. The minimum recommended specification is as follows: Pentium 4 class processor 512Mb RAM 50Mb free disk space XGA (1024x768) display 17" monitor LinearPlus is a Windows application and can be run on the following operating systems: Windows 2000 Windows XP Home and Professional Windows Vista Windows Server 2003 This system will not run on older versions of Windows, and will run as a 32 bit application on 64 bit versions of XP, Vista and Windows Server.

1.4: Getting a license file

In order for LinearPlus to run, you must obtain a valid license file and register it in your system. A standalone license locks the software to the machine on which it is run and is not transferable to any other machine. This license is required in order to complete the installation of LinearPlus and should, therefore be requested before installing it. To generate a license file you will need to provide PCF with the Lock Code for the machine that will be running LinearPlus To obtain the Lock Code, insert the LinearPlus CD-ROM into the appropriate machine. If the installation utility does not start automatically, use Explorer to navigate to the CD-ROM and double-click on SETUP.EXE. You should be presented with the first page of the Installation Wizard:

LinearPlus v3.5 Installation Guide

Click the Next button, and you will see the following page:

Select the "Generate License code" button. The install wizard will then show the following dialog box asking for your details:

Click on the Next button and you will be prompted to confirm the details you have entered as follows:

LinearPlus v3.5 Installation Guide

The following dialog box then appears.

At the same this dialog is shown, an email will be generated containing this information ready to send to PCF Limited. The lock codes will appear in the body of the message if you are using MS Outlook. If you are using a different email program, the body of the email may be empty. If this is the case, use the copy & paste technique to copy the lock code into the body of the email. Click on the Next button to continue.

Click on the Finish button to complete the LinearPlus Installation Wizard. No changes to your system have been made and LinearPlus has not been installed.

LinearPlus v3.5 Installation Guide

2: Standalone Installation
2.1: Installing LinearPlus
To install LinearPlus, you will need to be logged in with sufficient privileges to create directories, copy files to and modify the registry of, the target computer. If you do not have sufficient privileges you will need to get help from your Systems Administrator. You will also require the license file supplied by PCF Limited. This may be either an evaluation license, valid for thirty days from installation or a license generated specifically for your machine from the code supplied in the previous section. Insert the LinearPlus CD-ROM into the machine. If the installation utility does not start automatically, use Explorer to navigate to the CD-ROM and double-click on SETUP.EXE. After the wizard has initialised, you should be presented with the first page of the Installation Wizard:

Click the Next button, and you will see the following page:

Select "Install LinearPlus" and click the Next button. You will see the following page:

LinearPlus v3.5 Installation Guide

Enter the folder into which LinearPlus should be installed. If a different folder is required to that supplied, click the Browse button:

Either choose an existing folder or type in the name of a new folder and press OK to return to the previous page. When you have made your choice, click Next. You will see the following page:

Enter the folder into which the databases should be installed. If a different folder is required to that supplied, click the Browse button. Either choose an existing folder or type in the name of a new folder as above. It is important to remember that write access will be required to this folder. If you are unable to write to the C drive, then you should enter a folder on a disk drive that you can write to.

LinearPlus v3.5 Installation Guide

When you have made your choice, click Next. You will see the following page:

Enter the folder that should be used to hold temporary files. The installation Wizard will offer the current value of the TEMP or TMP environment variable on your machine. If a different folder is required to that supplied, click the Browse button. Either choose an existing folder or type in the name of a new folder as above. It is important to remember that write access will be required to this folder. If you are unable to write to the C drive, then you should enter a folder on a disk drive that you can write to. When you have made your choice, click Next. You will see the following page:

This page is used to identify the folder that LinearPlus should use to store external data such as log files. The Installation Wizard will offer a default folder. If a different folder is required, click the Browse button. Either choose an existing folder or type in the name of a new folder as above. It is important to remember that write access will be required to this folder. If you are unable to write to the C drive, then you should enter a folder on a disk drive that you can write to. When you have made your choice, click Next. You will see the following page:

LinearPlus v3.5 Installation Guide

LinearPlus is licensed as a standalone product. You will need to have an evaluation license, valid for thirty days from installation, or purchase a license made for your machine. For details on how to obtain a machine specific license, see Section 1.4. This page is used to tell the Installation Wizard where to find the license file. If your license is not located on a floppy disk, click the browse button to see the following:

Navigate to the license file and click Open to return to the previous page. Now click on Next to view the next page.

If the license file used is not a valid license file, the page above appears. A valid license file will result in the following page appearing:

LinearPlus v3.5 Installation Guide

This page details the options you have entered. Review the details and make sure that they are correct. When ready, click on the Next button to start the installation process. A status bar will appear advising you of how far the installation has progresses. When it is complete the following page appears:

If you are a first time user of LinearPlus, It is strongly recommended that you tick the box to view the Getting Started guide. This will give you important information about how to create a LinearPlus database. It is in PDF format and requires the Adobe Acrobat Reader to be installed in this machine. If it is not presently installed, a copy can be found on the LinearPlus CD-ROM in the Acroread folder. The Getting Started guide is installed in the Docs folder of the LinearPlus installation so it can be referred to at a later date. If you want to start LinearPlus immediately then ensure the box to Launch LinearPlus is ticked. Click on Finish to complete the installation.

The Installation Wizard can be stopped at any time by clicking the Cancel button.When you do this, the following page appears:

10

LinearPlus v3.5 Installation Guide

No changes have been made to your system at this point. Click on Finish to exit the Wizard.

11

LinearPlus v3.5 Installation Guide

2.2: Changing License details on a standalone system

It may be necessary at some stage to change the license details for your LinearPlus system if for example you originally installed the product with a trial license and now wish to register a full license. You do this using the System Configuration Utility, which can be started by selecting Programs/PCF Limited/LinearPlus/License Configuration from the Start Menu. You will see a dialog box like this:

This utility allows you to install and remove license codes. If you wish to find out what other functions are available in this utility, hit the Help button or the F1 key to bring up the online help system; in almost all cases the supplied default values will be fine. To install a license, click the Add button. You will see a small dialog like this:

Enter the path to the license file, and click OK. The utility will analyse the license file and if successful, will add the license code(s) it finds to the list. Once you have done this, click Save and Exit to save your changes and close down the utility. Please refer to the Troubleshooting section later in this Guide if you see message boxes warning of license problems after using this utility.

12

LinearPlus v3.5 Installation Guide

3: Uninstalling LinearPlus
3.1: Standalone
To uninstall a standalone installation of LinearPlus open the Control Panel and select Add/Remove Programs. In the list of installed programs, click on the Change/Remove button next to the entry for LinearPlus The uninstall process will start; this will remove entries from the Programs menu registry settings file associations installed files The uninstall process will only remove those files which were originally installed. It will not remove any databases you created using LinearPlus. You will have to remove these files manually from your system.

13

LinearPlus v3.5 Installation Guide

4: FAQs
4.1: Installer
When I insert the LinearPlus CD-ROM in my PC the Installation Wizard does not start. How do I install the product? You can install LinearPlus by using Explorer to view the contents of the CD-ROM and then double-clicking on SETUP.EXE.

4.2: License management

I get a message saying "The license for feature LinearPlus on this machine has expired" You will need to obtain a new license from PCF to be able to run LinearPlus again. When I start LinearPlus, my machine pops up the Dialup Connection dialog as if it is trying to connect to the Internet. On installation, an environment variable is set to prevent LinearPlus from searching the network for a license. It may be that the variable has been removed from your machine. You need to check for and, if missing, define a system environment variable on your machine called LSFORCEHOST and set it to NO_NET. I get a message saying, "Access denied due to clock tamper detection" The SentinelLM License Manager is designed to detect any attempts to "rewind" the system clock in order to bypass the expiration date of a time-limited license. If you see this message and no such tampering has taken place, please contact PCF for assistance.

4.3: System startup

Why does my system now pop up a dialog saying, "license expires in nn days"? This message means exactly what it says when there is less than one month until the expiry date of a time limited license, LinearPlus will issue a warning message every time you start the application. My system displays "System Error abnormal termination" and a Message window containing "Cannot access message file 'QEIDIR:\run\qei.mfl' - File does not exist" This will occur if LinearPlus is unable to locate the correct set of registry data. If you are comfortable working with the registry, you may be able to use the information in Appendix A to determine the exact cause of the problem, remembering to take a backup first. If not, please contact PCF for assistance. My system hangs while displaying a Message window containing "(PML 41) Unable to open macro file - File does not exist Database no.=" This will occur if LinearPlus cannot find the macro pointed to by the STARTUP variable in the registry. If you are comfortable working with the registry, you may be able to use the information in Appendix A to determine the exact cause of the problem, remembering to take a backup first. If not, please contact PCF for assistance. Please also note that by typing "quit y" at the database prompt you can exit the system cleanly without having to terminate it.

14

LinearPlus v3.5 Installation Guide

4.4: General
Can I install LinearPlus from a CD-ROM image? You can copy the LinearPlus CD-ROM to a disk drive and install from there without problems. How do I tell what version of LinearPlus I am running? Start LinearPlus click the Help menu and then About LinearPlus. The dialog box displayed shows you: The current version of the software The revision level of any standard installed patch

The name and revision of any custom patch The revision level of the current database The access mode of the current database See below:

4.5: Getting help from PCF

For further information and technical support please contact PCF Limited 41 Marlowes Hemel Hempstead Hertfordshire HP1 1LD United Kingdom Tel: Fax: Support: +44 1442 355100 +44 1442 355001 +44 1442 355100 support@pcfltd.co.uk http://www.pcfltd.co.uk

WWW:

15

LinearPlus v3.5 Installation Guide

Appendix A - Registry keys used by LinearPlus

When LinearPlus is installed, the registry is loaded with data reflecting the installation. This data is stored under a branch of the registry with the path name:
\HKEY_LOCAL_MACHINE\Software\PCF\LinearPlus\<version>

where <version> is the version number of LinearPlus being installed (currently 3.5). The sections shown below will then correspond to keys below this point in the hierarchy. Entries in the registry that are modified as a result of executing LinearPlus - such things as the visibility of the toolbar, and status bar; default spacing in SBC layouts and so on - are always stored in the branch:
\HKEY_CURRENT_USER\Software\PCF\LinearPlus\<version>

As this branch is always searched first by LinearPlus, this allows default information to be defined under HKEY_LOCAL_MACHINE and then individually overridden under HKEY_CURRENT_USER on a per-user basis. Note how directory paths can contain references to other entries in the file (eg WINMAC:)

QEI Section
Value
cpatch cres db1 dbrev elr fmt LPhelp Menuhelp patch qeidir qeipref qeirun qeitrans qeiwrk sel spcmac special srt startup statusbar stdres tab toolbar winmac Version

Typical Contents
00 QEIRUN:LinearPlus.dll ' QEIDIR:\data\library.db' library read 76 QEIPREF: QEIRUN:LPcontext.hlp QEIRUN:LinearPlus.hlp 00 C:\Program Files\PCF Limited\LinearPlus QEIDIR:\qeipref\ QEIDIR:\run\ QEIDIR:\Log C:\temp QEIPREF: QEIDIR:\amps\spcamp QEIPREF: SPCMAC:\startup.mac 1 QEIRUN:Resource.dll QEIPREF: 1 QEIDIR:\amps\winamp 1.1

Description
Revision level of installed custom patch (2 digits) Resource file(s) for custom patches (comma delimited list) Initial database to open automatically Current revision level for databases Interface format file default directory LinearPlus help file LinearPlus help file Current system patch level (2 digits) LinearPlus root directory User preferences directory QEI Run directory Log file directory Working directory Selection file default directory Standard location for customer macros Customised flag Sort definition file default directory Full directory path to startup macro Display state of status bar System resource file Field definition file default directory Display state of toolbar Macro directory LinearPlus version number

Page Section
Value
header footer left right top bottom titlefont titlestyle titlesize tablefont tablestyle

Typical Contents
QEI - %d Page %p of %n .84 .84 .84 .84 Times New Roman Bold Italic 100 Courier New Regular

Description
Table print header string Table print footer string Left margin (cm) Right margin (cm) Top margin (cm) Bottom margin (cm) Title font face name Title font style Title font size (1/10 point) Table font face name Table font style

16

LinearPlus v3.5 Installation Guide

tablesize

100

Table font size (1/10 point)

SBCSort Section
Value
d1 d2 d3 d4 d5 sort

Typical Contents
5 5 10 5 10 Custom sort

Description
Vertical spacing to owner Vertical spacing to child Horizontal spacing between siblings Vertical spacing between siblings Horizontal spacing between subtrees Name of sort definition file

NETSort Section
Value
startcolumn startrow column row

Typical Contents
20 20 80 30

Description
x-position of first activity column y-position of first activity row spacing between activity columns spacing between activity rows

BARSort Section
Value
group spacing from structure horizontal sort

Typical Contents
0 top 0 0 Custom sort

Description
Group toggle button state Vertical spacing Layout from Structure toggle button state Horizontal toggle button state Name of sort definition file

LoadData Section
Value
select

Typical Contents
Custom selection

Description
Title of activity selection file

Locale Section
Value
mod_bold mod_ital mod_regl

Typical Contents

Description
Modifier for bold fonts (default Bold) Modifier for italic fonts (default Italic) Modifier for regular fonts (default )

AutoNaming Section
Value
prefix count increment suffix

Typical Contents
100 10

Description
Name prefix string Current value of counter Value increment Name suffix string

TableA Section
Value
fields

Typical Contents
Custom fields

Description
Name of field definition file

17

LinearPlus v3.5 Installation Guide

select sort

Custom selection Custom sort

Title of activity selection file Name of sort definition file

TableC Section
Value
mode select sort

Typical Contents
Pred Custom selection Custom sort

Description
Display mode Title of activity selection file Name of sort definition file

TableP Section
Value
resources select sort

Typical Contents
auto Custom selection Custom sort

Description
Progress resource action Title of activity selection file Name of sort definition file

TableR Section
Value
Resource Cost Quantity

Typical Contents
1 1

Description
Name of resource being updated Flag to show actual costs Flag to show actual quantities

Defaults Section
Value
details def_font

Typical Contents
QEIPREF:details.dat Lucida Console

Description
Layer definition file Default font name

18