Logon Scripts

About this task

Logon scripts allow administrators to configure the operating environment for Webspace users. Scripts may perform an arbitrary set of tasks such as defining user-specific environment variables and drive letter mappings.

Webspace supports two types of logon scripts: global scripts that execute for all users that log on to the server, and user-specific scripts that execute for individual users. Before loading the user's profile, Webspace checks to see if a script of either (or both) type has been specified. If so, Webspace runs the script(s) within the user's security context each time the user is authenticated.

Note: User-specific project paths for Webspace sessions are not supported. For example, you cannot use different directory paths for iFIX files, such as pictures, across multiple users.  If you need to support this, it is suggested that you use iFIX with Terminal Server, instead of Webspace.

User-specific logon scripts are specified using the functionality provided by the operating system. For example, the logon script for local users on a Windows 2000 server is specified as follows:

  1. Right-click My Computer and click Manage.
  2. Navigate to the \System Tools\Local Users and Groups\Users folder.
  3. Select a user and click Properties.
  4. Click Profiles.
  5. In the Logon script box, type the file name of the user's logon script.

If the value entered in the Logon script box specifies a file name and extension only, Webspace searches for the file in the following directories, in the following order:

  1. If the user's account is a domain account is the NETLOGON share of the primary domain controller (for example: \\pdcname\NETLOGON), or the domain subdirectory of the primary domain controller's SYSVOL share (for example: \\pdcname\SYSVOL\domainname).
  2. If the user's account is a local account. For example: systemroot\System32\Repl\Import\Scripts or systemroot\sysvol\sysvol\domainname.

If the logon script is stored in a subdirectory of one of the above directories, precede the file name with the relative path of that subdirectory. For example: Admins\JohnG.bat.

Administrators specify global and user-specific logon scripts through the Webspace Admin Console's Session Startup dialog.

Running User-specific Logon Scripts

Procedure

  1. From the Webspace Admin Console, in the server tree, select the desired server from the list.
  2. On the Tools menu, click Host Options. The Host Options dialog box appears.
  3. Click the Session Startup tab.
  4. Select the User-specific check box.
  5. Click OK.

Running a Global Logon Script

Procedure

  1. From the Webspace Admin Console, in the server tree, select the desired server from the list.
  2. On the Tools menu, click Host Options. The Host Options dialog box appears.
  3. Click the Session Startup tab.
  4. Select the Global check box.
  5. In the field next to the check box, specify the path of the global script file.

    For example, you may want to add the LoginScript.bat, provided in the C:\Program Files\Proficy\Webspace Server\Programs folder as an example for configuring mapped drives, as a global script.

  6. Click OK.
    Note: Authenticated users must have read and execute access to the logon script files. An example of a logon script is described in the Creating Mapped Drives on the Webspace Server section. The LoginScript.bat example described in this section can be applied on a global or user-specific basis.