Software Installation Support

Introduction

This section identifies the files that you may redistribute with your application developed for SilverEngine.

All of the redistributable files are located in the REDIST sub-directory of your SilverScreen root directory. These files are installed if you choose to install the Redistribution Data component when installing the Developer’s Edition of SilverScreen.

Nomenclature

target directory The location where your application will be installed. Normally this is specified by your user when installing your application.

support directory This is a location where you may create temporary files during the installation process. Typically this is the users \temp directory.

Sentinel directory The location where you place the Sentinel drivers for Windows 95/NT. They need to be placed in an uncompressed format.

Windows system directory The location where system DLLs are located. Using Win32, this location can be retrieved with the GetSystemDirectory function.

Categories of Redistributable Files

• Standard Libraries
• Core components
• Platform-specific files
• Sentinel Drivers
• Shared DLLs
• Installation Tools

Files that should not be overwritten on the users hard disk are placed in the REDIST\NOTEXIST directory. Typically the files that are placed here are library files that the user may modify, and thus should not be overwritten.

You should install all files in the REDIST\NOTEXIST directory (along with any sub-directories that it contains) to the target directory.

Files that should always be overwritten on the users hard disk are placed in the REDIST\SILVER directory. Files placed here are program files, standard drawings, menu files, standard fonts, and any other files that should be overwritten upon installation.

You should install all files in the REDIST\SILVER directory (along with any sub-directories that it contains) to the target directory.

Files that are specific to either the SilverEngine development platform are placed in the REDIST\SilverEngine directory. Files placed here are program files and should overwrite existing copies during an installation.

You should install all files in the REDIST\SilverEngine directory (along with any sub-directories that it contains) to the target directory if your application is a SilverEngine application. A SilverEngine application is an .EXE file that links with engine.dll.

Drivers that are provided by Sentinel Corporation to communicate with the hardware lock used by SilverEngine are located in the REDIST\SENTINEL directory. If these drivers are not installed, then SilverEngine will operate as demonstration software.

Window 95 and Windows NT Installations

Install all files in the REDIST\SENTINEL\SILVER directory (along with any sub-directories that it contains) to the target directory.

The SENTINEL\SILVER directory contains tools that can be used by your user to verify the operation of the Sentinel drivers. This is not a required component, but it is recommended since it can be a useful problem solving tool.

Windows 95 Installations

Copy the contents of REDIST\SENTINEL\WIN 95 to your Sentinel directory. The Sentinel directory can be any place you wish, so long as you place the drivers there in an uncompressed format.

Make the Sentinel directory the current directory and execute the following command:

sentw95 /q

If you do not have the ability to make the Sentinel directory current, then issue the following command:

sentw95 /q /p"Sentinel directory"

Note: There are no spaces between the /p parameter and the Sentinel directory. If Sentinel directory contains spaces, then it must be surrounded with double quotes "".

Copy the contents of REDIST\SENTINEL\WIN NT to your Sentinel directory. The Sentinel directory can be any place you wish, so long as you place the drivers there in an uncompressed format.

Make the Sentinel directory the current directory and execute the following command:

setupx86 /q

If you do not have the ability to make the Sentinel directory current, then issue the following command:

setupx86 /q /p"Sentinel directory"

Note: There are no spaces between the /p parameter and the Sentinel directory. If Sentinel directory contains spaces, then it must be surrounded with double quotes "".

Shared DLLs are components that are used by SilverEngine to perform such tasks as: OpenGL rendering, image processing, and displaying user-interface objects.

Special care must be taken when installing a DLL because other applications may redistribute earlier or later versions of the same files as your application. It is important that you install newer versions of the files over older versions on your user’s system, but not older versions over newer versions. Version checking is an important responsibility of your setup program. If you do not have a setup program which handles version checking, then you must check them manually when installing files on your user’s system. To do so, use the version checking APIs available as a standard part of the Win32 API (see GetFileVersionInfo).

Windows 95 and Windows NT Installations

Install all files in the REDIST\WINSYS directory to the Windows System folder. Typically, this folder is \Windows\System on Windows 95 machines and \Winnt\System32 on Windows NT machines. To retrieve the system directory with Win32, see GetSystemDirectory.

Windows 95 Installations

You should install all files in the REDIST\WINSYS\WIN 95 directory (along with any sub-directories that it contains) to the windows system directory.

Windows NT Installations

You should install all files in the REDIST\WINSYS\WIN NT directory (along with any sub-directories that it contains) to the windows system directory.

Files in the REDIST\BIN directory are tools that may assist you during the installation process. They should be used during the installation if needed, but should not be installed on your user’s system.

SETENV.EXE

This program allows you to modify the contents of a SilverEngine environment file. Normally you will want to place the target directory into an environment file so that SilverEngine knows where to find drawings, script files, programs, and libraries. Typically, you would also specify a location that SilverEngine can use to create temporary files. The command-line syntax for setenv is:

setenv [/r <target directory>] [/t <temp directory>] [/o # setting] <environment-file path>

• /r tells setenv where the root directory of the SilverEngine installation is. This is the location where engine.dll lives and is usually the target directory.
• /t tells setenv where to create temporary files. SilverEngine must have write permission to the directory that you specify.
• /o # allows you to set the value of a specific option in an environment file. # represents the option number and it should be followed by its desired setting.
• <environment-file path> tells setenv which environment file or files you want to modify. You may use wildcards in place of filenames.

Example:

setenv /r "c:\Program Files\Silver" /t c:\temp
               "c:\Program Files\Silver\*.env"