You must first setup your client computers before you can use SVS Logon Hook. This includes installing the required .DLL files on client computers and also configuring the client computer's Windows registry to reference the correct User Settings Configuration file.

Topics include:

• Deploying and Installing the Logon Hook .DLL Files
• Editing the Client Computer's Windows Registry

Deploying and Installing the Logon Hook .DLL Files

The SVS Logon Hook .MSI installs the required .DLL files.

Before you can use Logon Hook functionality, you must first deploy and install the Logon hook .MSI on your client computers.

To install Logon Hook .DLL files

1. Deploy the .MSI to the client computer.
2. Run the .MSI on the client computer.

   The .DLL files are installed by default to C:\Program Files\Common Files\Altiris\Virtualization.

3. Reboot the client computer. This installs the following .DLL files:
   
   • VzHook.dll - The SVS Logon Hook.
   • VzUserSw.dll - A Logon Hook extension for dynamic user software.
   • VzUserSwxml.dll - A dynamic user software provider for XML.

Editing the Client Computer's Windows Registry

You must configure the client computer's registry to reference the correct User Settings XML file before Logon Hook actions will work. The VzUserSwXml key is responsible for locating the correct path to the User Settings XML file.

To do this, you must change or add a value to the VzUserSwXML key in the following path:

HKEY_LOCAL_MACHINE\Software\Altiris\Virtualization\Winlogon\VzUserSwXml

You can direct the client computer to look to either the local system, a UNC path, or a web server for the User Settings Configuration file.

Name: FileName
Type: (REG_EXPAND_SZ)
Data: <the path to the location and the file name>

• To direct to the local system or a UNC path, you must change the FileName value:
• To direct to a web server, you must create a new expandable string value called URL:

  Name: URL
  Type: (REG_EXPAND_SZ)
  Data: <the path to the location and the file name>

To change the VzUserSwXML key's FileName value

This directs the client computer to a local location or a UNC path.

1. Click Start > Run.

   The Run window opens.

2. In Open, type regedit.
3. Click OK.
4. In the left pane, browse to
   

   HKEY_LOCAL_MACHINE\Software\Altiris\Virtualization\Winlogon\VzUserSwXml 
   

5. In the right pane, double-click the FileName value.

   The Edit String window opens.

6. Change the text in the Value data field to contain the path and file name of the desired User Settings XML file.
   
   Example: C:\LocationPath\Filesname.xml
7. Click OK.

To add a URL value to the VzUserSwXML key

This directs the client computer to a web server.

1. Click Start > Run.

   The Run window opens.

2. In Open, type regedit.
3. Click OK.
4. In the left pane, browse to
   

   HKEY_LOCAL_MACHINE\Software\Altiris\Virtualization\Winlogon\VzUserSwXml
   

5. Right-click in the right pane.
6. Select New > Expandable String Value.
7. Rename the value to URL.
8. In the right pane, double-click the URL value.

   The Edit String window opens.

9. Change the text in the Value data field to contain the path and file name of the desired User Settings XML file.
   
   Example: http://LocationPath/Filesname.xml
10. Click OK.

Chapter 9: Using the Logon Hook User Admin Utility

Chapter 11: Software Virtualization Solution Overview