PC-Duo Version 8.60 =================== Release Notes ============= Copyright (c) 2004 Vector Networks and NetSupport Limited. All Rights Reserved. Author : D. Briggs. Revision Date : 1st July 2004 This document contains the PC-Duo Remote Control package release notes for Version 8.60. 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 PC-Duo earlier than v8.50 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 Software Snapshot 1.2 User Prompting 1.3 Refresh Snapshot in EXECUTE.NSM 1.4 Improvements to the display of DBCS on Japanese 1.5 Pulse Dialling in Control New Remote Network Wizard 1.6 Script Agent Column Titles Translated 1.7 Control View Window Toolbar can be Customised 1.8 Mouse Movements Recorded in Replay File 1.9 Client Customised Text Display 2 Problems Corrected in this Release 2.1 Assert Failed COOLBAR.CPP Closing File Distribution 2.2 XCopy Script Function Corrected 2.3 Mouse Movements Displayed at Client in Show 2.4 Mouse Pointer Displayed at Client when Showing in Screen Scrape Mode 2.5 Client Help Request Fails 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 3.5 Logoff on Disconnect on Windows 9x 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 Creating a Silent Installation 9.4 Sample Response Files 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 v8.50 was released:- 1.1 Software Snapshot --------------------- Software inventory has been added to System Snapshot. It is based on PC-Duo Enterprise technology. It uses a directory scan of the Client PC and a set of user-modifiable package recognition rules (the "Applications Library") to identify the software installed at the Client. Software Snapshot requires a v8.60 PC-Duo Client with System Snapshot enabled for full functionality. A simpler Software Snapshot can be obtained from older version Clients. Scripts have been provided to enable and disable the directory scanning feature that the Client uses to collect the inventory data. SWSNAPON.SCP is run from the Script Editor. It enables directory scanning and performs a Snapshot Update so that the Client will collect the necessary data. Create Predefined Variables ClientName or GroupName and Username to control the script's behaviour. SWSNPOFF.SCP can be used to disable directory scanning without deleting any data that may already have been collected by the Snapshot Client. Software Snapshot is accessed from the Control's Tools Menu. This command will be enabled automatically if the Control is installed using the "Apply pre-defined configuration" option. Otherwise, it is necessary to add a new menu entry to the User-defined Tools. Use "Software Snapshot" as the menu text, SWINV.EXE in the Program Path, and "$CLIENTNAME$^" in the Arguments. Highlight a Client in one of the Control's list views and select Software Snapshot from the Tools Menu, User-defined commands. This connects to the Client, collects the directory scan data, and attempts to identify the applications that are present. Any packages that are recognised using the Applications Library are displayed in the Software Snapshot "Confirmed Identifications" page. By default, the directory scan collects Version Information data from executable files (*.EXE) on the Client. This Version Information is used to identify packages that have not already been recognised using the Applications Library. These are displayed in the Software Snapshot "Provisional Identifications" page. Any executable files that exist in directories that do not contain one of the confirmed or provisionally-identified packages will be listed in the Software Snapshot "Unidentified Software" page. Refer to the Online Help for further information. 1.2 User Prompting ------------------ This feature has been added to System Snapshot. A prompt file (LUTINFO.REF) is edited using the "Edit Prompt File" command on the Control's Tools Menu. This command is enabled automatically when the PC-Duo Control is installed using the "Apply pre-defined configuration" option. If this is not done, create a new User-defined Tools entry with "Edit Prompt File" as the Menu Text, REFEDIT.EXE in the Program Path, and "LUTINFO.REF" in the Arguments. Use the Script Editor to run Script LUTINFO.SCP. This sends the prompt file to one or more Clients. Create Predefined Variables ClientName or GroupName and Username to control the script's behaviour. The logged-on user is prompted to answer the questions in the prompt file when the Client updates its Snapshot inventory. This procedure normally happens once when a new prompt file has been sent to the Client. The answers are stored at the Client (in file LUTINFO.INF) and are displayed in the System Snapshot, "User Responses" page. Refer to the Online Help for further information. 1.3 Refresh Snapshot in EXECUTE.NSM ----------------------------------- A "Snapshot Update" command has been added to the Control's Execute at Client Saved List (stored in file EXECUTE.NSM). The new command runs the System Snapshot inventory update program (CLBOOT32.EXE) on the Selected Client or Clients. This command is enabled automatically when the PC-Duo Control is installed using the "Apply pre-defined configuration" option. If this is not done, create a new entry in the list that executes command CLBOOT32.EXE /D /M. 1.4 Improvements to the display of DBCS on Japanese --------------------------------------------------- The PC-Duo Control and Gateway user interfaces have been updated to improve the display of double-byte character sets such as Japanese. 1.5 Pulse Dialling in Control New Remote Network Wizard ------------------------------------------------------- The Control can dial a Remote Bridge using Tone or Pulse dialling. This is configured in the Add a Remote Network Wizard and the Remote Network Properties dialog. Previously, it was only possible to use Pulse Dialling if the telephone number was prefixed by a 'P'. This restriction still applies to numbers dialled by the PC-Duo Bridge. 1.6 Script Agent Column Titles Translated ----------------------------------------- The titles of the "Description", "Script", "Next Schedule" etc. columns have been localised. Previously, they were displayed in English. 1.7 Control View Window Toolbar can be Customised ------------------------------------------------- It is now possible to customise the buttons that appear in the Control's View Window Toolbar. While a View Window is open, use the View Menu, Toolbar, Customize command or right-click in an empty part of the toolbar and select Customize from the popup menu. 1.8 Mouse Movements Recorded in Replay File ------------------------------------------- Previously, Replay Files did not include mouse movements and they were not displayed in the Replay Viewer. This limitation has been removed. 1.9 Client Customised Text Display ---------------------------------- It is possible to configure the behaviour of the Customised Text display at the Client. This text is displayed when a Control is connected or viewing the Client. The behaviour is set using an entry in the Client configuration file (CLIENT32.INI). The following settings are available:- [Client] StatusMode=0/1/2 The default setting is 1. This moves the Customised Text away automatically when the Control's mouse moves over it. Setting 0 allows the Control to drag the Text display with the mouse. Setting 2 is semi-automatic, allowing the Control to drag it if the CTRL key is pressed. Adding or changing this setting will invalidate the CLIENT32.INI 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, you can open the file using a Configurator installed on a separate Control PC. 2 Problems Corrected in this Release ====================================== The following bugs have been fixed since v8.50 was released:- 2.1 Assert Failed COOLBAR.CPP Closing File Distribution ------------------------------------------------------- Previously, the Control occasionally failed with an Assert failed in COOLBAR.CPP, line 1657, when the File Distribution window was closed. This problem has been corrected. 2.2 XCopy Script Function Corrected ----------------------------------- Previously, the XCopy Scripting command did not copy subdirectories. This has been corrected. 2.3 Mouse Movements Displayed at Client in Show ----------------------------------------------- Previously, the mouse pointer was not displayed at the Client during a Show when the Control's screen resolution was lower than the Client's and the mouse was positioned outside the Show Window when the Show session started. This has been corrected. 2.4 Mouse Pointer displayed at Client when Showing in Screen Scrape Mode ------------------------------------------------------------------------ Previously, the mouse pointer was not displayed at the Client during a Show in Screen Scrape Mode. This has been corrected. 2.5 Client Help Request Fails ----------------------------- Programs such as Help Request that are executed by the Client may not have access to the same environment variables as the logged-on user. This can prevent the Help Request from running, as it needs access to the logged-on user's TEMP directory. This problem has been fixed. 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. 3.5 Logoff on Disconnect on Windows 9x -------------------------------------- Windows 9x Clients cannot distinguish between logged on and logged off states, so they will always logoff or reboot when a Control disconnects if either logoff on disconnect or reboot on disconnect checkboxes is selected in the Advanced Mode Client Configurator, Security, Disconnect dialog. 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, 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 "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.5. 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 31-Dec-2004. 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 ================== 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 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 2003 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 v8.0 and older kits. If an old version installation is detected, Setup will offer to uninstall it automatically during the new installation. Setup can preserve the current configuration settings if this is required. 9.1 Client Installation Notes ----------------------------- You do not normally need to uninstall or even stop an older version Client before installing a new version. The new Setup will install to its default directory (normally C:\PCD32). The old version will be uninstalled, if that is necessary, but its configuration files can be preserved for the new installation. Setup can also apply a pre-defined Client configuration. Use the Client Configurator to generate a suitable configuration. Then copy the CLIENT32.INI file into the same directory as SETUP.EXE. Setup will use it as a default for future Client installations. If Setup sees a CLIENT32.INI file in its directory when it is installing a Client, it will offer an "Apply pre-defined configuration" option. This takes precedence over the preservation of any existing Client's settings, but either option can be selected. 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 the SETTINGS.INI file. 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 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 SETTINGS.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 program folder if the Control's IP address is specified in SETTINGS.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 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 PC-Duo. 9.2 Administrator Privilege Required ------------------------------------ Installation of the Client or Gateway on Windows NT, 2000, XP, or 2003 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 SETTINGS.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 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 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 -f1"u:\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 -f2"c:\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 -s -f2"c:\pcdsetup.log" The Start/Wait command forces Windows to wait for SETUP.EXE to exit before it continues. 9.4 Sample Response Files ------------------------- The PC-Duo DS9 kit includes the following sample Silent Install Response files. These can be selected as appropriate using the -f1".iss" option described above. The default response file is SETUP.ISS. REMOVE.ISS - This runs Maintenance Mode, Remove to uninstall PC-Duo REPAIR.ISS - This runs Maintenance Mode, Repair to re-install PC-Duo SETUP.ISS - This runs a normal first-time Client-only installation UPDATE.ISS - This can be used to upgrade to a new version DevStudio9 provides Maintenance Mode, but to prevent any errors that might result from the use of the "wrong" response file, Record Mode includes a "Silent Install Manager" dialog. This allows the user to choose between the available Setup Modes. For example, a "First Time Install" can also be used to modify, repair (re-install), or upgrade the existing software. 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=v7.00 File=Response File [File Transfer] OverwrittenReadOnly=NoToAll [{55C781E8-CCBD-11D7-82C2-AA0004001604}-DlgOrder] Dlg0={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskOptions-0 Count=8 Dlg1={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdWelcome-0 Dlg2={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdLicense-0 Dlg3={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdSetupTypeEx-0 Dlg4={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskDestPath-0 Dlg5={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdSelectFolder-0 Dlg6={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskOptions-1 Dlg7={55C781E8-CCBD-11D7-82C2-AA0004001604}-SdFinish-0 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskOptions-0] Component-type=string Component-count=1 Component-0=FIRST_TIME_CAPTION Result=1 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdWelcome-0] Result=1 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdLicense-0] Result=1 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdSetupTypeEx-0] Result=Client [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskDestPath-0] szDir=C:\PCD32 Result=1 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdSelectFolder-0] szFolder=PC-Duo Result=1 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-SdAskOptions-1] Component-type=string Component-count=1 Component-0=APPLY_CONFIGURATION_OPTION Result=1 [Application] Name=PC-Duo Version=8.60 Company=Vector Networks Lang=0009 [{55C781E8-CCBD-11D7-82C2-AA0004001604}-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=v7.00 File=Log File [Application] Name=PC-Duo Version=8.60 Company=Vector Networks Lang=0009 [ResponseResult] ResultCode=0 ResultCode=0 indicates success. 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 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 pre-defined configuration" option is selected on the appropriate Client, Control, or Gateway 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, EXECUTE.NSM, 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 pre-defined 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 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 ================================================= 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.3 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.6 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. Printed manuals can be ordered online from:- http://www.vector-networks.com/support/docs.htm 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