Citrix states in their article: CTX132051

CTX132051 - How to Install Clientele on Windows NT Terminal Server or WinFrame 1.x

This document was published at: http://support.citrix.com/kb/entry.jspa?externalID=CTX132051

Document ID: CTX132051, Created on: Jun 9, 2000, Updated: Apr 23, 2003

Products: Citrix MetaFrame 1.8 for Microsoft NT 4.0 Server Terminal Server Edition, Citrix WinFrame 1.8

How do I set up Clientele to run from Terminal Server and MetaFrame or a Citrix WinFrame server?

1. Log on to Terminal Server or WinFrame as an administrator.

2. At a command line, type change user /install.

NOTE: Citrix recommends that all applications be installed after running change user /install. Doing this ensures that all Ini and Dll files are installed into the Terminal Server system directories.

3. Run Ctelwin.exe. This copies and registers the necessary Dlls on the computer.

4. When this completes, at a command line, type change user /execute.

NOTE: Citrix recommends you run this command after installing an application.

5. Your users can now run Clientele by using the Mars32.exe command line options.

Clientele Load Architecture and Differences Between Ctelwin.exe and Mars32.exe

Clientele uses the local hard drive on each users computer to store the executable file (Mars32.exe) and the database containing the forms (Setup.mdb) This is done to maximize performance because it avoids constantly loading them across a busy network. Normally, your icon is set up to run Ctelwin.exe. Ctelwin.exes primary purposes are to:

1. Verify the user has the most current copies of all the local files and Dlls and if not, update them.

2. Find the local and net paths in Ctelwin.ini.

3. Pass control (run) to the main Clientele executable, Mars32.exe.

Once you are at the Clientele login screen, your are actually running Mars32.exe. Mars32.exe is the "engine" of Clientele. It assumes that all the necessary checking for updated files (Dlls, Ctel.sys, Setup.mdb) has been done.

You need to log in to the Terminal Server/MetaFrame computer as an administrator and run Ctelwin.exe once in order to create the local work directory and update the necessary files on the computer.

Set up an icon on the desktop that your users will use to run Clientele. This icon will run Clientele using Mars32.exe directly. You do this because Ctelwin.exe may attempt to update files on the
computer, which requires administrator rights on that PC. Normally, you users will not have administrator rights on this PC.

You can specify one Clientele working directory either on the network or on the Terminal Server/MetaFrame computer itself that all users will share or you can have separate working directories for each user.

NOTES: In order to check forms in and out, Clientele developers MUST have their own private Clientele local working directory. This is to keep their form changes separate from the other users forms until the Clientele developer is ready to check in those changes.

Running Clientele Using the Mars32.exe Command Line Options

The command line options for Mars32.exe are:

Mars32.exe -Lworkpath -Ddatapath [-Aaccesspath] [-S] [-Nusername] [-Ppassword]

The following is a sample command line option (note that this example is all on one line with no spaces after the parameters)

"C:Program FilesPlatinum SoftwareClientele Local FilesMars32.exe" -L

"C:Program FilesPlatinum SoftwareClientele Local Files" -D"M:Clientele" -S -A"C:Program FilesMicrosoft OfficeAccess" -Ntsmith -Ppassword

-L (Working Directory)

The -L parameter specifies the directory where Mars32.exe is located. This might be a directory on the Terminal Server/MetaFrame computer or a directory in some other location on the network. Usually, this is the directory you set up when you run Ctelwin.exe as a Terminal Server/MetaFrame administrator. All the Clientele users can share this directory as long as the optional -S parameter is used on the command line as well.

-D (Data Directory)

The -D parameter specifies the directory where Ctel.mdb is located.

-S (Shared Working Directory - Optional)

Use the -L parameter when the Clientele working directory specified by the -L parameter is shared with other users. Users running with this switch will NOT be able to redesign forms. For that reason, always specify a private directory for users working directories and not include this switch when loading Clientele. Using this parameter assumes there is a Setup.mdb and a Ctel.bin in the path specified by the -L parameter. If your users are sharing a work directory, this parameter is required.

-A (Microsoft Access Directory - Optional)

The -A parameter specifies the location where Microsoft Access is installed. Usually, you install Microsoft Access on the Terminal Server/MetaFrame computer and this is the path you use with the -A parameter. If your users need to be able to run reports from Clientele or make changes to list box queries, this parameter is required.

-N (Username - OPTIONAL)

The -N parameter specifies the login name.

-P (Password - OPTIONAL)

The -P parameter specifies the password.

NOTES: Clientele 2.1 will run on WinFrame but Clientele 3.0 and higher requires Terminal Server. The MetaFrame add-on, supplied by Citrix Systems, Inc., gives Terminal Server access to the client file system, local printers, and additional client operating systems. Terminal Server out of the box supports only Windows NT, Windows 95/98, Windows for Workgroups, and Windows devices. The MetaFrame add-on gives DOS, UNIX, Macintosh, Windows 3.1 and other client operating systems access to Terminal Server. MetaFrame also has a more robust load balancing feature for Terminal Server clusters.