PC-Duo Version 8.00 =================== Release Notes ============= Copyright (c) 2003 PCI, Vector Networks Limited All Rights Reserved. Author : D. Briggs. Revision Date : 12th March 2003 This document contains the NetSupport PC-Duo PC-PC Remote Control package release notes for Version 8.00. 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 v8.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 Gateway Module 1.2 Control Shell Extensions 1.3 Support for VNC Clients 1.4 File Transfer Improvements 1.5 Control Command Line Chat 1.6 Small Icons 1.7 Send Beep in Chat 1.8 Group Wizard Improvement 1.9 Client and Control Configuration Improvements 1.10 MSN and Dual-channel Support 1.11 New Client Lock, Logoff and Reboot Options 1.12 User Acknowledgement Improvements 1.13 Client Configurator Force Encryption 1.14 Bridge Status 2 Problems Corrected in this Release 2.1 Connect by Hostname 2.2 DBCS Character Set Problems 2.3 Interaction with GFI FaxMaker 2.4 Hide When Idle Client Icon was not Hidden 2.5 Quick Connect Toolbar Button 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 Gateway 9.9 Installing Client, Control, and Gateway 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.10 was released:- 1.1 New Gateway Module ---------------------- A new Gateway module has been added to facilitate access to Clients that may be located behind an Internet Firewall. A new "Gateway" Setup type is available to install the Gateway and its Configurator program on Windows NT, 2000, XP, or .NET systems. Custom Setup can install a Gateway at the same time as other components. See Section 9 for further installation details. A new "HTTP" transport is used by Clients and Controls to communicate with the Gateway. This is in addition to the other available transports (IPX, NetBIOS, and TCP/IP). The Gateway must be accessible from both Clients and Controls using a static IP address. The Gateway uses a configurable port number to listen for Clients and Controls. Port 3085 has been registered for use by PC-Duo. A new Gateways folder has been added to the Control's Tree View. The Add a Gateway Wizard, accessible from the New toolbar button, is used to define the name, address, and port details for new Gateways. Once this has been done, the Control can Browse each Gateway for any registered Clients by double-clicking on its icon in the Gateways folder. Both Clients and Controls must be configured with a "Gateway Key" that is recognised by the Gateway. This is similar to the "Security Key" used by existing Controls and Clients. A single Gateway can recognise several Gateway Keys but it will only permit access where the Control and Client are both using the same Gateway Key. The Gateway must be licensed using a valid NSM.LIC file. The Gateway will limit the number of simultaneous connections to Clients according to the maximum number specified by the licence. Once configured and restarted, a Client will attempt to register with the Gateway. If this fails, it will make repeated attempts every 30 seconds. 1.2 Control Shell Extensions ---------------------------- The Control can be integrated with the Windows "Network Neighborhood" such that right-clicking on a Client PC provides "Remote Control" and "Chat" commands. This is enabled when the Control is installed and can be disabled using the Control's Settings for Configuration, Control Interface dialog. 1.3 Support for VNC Clients --------------------------- It is now possible to remote control Virtual Network Computing (VNC) Clients running on Unix or Apple Mac systems. This facility is not currently available for VNC Clients running on Windows systems. VNC Clients do not have a way to respond to the Control's Browse requests, so it is necessary to use the "Add a New Client" Wizard to define the VNC Client's name and address. Select "VNC Client" from the Client type list, and you can enter the relevant details. Remote Control is limited to viewing a VNC Client in Share Mode. Advanced features such as Chat, Message, and File Transfer are not available. 1.4 File Transfer Improvements ------------------------------ File Transfer performance has been improved when an existing file is being overwritten. Data blocks are compared and only transferred when they are different. This is enabled by default and provides significant benefits on slower connections. The Control remembers the last folder to be accessed locally and displays that folder when File Transfer or File Manager windows are re-opened. Files that have associated applications at the Control will have the appropriate icon displayed in the file list. A command to print the directory tree or file list are available in the File Transfer and File Manager windows. Use the View Menu, Print command to do this. Select the "Print Images" check box to print the associated icons for the files. 1.5 Control Command Line Chat ----------------------------- A new Control command line option, /A, can be used to start a Control, connect to a Client (specified using /C), and open up a Discussion Group. This facility is in addition to the remote control viewing options that were added in v7. 1.6 Small Icons --------------- The Control toolbar buttons default to using small icons. This gives more usable workspace. You can change back to large icons by right-clicking in a blank part of the toolbar and removing the tick next to Small Icons. This setting is also accessible from the View Menu, Toolbar command. The settings for the Control main window and View window are independent. 1.7 Send Beep in Chat --------------------- The ability to send a beep to attract the attention of the other user during a Chat has been reinstated. The command is on the Chat Menu. 1.8 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.9 Client and Control Configuration Improvements ------------------------------------------------- Both the Control's Settings for Configuration and the Client Configurator's Advanced Mode tab dialogs have been changed. The settings have been laid out in a tree view so that more room is available for each group and it is easier to find the various settings. 1.10 MSN and Dual-channel Support --------------------------------- Support for Multiple Subscriber Numbers (MSN) and Dual-channel BONDing has been added to the Control and Client Configurators. When the Control is using CAPI/ISDN to communicate with a Client on a Remote Network, it is possible to use both channels of an ISDN/2 line for remote control. This doubles the bandwidth available. The settings can be found on the Control's Settings for Configuration: Connectivity, Remote Dialup dialog and in the Advanced Mode Client Configurator, under Connectivity, Dialin Bridge. Where more than one line is available, it is possible to specify which telephone numbers are to be used. 1.11 New Client Lock, Logoff and Reboot Options ----------------------------------------------- The Control's Client Menu command that was used to Logoff an NT Client or Reboot a Windows 9x Client when the Control disconnected has been separated into two commands. Corresponding options to disable logoff and reboot have been added to the Settings for Configuration: Control Interface, Functions dialog and the Client Configurator, Security, Access Privileges dialog. In the Advanced Mode Client Configurator, a new Logoff if user has changed setting has been added to the Security, Disconnect dialog. This can be used separately or in combination with the Lock on Disconnect if not initially logged on setting. 1.12 User Acknowledgement Improvements -------------------------------------- A timeout has been added to the Advanced Mode Client Configurator, Security, User Acknowledgement dialog. Values in the range 0..255 seconds can be specified, where 0 = no timeout. The timeout starts when a Control or Script attempts to connect to the Client. If the Client user has not accepted or rejected the connection when the timeout expires, the User Acknowledgement dialog at the Client is closed and the Control or Script is informed that the connection was rejected. On the same Client Configurator dialog, a new "Acknowledge Connection Display" text box has been added. This allows a user-configurable message to be displayed at the Client when the Control attempts to connect. In addition to normal text, tokens are available to be used to identify the source of the connection attempt:- $LOGINNAME$ = The Control's logged on username $FULLNAME$ = The Control user's full name (Windows NT and above only) $COMPUTERNAME$ = The Control's computername $USERDOMAIN$ = The Control user's network domain It is also 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 or Share to Control Mode. The option that required a user acknowledgement when the remote control level changed have now been incorporated in the Client Configurator. The default setting is for no acknowledgement, but switching to Watch, Share, or Control modes can be enabled. No acknowledgement is required on changes below the specified threshold, so changes to Watch, for example, can be ignored while Share or Control must have an acknowledgement from the Client user. 1.13 Client Configurator Force Encryption ----------------------------------------- It is now possible to specify a minimum level of encryption that is to be used during a remote control session. The Client informs the Control when the connection is established. If the Control is already using a higher level encryption algorithm and that is also supported by the Client, then that encryption method will be used. The encryption will always be at least as strong as that specified. The settings can be found in the Advanced Mode Client Configurator, under Security, Connect. This is not supported by Controls older than v8.00. The v8.00 Client configured with this setting will reject connection attempts from older version Controls. 1.14 Bridge Status ------------------ A Client configured to load a Bridge program shows the Bridge status with its System Tray icon. The icon is red when the Bridge is loaded, and blue when the Bridge is unloaded. 2 Problems Corrected in this Release ====================================== The following bugs have been fixed since v7.10 was released:- 2.1 Connect by Hostname ----------------------- Clients could be lost from any Group that they were members of if Connect by Hostname was used. 2.2 DBCS Character Set Problems ------------------------------- Several problems arising from the use of Double-byte Character Set (DBCS) languages such as Japanese have been fixed. These affected the names of Clients, Groups, Remote Networks, and Scripts. Similar problems that affected file transfer of files with names or paths containing certain DBCS characters have also been fixed. 2.3 Interaction with GFI FaxMaker --------------------------------- PC-Duo on Windows 95, 98, or Me, used a file called PROCHOOK.DLL. This was installed into the WINDOWS\SYSTEM directory. GFI FaxMaker also installs a file with this name into the same location. Consequently, both products can interfere with each other. The file has been renamed to NSMPHOOK.DLL in v8. This eliminates run-time errors caused when the wrong file is installed, but there could still be problems if an old version of either product is uninstalled. The uninstaller will probably delete the old PROCHOOK file. 2.4 Hide When Idle Client Icon was not Hidden --------------------------------------------- A running Client's minimised window was not hidden when configured to be Hide when Idle and the Client is running on Windows 95, 98, or Me. 2.5 Quick Connect Toolbar Button -------------------------------- The Quick Connect Toolbar Button could not be added to the Control toolbar using the Customize command. 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 working with the Gateway will not be available unless both Controls and Clients are v8.0 or later versions. We recommend that you do not use the v8 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, Gateway, Remote Comms, Online Documentation, Scripting, and System Snapshot modules on Windows NT v4.0 on Intel platforms. Support for Windows NT v4.0 on Alpha processors is no longer available. 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 v8.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 v8.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-Sep-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. We can also 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:\PCD800). 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 ------------------------------------ Installation of the Client or Gateway 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=8.00 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=8.00 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 Gateway -------------------------- A separate Setup Type has been added so that the Gateway can be installed without other components such as the Client or Control. Use Custom Setup to install the Gateway with a combination of other modules. 9.9 Installing Client, Control, and Gateway Configuration Files --------------------------------------------------------------- Setup has been enhanced so that it can install copies of the following Client, Control, and Gateway configuration files if they are present in the same directory as SETUP.EXE and the "Apply predefined configuration" option is selected on the appropriate Configuration dialog. Client Files: CLIENT32.INI - The main 32-bit Client configuration file CONTROLS.NSM - The Control list for Request Help and Call Control commands HELPDESK.ICO - Alternative icon displayed in Acknowledgement dialogs 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. Both Control and Gateway store some configuration settings in the Registry. If the appropriate "Apply predefined configuration" option is selected, Setup can install these from user-supplied files. The Control's settings must be provided in file PCICTL.REG, and the Gateway's in GATEWAY32.REG. Note that Setup runs REGEDIT to install these settings without checking the contents of these files. 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 Gateway and removes any SYSTEM.INI and Registry Entries. It also deletes 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 v8.0 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