Notes for System Administrators

These notes will serve as a guide to administrators, IT support personnel and other installers of Temprecord.

Temprecord installation requires the user to have administrator rights. Four installation scenarios are provided (for details see Selecting the Installation Type). If Temprecord is installed for all users, after installation Temprecord will be available to all users of the computer, whether administrators or limited users.

Batch installation (see below) carried out on computers with an existing installation of Temprecord can automatically import those settings, but you should inspect the example batch file to determine the behaviour when it is run.

Temprecord keeps the program settings in a text file called TRW.INI. If Temprecord is reinstalled using different installation settings (for all users, Just for Me, etc.) then it may not be possible for the installer to inherit the settings of any earlier installation.

It is a good idea to check all the settings in the Options dialog when you have completed installation.

Temprecord installation produces two log files with names that reflect the release version and date. These files are written to the Temprecord local settings application data folder (normally C:\Documents and Settings\<User name>\Local Settings\Application Data\Temprecord\TRW\). For example:

C:\Documents and Settings\<User name>\Local Settings\Application Data\Temprecord\TRW\Installation Logs\TRW Installation Log 5.28.0.2019 2011-06-09 11-22-20 .txt

C:\Documents and Settings\<User name>\Local Settings\Application Data\Temprecord\TRW\Installation Logs\TRW Reader Installation Log 5.28.0.2019 2011-06-09 11-22-20 .txt

Each time you install, re-install or update Temprecord a pair of these installation log files will be added to the folder. These files can be used to troubleshoot installation issues and should be included if you report an installation problem. If you submit a diagnostics report , these files will be included in the information sent to Temprecord. Temprecord will keep the installation logs from the 20 most recent installations.

Installation of Temprecord creates the following folders off the root folder C:\Documents and Settings\<User name>\:

..My Documents\Temprecord\	Default folder for Temprecord (.TR) files
..My Documents\Temprecord\Reports\	Default folder for PDF report files
..Local Settings\Application Data\Temprecord\TRW\	Folder for TRW.INI settings file and email queue file
..Local Settings\Application Data\Temprecord\TRW\Email Files\	Folder for temporary attachment files for emails. Files remain in here until the email with attachments is successfully sent, when these files are deleted.
..Local Settings\Application Data\Temprecord\TRW\Event Log\	Folder for the event log
..Local Settings\Application Data\Temprecord\TRW\Installation Logs\	Log files from installations of Temprecord on the users computer. Up to 20 installation logs from Temprecord program installations and 20 files from Temprecord Reader installations are retained and when this limit is reached the oldest is deleted.
..Local Settings\Application Data\Temprecord\TRW\Startup Logs\	A startup log file is written to this folder each time Temprecord starts. Up to 20 are retained as for installation log files.
..Local Settings\Application Data\Temprecord\TRW\Error Logs\	Error log files are produced when unexpected program errors occur. Up to 20 are retained as for installation log files.
..Local Settings\Temp\Temprecord\TRW\Preview\	Folder for temporary PDF files created when PDF preview is used.

An installation for all users, shared settings, shared executable creates a folder on the installation machine located at:

This folder is set up to have permissions to allow all users to modify the contents, and is used to store the common INI file.

The System tab in the Temprecord program Options shows the actual pathname to the above folders. It is possible to open an explorer window in any of the folders by right-clicking on the folder name. In addition, if the name shown includes a filename, and the file has an extension of TXT, CHM, or PDF it is possible to open the file from the right-click menu.

It is assumed that these folders are all created with modify permissions for the current user, so that a limited user can still run Temprecord, create and save files and email attachments, etc. Temporary PDF preview files are created in the logged-in user's TEMP folder

In addition to the above folders, Temprecord creates the following folders off the shared documents root folder C:\Documents and Settings\All Users\Documents\:

..Temprecord\	Default folder for shared Temprecord (.TR) files for shared settings installations.
..Temprecord\Reports\	Default folder for shared PDF report files for shared settings installations.
..Temprecord\Application Data\TRW\	Folder for TRW.INI settings file for shared settings installations.

The sample Temprecord data files and batch installation template files are installed into both the local user's My Documents\Temprecord folders and the shared documents folder. Temprecord places no restrictions to which folders you use, but if you want your Temprecord data files and report files to be available to others you need to make sure they are placed in a folder accessible to other users.

TRW.EXE	The Temprecord program executable file.
TRW_EN.CHM\	English-language compiled HTML help.
TRW_EN.PDF\	PDF document version of the English-language help.
*.dll	Dynamic-link library files needed to Temprecord operation.
Drivers\	Various driver files needed for the USB reader interface. This folder is always located within the folder containing the above TRW.EXE executable and help files.

The placement of Temprecord program files is dependent on the type of installation selected (these are the installation default locations - the user can generally override these locations at install time, but unless there is good reason, we do not recommend you do so):

The program files are installed into: C:\Program Files\Temprecord\TRW\ of the remote server computer. There is no requirement for Temprecord to be installed on the client machines (and it should not be installed).

After a default "All users, shared settings, remote EXE" installation, Temprecord will be unable to display help topics from a client workstation that is running the Temprecord program. This because security updates to Windows XP have introduced some severe restrictions for accessing CHM Help files across network drives. Without registry changes on the user's computer Temprecord Help will be unavailable on network installations.

It is possible to circumvent this restriction with registry changes. See the topic Modifying the Registry to Enable CHM Help across Network Drives.

An alternative is to copy the Help file to the client machine. If the file C:\Program Files\Temprecord\TRW\TRW_EN.CHM on the remote server computer is copied to the Temprecord common application data folder C:\Documents and Settings\All Users\Application Data\Temprecord\TRW on the client machine, Temprecord will find the file on startup.

The Temprecord program is generally distributed as a ZIP file named trw-setup.zip. Within the ZIP archive are three files:

trw-setup.exe	The setup executable. Run this file to install Temprecord.
readme.txt	Late-breaking news and version history
Install.txt	These notes
TRW Batch Installation Template.bat	A sample batch file to illustrate unattended batch installation

The installation ZIP archive file contains EXE and BAT files. These file types are often blocked by system administrators because of the fear they might harbor viruses. You may need to find alternate ways of distributing the installable other than email attachments. A possible alternative is to unzip the files to a temporary folder and then create another archive that is encrypted.

The INI file (usually called TRW.INI) is responsible for remembering all the settings of TRW when the application exits.. From TRW version 5.26 onwards, the INI file is handled differently to previous TRW versions:

•When TRW starts it first checks the folder the EXE file is located in for the INI file. If one is found it is read. This folder is usually called something like:

C:\Program Files\Temprecord\TRW\

If Temprecord has been installed and is running from a network drive for shared use, an INI file will be checked for in that folder instead.

•If the INI file is not found the common application data folder of the PC is checked. If TRW.INI is found there it is read. This folder is normally called something like:

C:\Documents and Settings\All Users\Documents\Temprecord\Application Data\TRW\

•If TRW.INI is not found in the common application folder, the local settings application folder is checked. If TRW.INI is found there it is read. This folder is normally called something like:

C:\Documents and Settings\<User name>\Local Settings\Application Data\Temprecord\TRW\

•If TRW.INI is not found in any of these three locations, a new default one is created in the local settings application data folder,

•When TRW exits, the INI file is written back to the folder it was read from. If the user does not have write access to that folder, or the file is marked as read-only, no error message is issued.

The above behaviour enables various configurations to be accommodated. The installation default is for each user to have their own INI file. Alternatively the INI file can be copied to the common application data folder and it will be used by all users on that workstation. Finally, the INI file can be copied to a network server folder containing a shared copy of TRW.INI and all users on the network will share the INI settings.

The installer creates a new TRW.INI file unless it finds an existing one from a previous installation, so existing settings should be preserved on re-installation of versions 5.26 onwards.

If you require a custom configuration for your users you can create this by installing TRW on your local machine, setting up the desired options, then copying the TRW.INI file to your installation image such that the file is available in the same folder as TRW-SETUP.EXE when this file is run. If the installer finds this custom copy of TRW.INI in the same folder TRW-SETUP.EXE is running in, and there is no local TRW.INI file there already, the custom one is copied across.

You need to deploy your edited batch file and the file trw-setup.exe. The other files readme.txt and Install.txt are already present in the setup EXE file.

•Copy the deployment files (edited batch file and setup executable) to a temporary folder on the target installation machine.

If you encounter problems with batch installation, the file TRW Installation Log... .txt created as part of installation can be inspected for clues as to what might be wrong. This file should be included in any request for technical support.

If you require your installation to have customized settings, these are the steps required:

•open Explorer and navigate to C:\Documents and Settings\<User name>\Local Settings\Application Data\Temprecord\TRW

The contents of the temporary folder are what you need to distribute as an installation image.