
User Manual
Chapter 7
Advanced Features
PC-Duo enables you to start an application on individual Clients and Groups of Clients. This facility could be used to execute a setup application and install software on Client PCs.
Executing Applications on a Client
You can execute an application on any Client PC even if you are not connected to it before starting the application.
To Execute Applications on Individual Clients:
- Right-click the Client on which you want to execute an application.
- Choose the Execute at Client command from the shortcut menu.
- In the Execute Application dialog, enter the path, name and any parameters for the application you want to execute, then click the Execute button.
The application is executed on the Client PC. After a few moments, the results of the operation are displayed in the bottom section of the Execute Application dialog.
Executing an Application on a Group of Clients
To Execute Applications on a Group of Clients:
- Right-click the Group that contains the Clients on which you want to execute an application.
- Choose the Execute at Client command from the shortcut menu.
- In the Execute Application dialog, enter the path, name and any parameters for the application you want to execute, then click the Execute button.
The Control attempts to execute the application on all Clients in the Group. After a few moments, the results of the operation are listed in the bottom section of the Execute Application dialog.
- You can also execute applications on Clients using the Remote Command Prompt option in the Clients menu. It enables you to run tools and applications from a command line in the same way as the standard Windows command prompt.
Capturing the Print Output on Client PCs
The Print Capture feature enables you to redirect the printer output from a Client PC to the printer at the Control. Use this feature when you are running an application on a Client, but want to redirect printed output to a printer used by the Control.
You can configure the Print Capture facility before or while you are connected to a Client.
To Capture a Client's Print Output:
- In the Control window's List View, right-click the Client to display the shortcut menu.
- Choose the Client Settings command from the shortcut menu.
- In the Settings for Client dialog, click Print Capture.
- Select the Enable Print Capture check box to enable the print capture options.
- Select a print capture option to redirect the print output. Choose:
Capture to Printer to redirect the print output to a printer. To select a different printer, click the Change button.
Capture to File to redirect the print output to a file. Enter a filename with an extension of PRN, or click the Browse button to locate an existing file.
- Click the OK button to return to the Control window.
The Print Capture feature may already be enabled by the Profile used by your Control. For more information, see "Using Control Profiles".
Rebooting And Logging Out Clients
When you are connected to a Client, you can reboot or log the user off their Client PC by sending the equivalent of an Alt+Ctrl+Del key press. If the Client is running Windows NT4, 2000, XP or 2003, this action causes the Client to log off. If the Client is running Windows 95, 98, or Me, this action causes the Client to reboot.
To Reboot or Log Out Clients:
- Select the Clients, or Group you want to log out or reboot.
- Right-click the selection to display the shortcut menu, then choose the Reboot / Logout command. The selected Clients or Group are rebooted or logged out.
Alternatively, if the View window is displayed for the Client you want to reboot, you can also click the Reboot
button in the View window Toolbar to reboot the Client.
To shut down a Client rather than reboot it, display the View window for the Client, then click the Start button and choose the Shutdown command in the Client's View window. The Client automatically disconnects after a few moments.
Power Management
Wake-on-LAN technology in PC-Duo enables you to activate and switch off remote PCs using the Power On and Power Off commands in the Client menu.
To use the Power Management features, you must first configure the Client PCs.
Client Requirements for Remote Power Management
You may need to set up the following hardware, BIOS and operating system features before using power management on remote PCs:
- A network card that supports Remote Power Management (sometimes called Wake-on-LAN). Note that many older cards and low-cost cards do not support Power Management.
- A motherboard that supports Power Management.
- A dedicated Power Management cable installed and connected from the network card and the motherboard.
- In the PC's BIOS Power Management, you must enable the LAN Wakeup option or its equivalent.
- Some network cards provide configuration utilities, which enable you to specify the Power Management settings. These options are sometimes dependent on the operating system being used.
Using Power Management
The Power On facility only works with Clients for which the MAC Address is known by the Control application.
A Client's MAC Address is picked up by the Control application when you connect to the Client. (This only applies to TCP/IP Clients.)
To check whether the MAC Address is stored for a Client, view the Details tab in the Client Properties dialog.
- A known Client is listed in the Control PC's CLIENT.NSM file, along with its MAC Address.
To Activate a Remote PC:
- In the Control application's Client View, select the PCs you want to activate.
- Choose the Client, Power On menu command.
To Shut Down a Remote PC:
- In the Control application's Client View, select the PCs you want to deactivate.
- Choose the Client, Power Off menu command.
To activate or deactivate a Group of PCs:
- Select the Group from the Tree View
- Choose Power On or Power Off from the Group menu.
- You can perform Power Management operations from within PC-Duo Scripts. See "Power Management Scripts" for more details.
Working With User-Defined Tools
You can integrate external tools and applications with the PC-Duo Control application. These tools can then be accessed using the Tools, User Defined submenu in the Control window. PC-Duo Scripts can also be configured as User Defined Tools.
You can customize the PC-Duo Control Toolbar and add a Tools button that enables you to access your User Defined Tools more easily.
Adding User Defined Tools
To Add a User Defined Tool:
- In the PC-Duo Control window, choose the Tools, User Defined, Edit menu command. The User Defined Tools dialog is displayed.
- In the Add Tool dialog, enter the text you want to use as the menu command name in the Menu Text box.
- To reference a file as your User Defined Tool, click the Browse button to select the file.
- Enter any parameters you want to pass in the command line in the Arguments box.
- Select the Wait for program to finish check box if you want the PC-Duo Control to be inactive while the tool is running.
- If the Wait for program to finish check box is selected, the PC-Duo Control displays a message to inform you that the Tool is running, and gives you the option of stopping the Tool and returning to PC-Duo Control. (However, it is better to stop an active Tool by closing the Tool itself, rather than by terminating it from this message dialog.)
- Click the OK button. The tool is displayed in the User Defined Tools dialog.
- Click the Close button. The Tool is now accessible from the Tools, User Defined submenu.
Editing and Deleting User Defined Tools
To Edit a User-Defined Tool:
- From the Tools menu, choose the User Defined, Edit command to display the User Defined Tools dialog.
- In the Tools list, select the User Defined Tool you want to edit.
- Click the Edit button. The Edit tool dialog is displayed, enabling you to change the Tool settings.
- Click the OK button to return to the User Defined Tools dialog.
To Delete a User-Defined Tool:
- Choose the Tools, User Defined, Edit command to display the User Defined Tools dialog.
- In the Tools list, select the Tool you want to delete.
- Click the Delete button to delete the selected Tool, then confirm this action.
- See "Customizing the Toolbar", for information on how to add a Tools button to the Control window Toolbar. You can then display the User Defined Tools dialog by clicking the Tools button, and choosing Edit from the drop-down menu.
Copying Tool Settings to other Control PCs
If you want to use your user-defined tools settings on any Control, you can copy the settings. The User Defined Tool settings are stored in the TOOLS.NSM file, located in your PC-Duo installation directory. You can copy this file to another PC's PC-Duo installation directory to transfer the User Defined tools settings to it. After doing so, the PC receiving this file will need to restart the PC-Duo Control to access the new User Defined Tools.
Defined Tools may not work on another PC because the User Defined Tools may use path and file references that are specific to one PC. If you copy the TOOLS.NSM file to another PC, use the Edit Tool dialog's Browse button to verify the file paths for each of the User Defined Tools.
System Snapshot
System Snapshot enables you to quickly obtain a detailed inventory of a Client's hardware configuration. It includes information about Clients' CPU type and speed, memory, operating system, service pack information, printers, screen type and display driver, drive size and free space, network domain, network card and much more! This information is presented in the System Snapshot window, organized by category.
You can view this information immediately and use it to assist users and resolve problems. You can even save a copy of the information to a file.
- To perform a System Snapshot on a Client, the PC must be running the PC-Duo Client v4.15 or above.
To Perform a System Snapshot:
- In the PC-Duo Control window, select the Client you want to snapshot.
If you are not connected to the Client, PC-Duo automatically connects to the Client, obtains the snapshot information and then disconnects. If you are already connected to the Client, the Client remains connected when the snapshot is complete.
- From the Tools menu, choose the User Defined, System Snapshot command.
The System Snapshot information is collected from the Client and displayed.
The information in the window is organized by category. To display the information in a category, select the category title in the category list, or click the section title in the main view.
- Refer to "Troubleshooting System Snapshot" if you encounter any problems or error messages when attempting to perform a System Snapshot.
Comparing Clients
In addition to displaying inventory data for individual Clients, System Snapshot can compare Clients. This enables you to check Client PCs against standard PC inventories and to search for problems caused by different system configurations.
To compare Clients:
- Choose an entry in the Compare with list.
- Sections containing differences are indicated by a red
indicator button.
Individual differences between items within each section are indicated by a smaller version of the button. To display the data of the comparison Client, select the adjacent button.
- To cancel the comparison, select None in the Compare with list.
Customizing System Snapshot
System Snapshot is pre-configured as a User Defined Tool. As such, you can change the name of the Snapshot's menu command as displayed in the User-Defined submenu. You can also edit the arguments that are passed to the System Snapshot program.
To Customize System Snapshot:
- In the PC-Duo Control, choose the Tools, User Defined, Edit menu command.
- In the User Defined Tools System Snapshot dialog, select the System Snapshot item from the list, then click the Edit button. The System Snapshot settings are displayed in the Edit Tool dialog.
- If you want to change the name of the System Snapshot menu command, edit the text in the Menu Text Box. (Use the & symbol to identify the following letter as a shortcut for this menu command when the menu is displayed).
- The Path value should usually be left unchanged. It refers to the location of the System Snapshot program file (HWINV.EXE), which is located in the PC-Duo installation directory.
- Use the Arguments value to specify the parameters that are passed to the System Snapshot program.
By default, this setting is $CLIENTNAME$^. The $CLIENTNAME$ part of the argument refers to the currently selected Client when you start a System Snapshot. If you want to store the System Snapshot information files in a specific location, append the directory path after the ^. However, because PC-Duo looks for these files in the Client's installation directory, you should not need to change this parameter.
- Select the Wait for program to finish check box to make the PC-Duo Control window temporarily inaccessible while viewing the System Snapshot information.
Deselect this option if you want to work with the Control while one or more System Snapshot dialogs are displayed.
User Prompting
User Prompting enables you to automate the collection of data from PC users. Prompts can be used to collect any user-related information, such as locations, departments, cost codes, or telephone numbers. Prompts can also be used to collect system variables from PCs without user intervention.
Collecting information through user prompts is a three stage process:
- Create the Prompt File Enter the questions you want to ask. To minimize data entry and consistency problems, replies can be limited to specific formats, lengths and cases or to a selection from a list of pre-defined answers.
- Distribute the Prompt File Copy the completed Prompt file to users' PCs using the LUTINFO script.
- Collect the Information Use the System Snapshot option to collect and display the information from Client PCs.
User Prompting enables you to automate the collection and storage of information from PC users on your network. Use the Prompt Editor to create and edit the questions that are displayed to users and to control the replies that users can give.
To update the User Prompt file:
- In the Tools menu, choose User Defined, Edit User Prompt File. The User Prompt Editor is displayed.
- In the Title field, type the text you want to display in the Title Bar of the User Prompt window when it is displayed on users' PCs.
- In the Introduction field, type the explanatory message you want to display at the top of the User Prompt window.
- If you want to provide extra information about this file or its prompts, enter the information in the File Comments field.
- Edit the questions in the prompt file:
- In the File menu, choose Test to check how the prompts will be displayed.
- In the File menu, choose Save As. In the Save As dialog enter a location and name for the prompt file and click Save.
When you have created a prompt file containing the questions for which you want users to supply information, you must send the file to the users' PCs. The LUTINFO script file included as part of the PC-Duo Control kit enables you to send the file to individual PCs or to a specified group.
To distribute the prompt file to Client PCs:
- In the Control window, choose the Tools, User Defined, Refresh User Prompt menu command. LUTINFO.SCP is displayed in the Script Editor.
- In the Options menu, choose Predefined Variables. This enables you to specify the Clients from which you want to collect user prompt information.
- In the Predefined Script Variables dialog, click the Add button. The Add Variable dialog is displayed.
- In the Add Variable dialog:
- In the Identifier field, type Clientname.
- In the Value field, type the name by which the target PC is known on your network.
- Click the OK button to save your changes.
Alternatively, if you want to send the prompt file to a group of users, enter Groupname in the Identifier field, and enter the name of the group in the Value field.
- Repeat step 4 for the Username variable:
In the Identifier field, type Username.
In the Value field, type the name of an account and password that can be used to access all the Client PCs you specified. Enter the information in the format: username/password.
- The password must be encrypted. To generate the encrypted version of a password, select a blank line in the script and choose Edit, Insert Password in the Script Editor window. Enter the password in the Insert Password dialog and click the OK button. You can then cut the encrypted password from the script and paste it into the Add Variable dialog.
- When you have entered the script variables, click the OK button to close the Predefined Script Variables dialog.
- In the Script Editor, choose Run, Execute LUTINFO.SCP to distribute the changes to the Clients.
If a user is logged on to a target PC, the questions are displayed in the Prompt dialog immediately. Otherwise, the Prompt dialog is displayed when a user next logs on. The replies are saved on the user's PC and are available to any Control user with access to that Client.
System Snapshot contains a special section to display any user prompt replies found on a Client PC. As the reply file is stored on each Client to which the prompts were sent, support staff can view the information from any Control that has access to the Client PC. The information remains available through System Snapshot until another set of user prompts is distributed to the Client PC.
To display the User Prompt information:
- Choose User Defined, System Snapshot in the Control's Tools menu to open the System Snapshot dialog.
- In the System Snapshot, select the User Prompt Responses section. The replies are listed in the order in which they were presented to the user.
Troubleshooting System Snapshot
The following messages may be displayed when attempting to perform a System Snapshot.
Incorrect password, please try again
Explanation: An incorrect user name or password was entered when the Control attempted to connect to the Client to retrieve the System Snapshot information.
User Action: You are prompted to re-enter the correct user name and password for this Client.
Failed to connect to Client. Wrong username or password
Explanation: You cancelled an attempt to connect to a Client after failing to enter the correct user name and password.
User Action: Try again with correct user name and password, as used to connect to the Client ordinarily using PC-Duo.
Command line provided: ^ Usage:Client^ [Directory]
Explanation: No Client was selected when performing a System Snapshot.
User Action: Select the Client in the PC-Duo window and then perform a System Snapshot.
Hardware inventory files not found on Client. Cannot open [Directory]\LUHDWCHK.LOG
Explanation: The Hardware inventory files used to perform the System Snapshot cannot be found on the Client. Check the displayed is the location of the Client's PC-Duo Installation directory. If it isn't, edit the System Snapshot settings using the User Defined Tools dialog - these settings may contain an incorrect directory at the end of the arguments line. See "Customizing System Snapshot" for more information. Alternatively, the Client PC may not be running the PC-Duo Client v4.15 or above, and therefore you will not be able to perform a System Snapshot on this Client.
User Action: Take appropriate steps to upgrade the Client to the latest version.
Application [Directory]\HWInv.exe not found. Check path and try again.
Explanation: The HWInv application is not in the directory specified in the Tool definition.
User Action: Update the Tool path, or move HWInv.exe to the specified location.
Software Snapshot
Software Snapshot collects information on the applications installed on Client PCs. It supports this using an Application Library, which enables it to recognize many common applications automatically; discovery utilities, which assist in the identification of applications; and a Rule Editor and Software Identification Wizard that enable you to generate rules for the identification of applications not included in the library.
To perform a Software Snapshot:
Software Snapshot collects information on the directory structure of the selected PC and the size, datestamps and attributes of its files and then processes the data using the rules in the Application Library. The results are displayed in the Software Identification Manager.
Software Identification Manager
The Software Identification Manager displays the software found on the selected Client using the following categories:
Confirmed Identifications
lists applications identified by application definitions in the Applications Library.
Provisional Identifications
lists applications identified using version information from the file properties of executables.
Unidentified Software
lists the directories containing executable files that Software Snapshot is unable to identify.
To display the information associated with each category, select the tabs at the top of the window.
The Confirmed Identifications tab lists software identified by recognition rules in the Applications Library.
The Confirmed Identifications tab can list the software detected by Client or by application:
- The Details View displays the location of each installation of each application found on the selected Client. To display the Details View, select the Details button.
- The Applications View lists confirmed identifications by application. The View also displays the number of installations detected for each application. To display the Applications View, deselect the Details button.
When a Software Snapshot detects files on a Client PC, it attempts to identify the application they belong to by first trying to match the file and its directory location with an entry in the Applications Library, and then by searching the file properties for version information. The Provisional Identifications tab of the Software Identification Manager lists the applications identified using this version information.
Like the Confirmed Identifications tab, the Provisional Identifications tab can list the applications by Client or by application:
- The Details View displays the directory location of each installation of each application identified using version information. To display the Details View, select the Details button.
- The Applications View lists the applications identified using version information. To display the Applications View, deselect the Details button.
The Unidentified Software tab lists the locations of executable files that Software Snapshot is unable to identify. Use it to view the directories in which the software was detected and to find sample installations on which you can base new definitions for the Applications Library.
The Applications Library
The Applications Library enables Software Snapshot to identify the software installed on Client PCs.
Each entry in the library contains the details of directories, files and file properties that uniquely identify an application. When you run a Software Snapshot, it checks the files detected on a Client against each entry in the library. If the files meet the criteria specified in an entry, the Software Identification Manager reports a confirmed installation of the application.
Use the Applications Library tab to view and change the rules with which Software Snapshot identifies applications on Client PCs.
Using the Applications Library
To display the Applications Library, click the Applications Library tab in the Software Identification Manager. The Application pane at the top of the library tab displays the current application definitions. It lists the name of the application, the application type and the vendor. The Version field displays the version of the application identified by the definition, or an asterisk if the definition can identify multiple versions.
To display the identification rules for a definition, select its entry in the list.
To add a definition, or to work with the Applications Library, right-click an entry in the applications menu and choose:
- Application Properties to display and update the Vendor, Type and License details of an application.
- Add Application to define identification rules for a new application. Choose Software Identification Wizard to create an application definition by supplying information about an installed application, or choose Build Custom Definition to select the recognition rules you want the application definition to use.
- Delete Application to remove an application from the list of application rules.
- Import Application to import identification rules from a text file. Use this to transfer modified and new definitions from an export file to a PC-Duo Enterprise Site.
- Export Application to save the selected application definitions to a text file.
- Export Library to save all the definitions in the application library to a text file.
The Rule pane at the bottom of the window displays the identification rules associated with the selected definition in the Applications pane. To modify the application definition, right-click a rule to display the rule menu, and choose:
- Edit Rule to update the selected rule.
- Add File Rule to specify the details of a file that Software Snapshot can use to identify the application. If you specify multiple file rules, all files must be in the same directory unless you embed them within a subdirectory rule.
- Add Subdirectory Rule to add a new directory rule at the same level as the current directory.
- Add Nested Subdirectory Rule to add a new directory within the current directory.
- Add Optional Block to add optional recognition rules to the application definition. Optional Blocks do not cause a recognition failure, so you can use them to create application definitions that identify different versions of an application.
- Add Version Rule to specify or refine the version number of the application.
- Delete Rule to delete the selected check.
The Software Identification Wizard
The Software Identification Wizard helps you create new application definitions. It guides you through the process of specifying the file, directory names and file properties that will enable Software Snapshot to uniquely identify an installed application. You can use it to create entire definitions or to create basic rules that you can refine later. To open the Wizard, right-click the Applications pane and choose Add Application, Software Identification Wizard.
The Software Properties dialog identifies the name and type of the application, and its source. This information is used to categorize the application in Software Identification Manager views.
To specify the details of the application:
- In the Name field, enter the name of the application, or click the down arrow and select the name from the list.
- In the Type field, enter a category for the application, or click the down arrow and select the category from the list.
- In the Vendor field, enter the name of the application's manufacturer.
- If you have purchased a specific number of licenses for this application, type the number of licenses in the Licenses field.
- Click the Next button to create identification rules for the application. The Sample Location dialog is displayed.
The Software Identification Wizard uses an installed instance of the application to supply information for the recognition rules it creates. This enables it to display file and directory information from a real installation when you are choosing the items that best identify the application.
To specify location details for the application:
- To create identification rules using an application installation on your Console, select Use local copy.
Alternatively, to create identification rules using an installation from a Client PC:
- In the Client list, select a Client on which the application is installed.
- In the Resource list, select the disk or share on which the application is installed.
- In the Directory field, enter the location of the application for which you want to create identification rules. Alternatively, click the browse button to search for the location.
- Click the Next button to specify the files that you want to use to identify the application. The Software Identification dialog is displayed.
Software Snapshot identifies applications by checking for distinguishing features, such as the names and properties of files. Use the Software Identification dialog to select the files that Software Snapshot can use to identify the application.
To select files for application identification:
- In the Available files list, double-click each file you want to use to identify this application. The files are displayed in the Required files list.
- To prevent executable files in subdirectories from being identified as separate applications, select Exclude subdirectories from scans for unrecognized applications.
- If you want to create an application definition that identifies different versions of an application, select Specify rules to identify application versions and click the Next button. The Version Identification dialog is displayed.
If you do not want to distinguish between different versions of an application, select Do not identify versions and click the Finish button. The Wizard creates rules for the application and adds them to the Applications Library.
In addition to identifying installed applications, Software Snapshot can recognize specific application versions. Use the Version Identification dialog to specify the files and properties that can be used to distinguish between application versions.
To select files for version identification:
- For each file you want to use to identify this version of the application:
- Double-click its entry in the Available files list to add it to the Required files list.
- By default, Software Snapshot checks for the presence of this file. If you want it to check for specific properties of the file, such as its size, timestamp or version information, select the file in the Required files list, and click Specify properties. The File Rule dialog is displayed.
- If you want to specify the application version identified by these files, select Use these files to identify only version, enter the version number, and click the Finish button. The Wizard creates rules for the identification of the application and adds them to the Applications Library.
If you want Software Snapshot to determine the version number by extracting it from the properties of a file, select Use properties of these files to identify versions, and click the Next button. The Version Identification Properties dialog is displayed.
Some manufacturers encode software version information in the timestamp or product version properties of files. These properties enable you to provide automatic version recognition for software installed on your Client PCs. Use the Version Identification Properties dialog to select the properties from which you want Software Snapshot to extract the information.
To extract the version information from the selected file:
- In the Filename list, select the file that contains the version information. The Available file properties list displays the values of the properties for the file you selected.
- In the Specify the property fields that contain version information field, enter the tokens that specify the location of the version information.
Alternatively, double-click the properties that contain the version information from the available property fields list. The token for the property is added to the Specify the property fields that contain version information field.
For example, if the version number of the product is specified in the first two product version fields, select Product version fields 1 and 2 in the list and click the Select button. The tokens that enable Software Snapshot to extract the version information are displayed in the Specify the property fields that contain version information field.
- When you have selected all the properties that contain the version information, click the Finish button to create the application definition. The definition is added to the Applications Library.
Test the application definition by running Software Snapshot on a Client PC where the application is installed.
Adding and Editing Application Definitions
While the Software Identification Wizard generates basic software recognition rules, creating and editing application definitions manually gives you greater control over the attributes used to detect an application. It also enables you to refine the rules created by the wizard and optimize the Software Snapshot process.
To add an application definition to the Applications Library:
- Right-click the Applications pane and choose Add Application, Build Custom Definition from the shortcut menu.
- Type the name of the application in the Name field.
- In the Type field, click the down arrow and select a category of software that best describes how the application is used. Alternatively, enter a new category in the field.
- In the Vendor field, click the down arrow and select the vendor from the list. Alternatively, enter the name of a new vendor in the field.
- If you want to use this definition to identify only one version of the application, type the version number in the Version field. If you want to use this definition to identify multiple versions of the application, type an asterisk.
- If you want to record extra information about the application, enter it in the Comment field.
- If you have purchased a specific number of licenses for this application, type the number of licenses in the License limit field.
- Click the OK button to save your changes and close the dialog. The application definition is selected in the Applications Library. Right-click the Rule pane and choose an entry in the shortcut menu to add recognition rules for the application.
Software Snapshot compares the files found on Clients with the definitions specified in the Applications Library. If a software installation matches the file names, file properties and directories specified in an application definition, Software Snapshot reports the application is present.
Use the File Rules dialog to specify a file that identifies this application, and optionally the properties that the file must have.
To add a file rule to the application definition:
- Right-click the Rule pane of the Applications Library, and choose Add File Rule from the shortcut menu. The File Rule dialog is displayed.
- In the Name field, type the name of the file that can be used to identify the application. For example, to create a rule that identifies Microsoft Word using its executable file, type WINWORD.EXE.
- By default, Software Snapshot uses the names of installed files to identify applications. However, you can extend file rules to check for specific file properties, such as the size or timestamp. You can use these properties to distinguish between different versions of the same file. To add a property check to a file rule, choose a property check box and enter the values you want to test for:
- To check the size of a file, select Enable file size check, select a test option in the drop-down list and enter the file size in the entry fields. We recommend you specify a range rather than an exact value because file sizes can vary across different systems.
- To check the timestamp of a file, select Enable time stamp check, select a test option in the drop-down list and enter the timestamp range the file must have.
- To check the datestamp of a file, select Enable date stamp check, select a test option in the drop-down list and enter the date stamp range the file must have.
- Some manufacturers encode software version information in the timestamp or product version properties of files. To check the version information of a file for a specific version number, select the version information fields you want to test, select a test option in the drop-down list and enter the value each field must have.
For example, if the version number is held in the first two fields of the file's version information, and you want to check whether the application version is 3.1, select Field 1 and enter 3, then select Field 2 and enter 1.
- Click the OK button to save your changes and close the dialog.
Subdirectory rules enable you to create application definitions that check for files in the subdirectories of an application's installation directory. They also enable you to create rules that check for the presence of subdirectories created by an application.
Choose the Add Subdirectory Rule option when you want to add a subdirectory rule at the same level of the directory hierarchy as the currently selected rule; choose the Add Nested Subdirectory Rule option when you want to add the subdirectory rule within the currently selected directory.
To add a subdirectory rule to a definition:
- Right-click the Rule pane and choose Add Subdirectory Rule or Add Nested Subdirectory Rule from the shortcut menu. The Sub-Directory Rule dialog is displayed.
- In the Sub-Directory Rule dialog, enter the name of the subdirectory you want to check for.
- Click the OK button to save your rule and close the dialog.
By default, applications fail recognition checks when a file or directory fails any check within the appropriate application definition. For example, if the name of a file matches a file rule, but the file size does not match the size check, Software Snapshot will not recognize the parent application. However, rules embedded in optional blocks do not cause a recognition failure when a check fails. This enables you to create application definitions that include tests for several different versions of an application. By embedding each version test within an optional rule block, you can ensure the application is recognized even when several version tests fail.
To add an Optional Rule Block to an Application Definition:
- Right-click the Rule pane in the Applications Library and choose Add Optional Block from the shortcut menu.
- Enter a name for the rule in the Option field.
- Click the OK button to create the optional rule block and close the dialog. To add rules to the new block, right-click its entry in the Rule pane and choose an option from the shortcut menu.
Software Snapshot can identify specific versions of applications by the files installed, and by the properties of those files. Use version rules in conjunction with file rules to specify the properties you want Software Snapshot to use to identify application versions.
To specify the version number for an application:
- In the Rule pane, right-click the File Rule that uniquely identifies this version of the application, and choose Add Version Rule from the shortcut menu. The Set Version Rule dialog is displayed.
- To replace the current number associated with this rule set, select Replace existing version number. To concatenate this value to the version number currently assigned to the rule set, select Append to existing version number.
- If you want Software Snapshot to identify the application with a different string to the tested value, enter the string you want to use in the Version template field.
- Click the OK button to save your changes and close the dialog.
An application definition can contain several Set Version Rules in Optional Rule Blocks. This enables you to create definitions that progressively refine the version number of an installed application.
- For example, by using the Append to existing version number option in the Set Version Rule dialog, you can create a set version rule that first identifies version 4.x of an application, another rule that resets the version to 4.02, and finally a third rule that identifies version 4.02b.
Some manufacturers encode software version information in the version information properties of files. If the files of an application include version information, you can use a version rule to extract the version number and create an automatic, future-proof application definition.
To extract the version information from a file:
- In the Filename list, select the file that contains the version information. The Available file properties list displays the values of the properties for the file you selected.
- In the Specify the property fields that contain version information field, enter tokens to specify the location of the version information.
Alternatively, select the properties that contain the version information from the Property list, and click the Select button. The token for the property is added to the Specify the property fields that contain version information field.
For example, if the version number of the product is specified in the first two product version fields, select Product version fields 1 and 2 in the list and click Select. The tokens that enable Software Snapshot to extract the version information are displayed in the Specify the property fields that contain version information field.
- Click the OK button to save your changes and close the dialog.
Some applications encode the version number in the timestamp of application files. Software Snapshot can extract this information using tokens. For example:
- If the file has a timestamp of 04:20:00 (4:20 a.m.), $HOURS.$MINUTES returns a version of 4.2.
- If the file has a timestamp of 7:28, the following token values are returned:
In this case, $MINUTES produces the same result as $MINUTETEN$MINUTEUNIT.
- If the file has a timestamp of 7:08, the following token values are returned:
$MINUTES = 8 (the leading zero is deliberately dropped)
$MINUTES returns a value of 8, but $MINUTETEN$MINUTEUNIT returns a value of 08. If the application followed this convention only after a certain date, apply a date range check before the Set Version Rule.
Exporting and Importing the Application Library
The standard library of application definitions is included as part of Remote Control and as part of PC-Duo Enterprise. If you create or modify an application definition in Remote Control and you want to use it elsewhere within your Enterprise installation, you must copy it to all your PC-Duo Enterprise Sites. Use the export and import functions of the application library to copy individual definitions or the entire library.
To export application definitions:
- To export a single application definition, right-click its entry in the Applications Library, and choose Export Application from the shortcut menu.
Alternatively, to export all application definitions, right-click a definition and choose Export Library from the shortcut menu.
- In the Save As dialog, enter a File name and location for the definition file and click the Save button.
- In the PC-Duo Enterprise Site to which you want to copy the definition, open the Site Identification Manager.
- Right-click an application in the Application Library and choose Import Application from the shortcut menu.
- In the Open dialog, select the *.DB file you created and click the Open button. The definitions are imported.
Configuring Software Snapshot
By default, Clients collect version information from all .EXE files on all drives as part of the Software Snapshot. While this is a powerful tool that can greatly help support staff identify installed software without the need to create application definitions, it can take several minutes to collect data from PCs with large numbers of files or slow disk drives. If you find that the default settings are causing problems to Client users, you can control the files from which information is collected and the frequency of collection by configuring the LUCLIENT.INI file in the Client application's installation directory.
To configure Software Snapshot settings on a single Client:
- Connect to the Client you want to configure, open File Transfer, and open LUCLIENT.INI in the Client's installation directory.
Alternatively, open the Client's LUCLIENT.INI file using a text editor such as Notepad.
- Edit the parameters you want to change:
- To change the frequency, in days, with which the snapshot data is collected, locate the Offline Mode section and update the PushDaysInterval parameter in the Offline Mode section. For example, to configure the Client to collect information once a week, enter: PushDaysInterval=7.
- To change the disk drives from which snapshot information is collected, locate the Directory Snapshot section and change the Drives parameter. For example, if you want the Client to collect data from only its C and D drives, enter Drives=C,D.
- To change the files from which version information is collected, change the ViScanFileWildcards parameter to list the file extensions that you want the Client to check. For example, to collect version information from DLL files in addition to EXE files, enter:
VIScanFileWildcards=*.exe,*.dll.- To disable the collection of version information data from Client files, locate the Directory Snapshot section and specify
VIScanEnabled=No.- To disable the collection of all software snapshot data, locate the Directory Snapshot section and specify Disabled=Yes.
- Save your changes and close the file.
To configure Software Snapshot settings for multiple Clients:
- In the PC-Duo Control, create a Group that contains the Clients you want to update.
- In the PC-Duo install directory of the Control PC:
- Open the SAMPLE.MOD file with a text editor and specify the settings you want to change.
For example, to configure the Clients to snapshot only their C and D drives, create a file that contains the following settings:
- Save your changes in the Control's installation directory as LUCLIENT.MOD.
- In the Windows Start menu, choose Programs, PC-Duo, Script Editor.
- In the Script Editor, choose File, Open. In the Open window, select FLUPDATE.SCP and click the Open button. The script is displayed in the Script Editor.
- Choose Predefined Variables in the Options menu to open the Predefined Script Variables dialog and specify the script parameters.
- Click the Add button. The Add Variable dialog is displayed.
- In the Add Variable dialog:
- Type FileNames in the Identifier field.
- Type LUCLIENT. MOD in the Value field.
- Click the OK button to save your changes.
- Repeat step 7 for each of the following variables:
- When you have entered the script variables, click the OK button to close the Predefined Script Variables dialog.
- In the Script Editor, choose Run, Execute FLUPDATE.SCP to distribute the changes to the Clients in the Group. The changes will take effect when the Client application next runs.
Disabling Software Snapshot
PC-Duo Clients automatically collect information on the directory structure of the PC and the size, datestamps and attributes of its files at the frequency specified by the Client's configuration settings. This enables it to provide up-to-date information on installed software whenever it is required.
After the initial analysis, the Client only collects data on changes to the Client's software and this has little effect on the Client user. However, if you do not want to use software inventory data, you can disable its collection using SWSNPOFF.SCP.
To disable software snapshot:
- In the Control window, choose the Tools, User Defined, Disable Software Snapshot menu command. SWSNPOFF.SCP is displayed in the Script Editor.
- In the Options menu, choose Predefined Variables. This enables you to specify the Clients from which you want to collect user prompt information.
- In the Predefined Script Variables dialog, click the Add button. The Add Variable dialog is displayed.
- In the Add Variable dialog:
- In the Identifier field, type Clientname.
- In the Value field, type the name by which the target PC is known on your network.
- Click the OK button to save your changes.
Alternatively, if you want to send the prompt file to a group of users, enter Groupname in the Identifier field, and enter the name of the group in the Value field.
- Repeat step 5 for the Username variable:
In the Identifier field, type Username.
In the Value field, type the name of an account and password that can be used to access the Client PC you specified. For example:
- If you specified a group name, you must enter an account that can access all the Clients in the group.
To check the encrypted version of a password, select a blank line in the script and choose Edit, Insert Password in the Script Editor window. Enter the password in the Insert Password dialog and click the OK button. You can then cut the encrypted password from the script and paste it into the Add Variable dialog.- In the Client Variables section, make sure that the Directory Snapshot variable is set to Disabled=Yes.
- When you have entered the script variables, click OK to close the Predefined Script Variables dialog.
- In the Script Editor, choose Run, Execute SWSNPOFF.SCP to disable Software Snapshot on the Clients.
Record and Replay
In addition to monitoring the screens of Client PCs, PC-Duo can also use its ability to intercept GDI (Graphical Device Interface) signals to record actions performed on Control PCs. These recordings can then be played back on any Control or Client PC, enabling support staff to create a library of recordings that can be used to demonstrate new software and to answer frequently asked questions.
- To facilitate auditing and to deter the misuse of remote control sessions, Clients and Controls can be configured to automatically record all remote control sessions. For more information, see "Configuring Clients to Record Control Sessions" and "Configuring Controls to Record Control Sessions".
To record actions on a Control PC:
- In the Control window, choose the Tools, Record menu command.
- In the Record Local Activity dialog, specify whether you want to record audio and the fonts used on the recording PC, and choose a location for the recording file. PC-Duo creates a recording file using the current date and time.
- Click the OK button to start the recording. A red icon is displayed in the Windows system tray.
- Perform the actions you want to record. When you have finished, double-click the icon to stop the recording.
Playing Recordings
You can replay a recording session using any PC-Duo Control or Client.
To replay a recording:
- To replay a recording from a PC-Duo Control, choose the Tools, Replay menu command.
To replay a recording from a PC-Duo Client, right-click the Client icon in the system tray and choose the Replay menu command.
- In the Open dialog, locate and select the file you want to replay. When you select a Replay file, information about the file is displayed at the bottom of the dialog.
- Click the Open button. The recorded control session is displayed in the Replay window.
Using the Replay Window
The Replay window is used to display recorded Control sessions.
The Replay window has two buttons in its Toolbar:
- The Scale to Fit button displays the recorded session in the Replay window. This eliminates the need to scroll to different parts of the window.
- The Full Screen button enables you to make the Replay window fill the entire Control screen.
These buttons act as toggles. Click them a second time to return the Replay window to its previous state.
The Replay Controls window is also displayed when you are replaying a Control session.
The Replay Controls window enables you to navigate the Control session displayed in the Replay window:
- The gauge at the top of the window shows the progress of the recording. This gauge is divided into set intervals, with units of minutes and seconds.
- Information about the current Control session is displayed at the bottom of the Replay Controls window.
- The buttons enable you to control the display of the replay:
Play /
Stop Starts and stops the Control session. The button changes to Stop when the Control session is playing and changes to Play when the Control session is stopped.
Rewind Start playing the file from the beginning if it is already playing; otherwise, moves the replay index to the beginning of the file.
Skip to Previous Moves the replay index to the previous activity marker, or to the beginning of the file. These markers are added at points where lots of activity was recorded at the Client.
Frame Advance Advances the replay index to the next frame. Click and hold this button to Fast-Forward though the replay file.
Skip to Next Moves the replay index to the next activity marker, or to the end of the file.
Audio Enables and disables Audio replay. The button is disabled when no audio data is available.
When you have finished watching the Control session, choose the File, Close command to exit the Replay window.
Customizing the Toolbar
The Customize Toolbar dialog enables you to select which buttons you want to display in the Control window's Toolbar. You can also use this dialog to customize the View window's Toolbar.
To display the Customize Toolbar dialog:
- If you want to customize the Control window Toolbar, choose the View, Toolbar, Customize menu command in the Control window. The Customize Toolbar dialog is displayed.
- If you want to customize the View window Toolbar, right-click a View window, and choose the Customize command from the shortcut menu.
Using the Customize Toolbar Dialog
The Available Buttons list contains buttons that you can add to the Toolbar. (This list does not contain any buttons which are already featured on the Toolbar.)
The Current Buttons list shows the buttons currently featured on the Toolbar. The buttons in this list appear from top to bottom in the order the buttons appear on the actual Toolbar from left to right.
To add a button to the Toolbar, select the button from the Available Buttons List, then click the Add button.
To remove a button from the Toolbar, select the button from the Current Buttons List, then click the Remove button.
To change the position of a button on the Toolbar, select a button in the Current Buttons list, then use the up and down arrows to change the position of the button in the Toolbar.
To add a small gap to the left of a Toolbar button, select the button in the Current Buttons list, then click the Separator button.
To reset the Toolbar to the default buttons, click the Reset button. In the confirmation dialog, click the Yes button.
When you have finished customizing the Toolbar, click the OK button to return to the Control window.
Applying an Authorization Key
You can apply a new PC-Duo authorization key using the License Manager dialog.
To Apply a New License Key:
- In the Windows Start menu, choose Programs, PC-Duo, Tools, Apply a Key.
- In the Licence Manager dialog, ensure the General tab is selected.
- Enter the new authorization key in the Authorization Key text box at the bottom of the General tab.
- Click the Generate button to apply the key and close the License Manager dialog.
![]() Vector Networks http://www.vector-networks.com Voice: +44 (0) 1827 67333 Fax: +44 (0) 1827 67068 info@vector-networks.co.uk |