PC-Duo Version 7.10 =================== Release Notes ============= Copyright (c) 2002 PCI, Vector Networks Limited All Rights Reserved. Author : D. Briggs. Revision Date : 5th September 2002 This document contains the NetSupport PC-Duo PC-PC Remote Control package release notes for Version 7.10. This software is supplied under a licence and may only be used or copied in accordance with the terms of that licence. This software or copies thereof must not be made available to unauthorised personnel. No title to this software nor ownership of this software is hereby transferred. Evaluation copies are supplied for the purpose of evaluation only and must not be resold or passed to any third party without the express permission of Vector Networks Limited. Please note that the licence files (NSM.LIC) for versions of NetSupport PC-Duo earlier than v7.00 will not work with this release. Please contact your supplier for a new authorisation key where necessary. Please ensure that you have adequate PC backup before you install PC-Duo. You should have an up-to-date Emergency Repair Disk on Windows NT. You can easily make a new one by running RDISK.EXE from Start, Run, or File Manager File Menu, Run. Use the /s command line option so that RDISK backs up the system's security information as well as the main Registry contents. Contents ======== 1 Package Enhancements over the Previous Release 1.1 New Look Configuration dialogs 1.2 Print Capture for Windows 2000 and XP 1.3 Additional User Acknowledgements 1.4 View Window Floating Toolbar 1.5 Control IP Address Range 1.6 New Disable Feature Settings 1.7 Group Wizard Improvement 1.8 Preliminary Support for Windows.NET 2 Problems Corrected in this Release 2.1 Interaction with Login Prompt 2.2 Windows Always on Top 2.3 Windows 2000 Servers Lock on Disconnect 2.4 Compatibility with Remote Desktop Connection 3 Known Problems in this Release 3.1 Compatibility with Earlier Versions 3.2 Interaction with Other Remote Control Products 3.3 Windows 2000 and XP Limitations 3.4 Interaction with VMware Guest Operating Systems 4 Windows NT Support 4.1 Windows Control 4.2 Windows NT Client 4.3 Dealing with Blue Screens on Windows NT 4.4 Locked Desktop treated as Logged Off 5 Windows 9X and ME Support 5.1 Dealing with Fatal Exception Errors 6 Serialisation Options 6.1 Automatic Licensing 6.2 Kit Expiry Date 7 IPX Networks 8 TCP/IP Support 8.1 TCP/IP Windows Sockets 8.2 Connect by Hostname 9 Installation Notes 9.1 Client Installation Notes 9.2 Administrator Privilege Required 9.3 Windows on Windows Support 9.4 Creating a Silent Installation 9.5 Silent Installation Response File Format 9.6 Silent Installation Log File Format 9.7 Silent Installation Errors 9.8 Installing the Configurator 9.9 Installing Client and Control Configuration Files 10 Uninstallation Notes 10.1 Tidying up 11 Diagnostic Utilities 12 Automated Installation with PC-Duo Enterprise 13 Online Documentation 13.1 PC-Duo Resource Kit 14 Vector WWW Site 1 Package Enhancements over the Previous Release ================================================== For full details of product enhancements, please check the PC-Duo Online Help, Introduction, New Features topic. The following enhancements have been made since v7.01 was released:- 1.1 New Look Configuration dialogs ---------------------------------- Both the Control's Settings for Configuration and the Client Configurator's Advanced Mode tab dialogs have been changed to make them easier to use. The settings are still in the same places, but navigation to and between the various pages is much easier. 1.2 Print Capture for Windows 2000 and XP ----------------------------------------- Print Capture has now been implemented on Windows 2000 and XP Clients. 1.3 Additional User Acknowledgements ------------------------------------ It is now possible for the Client user to be prompted to acknowledge a change in the level of remote control access such as from Watch to Share Mode. This feature is not yet available in the Client Configurator, but it can be enabled by editing the Client's configuration file CLIENT32.INI. [Client] ViewModeAcknowledgement=x The following settings are available:- Where x= 0 this disables the feature 1 Acknowledges a change to Watch, Share, or Control modes 2 Acknowledges a change to Share or Control mode 3 Acknowledges a change to Control mode This will invalidate the file's checksum. To correct this, it is necessary to use the Client Configurator, in Advanced Mode, to open and then save the file. If the Configurator has not been installed on the Client PC (see Section 9.8 below), you can open the file using a Configurator installed on a separate Control PC. 1.4 View Window Floating Toolbar -------------------------------- New Shrink and Expand buttons have been added to the View Window floating toolbar. These can be used to reduce the amount of View window that is obscured by the floating toolbar in full-screen mode. The Shrink button reduces the toolbar to three buttons: Stop Viewing, Windowed Mode, and Expand Toolbar. It is also possible to move the floating toolbar so that it is partly off-screen. 1.5 Control IP Address Range ---------------------------- The Client Configurator, Advanced Mode, Users dialog can accept Control connections from a range of IP addresses as well as specific addresses. The format to use for this is:- 90.0.0.12-25 This will accept incoming connections from addresses 90.0.0.12 up to 25. 1.6 New Disable Feature Settings -------------------------------- The Control's Settings for Configuration: User Interface dialog provides new check boxes to disable the File Manager and the Blank Screen while viewing features. When these are selected, the Control user will not be able to use either of these features. 1.7 Group Wizard Improvement ---------------------------- The second step in the Control's "Create a Group" wizard contains a list of the Known Clients. That list is now sorted into alphabetic order. 1.8 Preliminary Support for Windows.NET --------------------------------------- Setup has been changed to recognise and install NetSupport PC-Duo on Server systems running Windows.NET RC1. It is treated in the same way as Windows XP. Tests here at Vector have not detected any significant problems. Refer to Section 3.3 below for general limitations that affect Windows.NET. Please let us know if you need any further assistance. 2 Problems Corrected in this Release ====================================== The following bugs have been fixed since v7.01 was released:- 2.1 Interaction with Login Prompt --------------------------------- The NetSupport PC-Duo Client does not take focus away from a Windows Login prompt when it is starting up. 2.2 Windows Always on Top ------------------------- The Help Request and User Acknowledgement windows will now appear on top of any other active windows. This should prevent them from getting lost on the desktop. 2.3 Windows 2000 Servers Lock on Disconnect ------------------------------------------- The PC-Duo Client could prevent any users from logging on to a Windows 2000 Server if the Client's "Lock on Disconnect" option was used and an active remote control connection was broken rather than being closed in an orderly fashion. The Client locked the console, but did not display the logged off desktop. It was necessary to reboot the system to regain control. This has been corrected. 2.4 Compatibility with Remote Desktop Connection ------------------------------------------------ Compatibility with Remote Desktop Connection has been improved. The PC-Duo "GINA" DLL, PCIGINA.DLL, is not installed in the Registry on Windows XP or on Windows 2000 or .NET Server systems. This allows the Remote Desktop Client to connect to a Server that also has the PC-Duo Client installed. Previously, an error message stated that the Windows logon software had been replaced by an incompatible PCIgina.dll. Note that, if an incoming Remote Desktop Client connects while a remote control session is active, this will disconnect the PC-Duo Client from the Server's console. The View window displays a "black screen" with the message "The Client is running a full screen application. To see this application running in a window, press ALT+Enter". In fact, it is necessary for the Control to disconnect and reconnect to the Client in order to view the Remote Desktop screen. However, this will not work if the Remote Desktop Client disconnects without logging off. The PC-Duo Client cannot display the locked desktop or the system console until the Remote Desktop user reconnects or logs off, respectively. 3 Known Problems in this Release ================================== If you encounter a problem, please check the notes here before reporting it to your support contact. 3.1 Compatibility with Earlier Versions --------------------------------------- The 32-bit Control will interwork with v3.72 or later Clients. However, new features such as Discussion Groups and Broadcast Show will not be available unless both Controls and Clients are v7.0 or later versions. We recommend that you do not use the v7 Control with Clients of versions earlier than v3.72. 3.2 Interaction with Other Remote Control Products -------------------------------------------------- As a general rule, it is not advisable to install more than one remote control product onto any PC. The drivers used by the Clients may interact in such a way as to render the entire system unstable. Contact your Vector supplier for assistance if you want to use more than one remote control product on a single Client system. 3.3 Windows 2000 and XP Limitations ----------------------------------- Support for Windows 2000 and XP is not as complete as some other platforms. However it is functional. Please note the following restrictions:- - Fast User Switching is a facility in Windows XP that permits a user to be disconnected temporarily while another user logs in to the system console. In common with many remote control products, PC-Duo is not compatible with this feature and disables it when it is installed. - The mirror driver does not have a Microsoft digital signature. When the Client is installed, the Control Panel, Add New Hardware wizard displays a dialog which states that the GDIHOOK5 driver does not have a signature and asks the user whether they want to continue. This dialog is closed by Setup but it is briefly visible on-screen. - When a Control is viewing a Windows 2000 Client, screen effects such as menu fade and the mouse cursor drop-shadow are disabled. This improves remote control performance. Please contact Vector if you encounter problems with Windows XP. 3.4 Interaction with VMware Guest Operating Systems --------------------------------------------------- There is a problem in the VMware Workstation v3.x SuperVGA driver that causes Guest display corruption when the PC-Duo Client is installed in a Windows NT Guest virtual machine that is running on an NT Host system. There is a workaround for this. Shut down the Guest system and close the VMware Workstation. Then use a text editor to open the Guest system's configuration file (normally called WinNT.vmx). Add the following line:- svga.noRectCopy = TRUE You can then restart VMware Workstation and the Windows NT Guest. 4 Windows NT Support ====================== This 32-bit kit can install the Client, Control, Remote Comms, Online Documentation, Scripting, and System Snapshot modules on Windows NT v4.0 on Intel platforms. A separate kit is available for NT v4.0 on Alpha. 4.1 Windows Control ------------------- The 32-bit Windows Control can be used on Windows NT. Please note the following restriction:- - Animated cursors, such as those provided with Windows 95 Plus!, are displayed in monochrome (black and white) instead of colour. 4.2 Windows NT Client --------------------- The 32-bit remote control Client runs as a "Service" on Windows NT. This allows it to start before a user has logged on to NT. A Control user can therefore connect to the NT Client while it is logged off. The Logon dialog box is activated by typing CTRL+ALT+ESC on the Control (not CTRL+ALT+DEL), or using the Client Menu, Send Ctrl+Alt+Delete command. The NT Client reports significant events such as starting and stopping, and any errors, through the NT Event Log. This can be examined using the "Event Viewer" in the "Administrative Tools" group. Look for entries in the System Log referring to "PCIsys". Client usage can also be logged to the NT Application Log or to a log file. Activate this by running the Client Configurator in Advanced Mode. Double- click on "Master Profile" to edit the common settings. Change to the "Security" tab and select the "Enable Logging" check box. Select "Log to NT Event Log" or the "Log to File" radio buttons, as required. The Client logs which Controls connected and when, and any file transfers. Use the NT Event Viewer to look for "PCIapp" entries in the Application Log. The Client Configurator can be used to direct the log file to a server. Use Advanced Mode, switch to the Security tab, enable logging to a file and use the [Browse] button to find the location in the Network Neighborhood. If a username is required to access the server share, it can be entered in the "As User" field. If the account requires a password, press [Set] and enter the username and password. The NT Client can log off or lock the workstation instead of rebooting when a Control disconnects. This avoids data corruption that could otherwise occur if NT is not shut down properly. The check boxes for these options are on the same "Security" tab as the Event Log settings above. If you need to reboot an NT Client by remote control, use the Shutdown option on the Start Menu (NT4), or Program Manager File Menu (NT3), to perform an orderly shutdown and restart. Please note the following restrictions:- - The Client's desktop colour may not be displayed correctly on a viewing Control. - The default behaviour is for a viewing Control to disable the wallpaper and any desktop pattern on the Client. This improves performance, but can be disconcerting for the user. This behaviour can be controlled from the View tab of the Control's View, View Menu, Settings for Client option, or the main View Menu, Settings for Current Configuration option. - It is not currently possible to see an NT Client which is running a full-screen Command Prompt (CMD.EXE) window although typing works. You can toggle back to windowed mode using ALT+ENTER, and view that as usual. Full-screen DOS Boxes (COMMAND.COM) are supported on Intel CPUs only. 4.3 Dealing with Blue Screens on Windows NT ------------------------------------------- When Windows NT encounters a fatal system error, it displays a blue screen and halts. The screen shows the reason for the stoppage, the address of the fault, the module that contains this address, the modules that were loaded in memory, and a stack dump. Windows NT can also be set to dump system memory to a file for later analysis. All of these items can be useful in analysing the problem. If you suspect that the problem is related to PC-Duo, please write down the STOP code, numbers, and addresses from the top of the screen, and the stack dump from the bottom of the screen. Make a note of the load addresses of any modules that are mentioned in the stack dump. These are listed in the middle of the screen. You should always note the module load addresses for the following PC-Duo components if they appear in the list:- CLHOOK4.DLL CLIENT32.EXE GDIHOOK4.DLL (GDIHOOK5.DLL on Windows 2000) PCICL32.DLL PCIHOOKS.DLL PCISYS.SYS This information should be recorded so that it can be sent to your Vector Networks supplier. The system dump file is normally too big to be useful unless you know how to analyse it. Restart Windows NT at this point. If it will not start, try to start in VGA Mode. This mode will not load the GDI display intercept drivers and this will produce an error when the Service Manager tries to start the Client32 Service. The NT Client is able to capture details of faults that occur in the display sub-system. These are logged in file PCIMSG.ERR, which is saved in the WINNT\SYSTEM32 directory. You will have to restart Windows NT before you can check whether or not this file exists. If it does, please send it with the other items. 4.4 Locked Desktop treated as Logged Off ---------------------------------------- If you use the "Lock Workstation on Disconnect" option, the NT Client will lock when the Control disconnects, provided it was logged off or locked when the Control connected. The locked state is treated as if the Client is logged off. This is controlled by a setting in the Client Configuration file CLIENT32.INI. The default setting is:- [Client] CheckDefaultDesktop=1 If this setting is not present, or the value is 0, the Client will treat the locked workstation as logged on. Depending on the Client Configuration, this can interfere with a Control's ability to connect to the PC. This will invalidate the file's checksum. To correct this, it is necessary to use the Client Configurator, in Advanced Mode, to open and then save the file. If the Configurator has not been installed on the Client PC (see Section 9.8 below), you can open the file using a Configurator installed on a separate Control PC. It is necessary to restart the Client32 Service to apply this change. This can be done using the Restart Client shortcut or RESTART.BAT. 5 Windows 9X and ME Support ============================= This 32-bit kit can install the Control, Client, Remote Comms, Online Documentation, and Scripting modules on Windows 95, Windows 98, and Windows Millennium Edition (ME). They should all operate correctly. From v7.0, the PC-Duo Client can be started without a reboot when it is installed on Windows 98 or ME. There is no longer a "Reset Video Driver" shortcut on these platforms. The Client is started from the Registry, using key:- HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\RunServices Look for string value "NetSupport PC-Duo Client". On Windows 95, performance and functionality are improved if the Microsoft "Winsock2" update is installed. Please note the following restrictions:- - Dynamic screen resolution changing on a Windows 95 Client is disabled unless the GDI display intercept driver has been loaded through the Registry. Setup does not do this, but the "Reset Video Driver" program will offer you a choice between loading the driver through the SYSTEM.INI, [boot] section, display.drv= line (the default) or the Registry. If you want to use dynamic screen resolution changing, for example using the STB Vision program, we recommend that you test it carefully. It does not work with ATI MACH 64 or Miro cards. - If you experience problems after installing PC-Duo or when viewing a Windows 95 Client, check the display acceleration setting. The method used is described in Section 5.1 part 4, below. If you find that the mouse cursor disappears, reduce the acceleration from "Full". If the Control sees a blank screen when viewing the Client, increase the acceleration setting from "None". If the Control's display is incomplete, try a setting other than "Full". - Animated cursors, such as those provided with Windows 95 Plus!, are displayed in monochrome (black and white) instead of colour. You may find that a black cursor becomes invisible on a black background. - Show over DECnet to four or more Clients may cause the Clients to disconnect. This can be corrected by increasing the PATHWORKS datalink buffers. To do this, right-click on "Network Neighborhood" (or press [Start], Settings, Control Panel, and double-click on "Network"). Highlight PATHWORKS NDIS Support, press [Properties], and then select the "Advanced" tab. Highlight "Buffers" in the property list, and then increase the "Value" from 20 to 40. - There is a fault in the Windows 95 NE1000 and NE2000 Enhanced mode NDIS drivers which makes connecting to Clients difficult, screen updates slow, and it may also make them disconnect. This fault can be eliminated by re-configuring to use either the Real-mode 16-bit NDIS or ODI driver. - A Bridge running on the PATHWORKS for Windows 95 (v1.0 and v1.0A) DECnet NetBIOS transport cannot make a connection to a Client running on the same PC. This is due to a bug in the PATHWORKS DECnet which incorrectly reports a "No Listen Outstanding" error. 5.1 Dealing with Fatal Exception Errors --------------------------------------- If you experience Fatal Exception Errors when starting Windows 95, the following steps should help you to eliminate the problem:- 1 - Start Windows in "Safe Mode". To do this, press the [F8] key while the "Starting Windows 9x..." message is visible after a reboot. Select "Start in Safe Mode" from the menu. This will allow you to use Windows tools to check or change the configuration. 2 - Check the PC-Duo Help, "Technical Reference", "Troubleshooting", and "Error Messages" sections for guidance on particular error messages and problems. 3 - Windows Setup may not have identified your display correctly, so you need to make sure that you are using the correct driver for your display adapter. To examine or change the display driver, right-click on the wallpaper and select "Properties" from the pop-up menu (or press [Start], Settings, Control Panel, and double-click on the "Display" icon), select the "Settings" page, and press [Change Display Type]. The current display driver and files are listed at the top, under "Adapter Type". Make a note of the driver name, version, and the files. If the driver is generic, (like "S3"), then you may find that Windows has a specific driver for your display (such as "S3 Trio32/64 PCI"). Press the [Change] button, and Windows will display a "Select Device" list. Select the "Show all devices" radio-button (at the bottom), and look to see if there is a specific driver listed for your particular display adapter. If so, (and you aren't already using it), highlight it and press [OK]. Windows will need to restart for this change to take effect, but if you have installed a PC-Duo Client already, you should run the "Reset Video Driver" icon from the PC-Duo folder first, or the PC-Duo Client will not be loaded after the restart. 4 - We have found that problems with some displays can be eliminated by reducing the level of acceleration used by Windows. To examine or change this, press [Start], Settings, Control Panel, double-click on the "System" icon, and select the "Performance" page. Press the [Graphics] button at the bottom. Change the Acceleration setting to "None" and press [OK] to apply the change. Restart Windows for this change to take effect. 5 - You can run the "Reset Video Driver" icon from the PC-Duo folder to transfer the PC-Duo intercept driver load command from SYSTEM.INI to the Registry. This generally improves compatibility with display drivers, but is known to cause a problem with Miro displays. 6 - If none of these steps help, you should contact your Vector Networks Supplier. Please provide them with a description of the problem, and details such as the display adapter and driver as requested. 6 Serialisation Options ========================= The licensing mechanism changed from that used in versions prior to v4.10. The new licensing mechanism uses file NSM.LIC (instead of CLIENT.SER). The "Apply a Key" shortcut is used to apply a key for v4.x to v7.x. This is a native Windows program. Note however, that keys are version-specific, so keys generated for version 6.x cannot be used with v7.x software and so on. Contact your supplier if you need a new key for v7.x. Maintained customers can obtain these at no charge. 6.1 Automatic Licensing ----------------------- The licence file shipped with this kit will be converted to give a 30-day evaluation on install. If you have already created a valid licence file using the "Apply a Key" program, copy file NSM.LIC into the same directory as SETUP.EXE, and Setup will use it for all future installations. You may want to save a backup copy of the original evaluation licence file before you do this. Setup can also apply a new licence key to an existing installation. Copy NSM.LIC into the same directory as SETUP.EXE, as before. When you run SETUP.EXE, deselect all installation options (Client programs, etc.), and press [Next>] to continue. Setup will not install any new software, but it will copy the new licence key file. 6.2 Kit Expiry Date ------------------- This kit has an ultimate expiry date of 30-Jun-2003. It can be installed after that date, but will not operate until re-keyed. Contact your supplier for assistance. 7 IPX Networks ================ When PC-Duo Clients or Controls start up on an IPX network, they try to establish which IPX networks are accessible. This allows the Client to make sure that it has a unique name on the network, and it also allows the Control to find Clients attached to remote networks. The Control will report problems to the user if any of the "known" networks cannot be reached, but the long timeout can cause a substantial delay for the Client. The IPX networks that are used can be controlled through the Client and Control profiles. Use the Client Configurator to edit the Client's Master Profile, or the Control Tools Menu, Configurations, Transport and Startup settings for the Control. Select the Transport tab, and enter the networks to be used or ignored as appropriate, or use the [Test] button to do this interactively. 8 TCP/IP Support ================== NetSupport PC-Duo works reliably over most TCP/IP Windows Sockets network transports. Notes on specific versions follow. 8.1 TCP/IP Windows Sockets -------------------------- On Windows 95 and 98, Windows Sockets transports are loaded by Windows searching the working directory, WINDOWS, and WINDOWS\SYSTEM directories, and then the DOS PATH, for a file called WSOCK2.DLL. If the wrong one is found and used, it may crash Windows. The Windows NT WSOCK32.DLL is normally in the WINNT\SYSTEM32 directory. Windows Show over TCP/IP Windows Sockets cannot display a full-screen DOS box. The DOS box interferes with Windows' timing. Use windowed mode DOS boxes instead. 8.2 Connect by Hostname ----------------------- On TCP/IP networks where the Clients are allocated IP addresses by a DHCP server, the NetSupport PC-Duo Control can be configured to connect to Clients using their Hostname instead of their Client Name and IP address. At present, the Control does not use the Client's Client Name as a default Hostname. If the Clients are on the local network or are "seen" when the Control browses the network, they will provide their hostnames in their replies to the Control. To store them, select all Clients that appear in the Browse folder, right-click, and select "Add to Client List" from the popup menu. For other Clients, such as those on remote subnets, the Hostname must be provided in another way. For small numbers of Clients, this can be done using the Client Menu, Quick Connect dialog to connect, specifying the network Transport as TCP/IP and entering the Client's Hostname in the Address field. Alternatively, you can edit a Known Client's Properties and copy the Client Name into the Address field. For large numbers of Clients, a Sample Script, HOSTNAME.SCP, can be used to automate the procedure. This can be run using the Script Editor or RUNSCRIP.EXE. It checks all of the Known Clients by reading through the CLIENT.NSM file. Any TCP/IP Clients that do not already have a Hostname are given one, using the syntax shown below:- client_name|>ip_address (client_name)|... For example:- DB-V2K|>90.0.0.127:5405 (DB-V2K)|2|0|Local||||| Once a Client has a Hostname, the Control ignores any IP address that may be stored in CLIENT.NSM. Instead, it uses a Domain Name Server (DNS) or Windows Internet Name Server (WINS) to resolve the Hostname into an IP address. Contact Vector Networks for further assistance with TCP/IP configuration. 9 Installation Notes ====================== This installation kit will function correctly on 32-bit platforms such as Windows 95, 98, Millennium Edition, Windows NT, 2000, XP, and .NET running on Intel processors. It does not support Windows NT on Alpha processors or Windows 3.1, Windows for Workgroups v3.11, OS/2, or DOS. Separate kits are available for these operating systems. We are also able to supply kits that use the Windows Installer Service (MSIEXEC). Please contact your supplier for further information on these "MSI" kits. Windows installation is started by running SETUP.EXE from Disk-1. This will start the InstallShield Setup Wizard. Change disks when you are prompted to do so. Help is available during the installation. Press the F1 key for assistance at any dialog box. Setup allows the installer to choose the installation directory and program folder name. The default values are different from previous kits, but if a previous installation is detected, Setup will take the current location and Client settings as defaults for the new installation. You may wish to install this kit to a different location so that you do not overwrite the previous version's files. 9.1 Client Installation Notes ----------------------------- You do not normally need to uninstall or even stop an older version Client before installing a new version. Setup will take its default installation directory from the existing Client (typically C:\PCD32). We recommend that you install the v7 Client to a different directory (e.g. C:\PCD710). If you install to the same directory, you cannot use the old version Uninstall to remove the files, and Setup may need to restart the PC in order to update shared system files. Setup allows the installer to set the Client's transport configuration. This can be modified by the Client Configurator once installation is complete. Setup can also apply a predefined Client configuration. Use the Client Configurator to generate a suitable configuration. Then copy the CLIENT32.INI file into the same directory as SETUP.EXE, and Setup will use it as a default for future installations. If Setup sees a CLIENT32.INI file in its directory, it will offer an "Apply predefined configuration" option. This takes precedence over any existing Client's settings. It is necessary to restart Windows in order to load the Client after it has been installed on Windows 95 or NT. Setup does not normally offer to reboot unless it has to replace a shared or system file. A reboot can be forced by adding AutoReboot=1 to the [Client32] section of SETUP.INI. For example:- [Client32] AutoReboot=1 If this value is defined, Setup will offer to reboot Windows on completion of the installation. This section can also be used to specify that an icon should be created for the Client in a specific program folder. This is controlled by value Icon=. If this is defined, it contains the folder name. For example:- [Client32] Icon=PC-Duo 32 This is typically accompanied by:- NoAutoStart=1 which causes Setup to remove the wclient= line from the [boot] section of SYSTEM.INI. This disables the normal Client startup on Windows 95. Setup normally creates icons for any program options that are installed. This can be disabled by adding:- CreateIcons=0 to the [Folders] section of SETUP.INI. Note that this will leave you with no easy way to run the Activate or Deactivate Client or the Reset Video Driver programs if these are provided for the Client's operating system. The command-line program, PCICONN.EXE, was introduced in v6.10 to implement a Connect to Control request for assistance. PC-Duo Setup can create a "Request Help" shortcut in the PC-Duo 32 program folder if the Control's IP address is specified in SETUP.INI. The syntax to use is:- [Client32] CallControl=ip.ad.dr.ess[,shortcut title] The Client uses TCP/IP port 5421 to Connect to the Control, which must be running and Available for the request to succeed. The port number is fixed and cannot be changed. The default shortcut title is "Request Help". This can be replaced by an alternative title if required. The replacement title is delimited from the Control's IP address by a single comma ',' character. For example:- [Client32] CallControl=10.0.0.100,Call Technical Support Setup will create the shortcut in the PC-Duo 32 folder when the Client is installed. Note that Setup will stop a running Client before it starts copying files. If you are installing under remote control, you will lose your connection. When the Client software has been installed, Setup will make the necessary changes to the Registry or to SYSTEM.INI so that Windows loads the Client automatically during startup. Setup may need to restart the PC in order to update critical system files. Please note the following restriction:- - The PC-Duo Client should not be installed on a PC that has another remote control product installed. This can result in system failure as kernel level modules are affected. We recommend that you remove any other remote control programs and restart your PC before you install NetSupport PC-Duo. 9.2 Administrator Privilege Required ------------------------------------ A complete installation of the Client on Windows NT, 2000, XP, or .NET requires Administrator privilege, as it performs system-level configuration changes. If you do not have the required privilege, Setup will exit after displaying an error message. Administrator privilege is not strictly required for Control installation, but Setup is configured to require privilege in all cases. It is possible to run Setup from a non-privileged account, in which case it will not be able to install the NT Client as a Service. If you need to do this for some reason, change the following line in SETUP.INI:- [Install] AdminRequired=1 to read:- AdminRequired=0 Setup will create program icons in a user program group instead of a common program group. If the Client is installed, the "Activate Client" icon command line contains the Client's configuration settings. It must be used from an account with Administrator privileges to configure Windows to load the NT Client. 9.3 Windows on Windows Support ------------------------------ In common with many installers, Setup requires the Windows NT 16-bit Windows on Windows (WoW) subsystem in order to start correctly. 9.4 Creating a Silent Installation ---------------------------------- InstallShield provides a facility for recording user selections during an installation. These responses can be used to provide the answers to questions during a subsequent "silent" installation - i.e. an unattended automatic installation. The procedure for creating a silent installation response file is as follows:- 1 - Copy the Evaluation Kit disk contents onto a suitable common location such as a file server. The directory structure should be such that the files from all of the disks are in the same directory, or they are in DISK1... subdirectories of a common parent directory (e.g. PCD32). 2 - Choose a PC that is typical of a group; 3 - Run Setup from the kit location, specifying the -r (record) command line option. For example:- Run: u:\pcd32\disk1\setup -r 4 - All of the responses that you make will be recorded. The response file, SETUP.ISS, is stored in the WINDOWS directory. See Section 9.5 below for an example of the response file format. 5 - Make selections during Setup that are appropriate for all of the target PCs. Particularly, you should select an appropriate network transport, and not display the Read Me notes or run the Client Configurator. 6 - When Setup has finished, copy the response file back to the kit location, so it is in the same directory as SETUP.EXE. This location can be read-only for the remainder of the installations. 7 - For each target PC, you must arrange for the following command to be executed:- u:\pcd32\disk1\setup -s -f2 Setup will look for the response file in the source directory. If it is in a different location, the -f1 option can be used to specify the correct path. For example:- u:\pcd32\disk1\setup -s -f1u:\pcdsetup.iss Setup also creates an installation log file. If the source area is read-only, or more than one target PC will be performing a silent install, they will be unable to write a log file to that location. The -f2 option provides an alternate path for the log file. For example:- u:\pcd32\disk1\setup -s -f2c:\pcdsetup.log The log files can be checked later. See Section 9.6 below for an example of the log file format. If you want to run a silent installation from a location which is not normally accessible and your script makes a NET USE to this location before starting SETUP, and disconnects the USE afterwards, you should use the following command format:- start/wait u:\pcd32\disk1\setup -SMS -s -f2c:\pcdsetup.log The Start/Wait command forces Windows to wait for SETUP.EXE to exit before it continues. The -SMS option forces SETUP.EXE to stay loaded until the installation has finished. Note that "SMS" must be in UPPER CASE. 9.5 Silent Installation Response File Format -------------------------------------------- The contents of a typical silent install response file are shown below. This example is provided for reference purposes. You will not normally need to edit this file. [InstallShield Silent] Version=v5.00.000 File=Response File [File Transfer] OverwriteReadOnly=NoToAll [DlgOrder] Dlg0=SdWelcome-0 Count=7 Dlg1=SdLicense-0 Dlg2=SdSetupTypeEx-0 Dlg3=SdAskDestPath-0 Dlg4=SdSelectFolder-0 Dlg5=SdAskOptions-0 Dlg6=SdFinish-0 [SdWelcome-0] Result=1 [SdLicense-0] Result=1 [SdSetupTypeEx-0] Result=Client [SdAskDestPath-0] szDir=C:\PCD32 Result=1 [SdSelectFolder-0] szFolder=PC-Duo 32 Result=1 [SdAskOptions-0] Component-type=string Component-count=1 Component-0=Preserve existing configuration Result=1 [Application] Name=NetSupport PC-Duo Version=7.10 Company=Vector Networks Lang=0009 [SdFinish-0] Result=1 bOpt1=0 bOpt2=0 Note that this file contains the installation directory, program folder, and configuration selections. 9.6 Silent Installation Log File Format --------------------------------------- A typical silent install log file contains:- [InstallShield Silent] Version=v5.00.000 File=Log File [Application] Name=NetSupport PC-Duo Version=7.10 Company=Vector Networks Lang=0009 [ResponseResult] ResultCode=0 A ResultCode value of 0 indicates sucess, negative values indicate failure. 9.7 Silent Installation Errors ------------------------------ You may see a ResultCode of -12 if the silent installation procedure does not use the same dialog sequence as the template installation, or an error caused the installation to be aborted. Further information on configuring and running silent installs is available in the PC-Duo Resource Kit. Contact Vector Networks for details. 9.8 Installing the Configurator ------------------------------- The InstallShield 5.5 installer does not permit the Client Configurator to be installed on its own, as was possible in earlier versions of the 32-bit kit. It is now a sub-component of the Control, and has to be installed as part of a Control installation. 9.9 Installing Client and Control Configuration Files ----------------------------------------------------- Setup has been enhanced so that it can install copies of the following Client and Control configuration files if they are present in the same directory as SETUP.EXE, and the "Apply predefined configuration" option is selected on the Client Configuration and Control Configuration Dialogs, respectively. Client Files: CLIENT32.INI - The main 32-bit Client configuration file CONTROLS.NSM - The Control list for Request Help and Call Control commands Control Files: CLIENT.NSM - The Known Clients database EXECUTE.NSM - Provides values for the Control's Execute at Client dialog GROUP.NSM - The Groups database REMOTE.NSM - Remote Network details SCRIPTS.NSM - Script details for the Control's Scripts Folder TOOLS.NSM - Tools Menu commands Samples of the CLIENT32.INI, SCRIPTS.NSM, and TOOLS.NSM files are provided in this kit. 10 Uninstallation Notes ======================== You do not normally need to uninstall or even stop an older version Client before installing a new version. If you do use the "De-activate Client" program on Windows NT, you will have to restart the system before you can install a new version. We hope that you won't need to uninstall PC-Duo. Follow this sequence to remove the software from your PC:- 1 - Use Start, Settings, Control Panel, Add/Remove Programs to uninstall NetSupport PC-Duo. This stops the Client and removes its SYSTEM.INI and/or Registry Entries. This will also delete the program folder, shortcuts, the files in the installation directory, and the driver files from the \WINDOWS\SYSTEM directory on Windows 95. 2 - If the Client was running, you will probably have to restart Windows before all of the files can be deleted. 10.1 Tidying up --------------- On some PCs, you may find that there is a hidden PCD32.GID file left in the \PCD32 directory. This is a Windows Help index file. Use the following DOS command to clear the hidden attribute:- C:\>attrib -h c:\pcd32\*.* You can then delete any remaining files in the \PCD32 directory. On Windows NT, you should also delete the following files from the \WINNT\SYSTEM32 directory:- CLHOOK*.DLL (and CLHOOK*.OLD) GDIHOOK*.DLL (and GDIHOOK*.OLD) PCIGINA.DLL (and PCIGINA.OLD) PCIMON.DLL (and PCIMON.OLD) PCISYS.NTK (on NT only) PCIVDD.DLL (and PCIVDD.OLD) On Windows NT v4, you should also delete the following file from the \WINNT\SYSTEM32\DRIVERS directory:- PCISYS.SYS (and PCISYS.OLD) These odd files will be tidied up automatically in a future release. 11 Diagnostic Utilities ======================== There are no diagnostic programs in this kit. 12 Automated Installation with PC-Duo Enterprise ================================================= NetSupport PC-Duo can be installed using the Software Distribution feature of PC-Duo Enterprise. PC-Duo Setup can also be used in "Silent" mode to automate Client installation. See Section 9.4 above for further details. Contact Vector Networks for further information. PC-Duo Enterprise is Vector Networks' PC network management package. 13 Online Documentation ======================== The PC-Duo v7.1 User Guide is included in this kit as an Adobe Acrobat Reader-compatible PDF file. Select the "Online Documentation" installation option in Setup to install this manual. It is in the same 9" * 7" format as the printed manual. You can print your own copy of the manual using the Acrobat Reader File Menu, Print command. Use the Print Setup command to change the paper size. 13.1 PC-Duo Resource Kit ------------------------ Additional information on the installation and use of PC-Duo is contained in the PC-Duo Resource Kit. Contact Vector Networks for details. 14 Vector WWW Site ==================== Visit our World Wide Web sites for support, new product, software update, and release information. Point your Web browser at URL: http://www.vector-networks.com