W INDOWS NT/2000 I NSTALLATION G UIDE R EVIS ION /U PDA TE I NF ORMA TION : 01/02/2002 O PERA TIN G S YSTEM V ERSION : W I N D OW S N T 4 . 0 O R L A T E R W I N D OW S 2 0 0 0 S OFTWARE V ERSION : V E R SI ON 1 . 5 - 0 T E C S YS D E V EL OPM E NT, I NC.
Copyright (c)2002 TECSys Development Inc. Printed in the United States of America. TECSys Development Inc. (TDi) makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability or fitness for any particular purpose. Furthermore, TDi reserves the right to revise this publication and to make changes from time to time in the content hereof without obligation of TDi to notify any person of such revision or changes.
Table of Contents 1.This Guide ...............................................................................................................................................1 1-1.Purpose ................................................................................................................................................1 1-2.Intended Audience ..........................................................................................................................1 1-3.
Appendix 1—Profile Rules and Examples ........................................................................................... 23 Appendix 2—HTML Directory Edits ...................................................................................................... 25 Appendix 2—Directory Listing ............................................................................................................... 27 Appendix 3—ConsolleWorks Version 1.4-0 to 1.5-0 Directory Cross-Reference .......................
1. This Guide 1-1. Purpose This guide describes how to install and configure ConsoleWorks on a host using Windows NT version 4.0 with Service Pack 3 or later or Windows 2000 operating system. 1-2. Intended Audience This guide is written for system administrators and managers installing and configuring the ConsoleWorks application on a Windows NT or Windows 2000 host. 1-3.
1-9. Customer Support TDi customer support is offered through several venues: internet website, email, phone and fax.
2. Introduction and Overview 2-1. Introduction to ConsoleWorks ConsoleWorks is an application built to monitor console port text or SYSLOG messages and to directly manage any device supporting console port connections. It runs on OpenVMS, Unix and NT/2000 platforms. In addition, ConsoleWorks can manage devices indirectly by using script-initiated management applications running on the ConsoleWorks host.
and optionally, • adding ConsoleWorks to the system startup, • editing templates to customize event and user templates, and • importing existing Users, Consoles, Scans, Events and/or Databases. ♦ note: Technically, ConsoleWorks has created an invocation after this stage of installation is completed. However, the invocation has no configured Ports, Profiles, Users, or Events. These components must be configured to make ConsoleWorks useful.
Distribution Kit or Package A Distribution Kit or Package is a file or files that enable a person to install the ConsoleWorks application. Each operating system (Windows NT/200 OpenVMS, Tru64, Linux, HP UX and Solaris) uses a unique distribution kit. Events Events are conditions occurring on devices which cause the devices to post status messages to their console ports or onto the network with Syslog.
Solaris A host running SUN Solaris 7.0 (or later) as its operating system. SPARC A host running a SUN SPARC processor as its primary CPU. TCP/IP or Transmission Control Protocol/ Internet Protocol port The Transmission Control Protocol/ Internet Protocol port(s) each host controls. Each invocation is assigned a specific TCP/IP port to use. User Account User account refers to the access a person receives when logging into ConsoleWorks.
Configuration Configuration is the period after Installation involving creating and configuring consoles, profiles, and user accounts. Invocations are in a default mode after installation and are not fully functional until configured. Configuration operations are performed using a web browser and are described in the ConsoleWorks Administration and User Guide. Invocation Components (Figure 2) Invocation A copy of the ConsoleWorks application running on the host.
Installation Tips and Recommendations ConsoleWorks supports customizing an invocation's templates. Each invocation has its own directory and subdirectories. The original templates created during installation are located in the Config subdirectory under the installation directory specified during the installation process. For Windows NT/2000, the default is C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\Config.
3. Pre-Installation This section contains information on the fundamentals required for installation. Note: 1) When installing the ConsoleWorks Server on Windows an error will be displayed if you try to install V1.5 when a previous version is installed. You must uninstall the previous version before attempting to install V1.5. 2) the ConsoleWorks directory structure for Version 1.5-0 is significantly different from Version 1.4-0. The base directory for Version 1.
ments Systems targeted for running a ConsoleWorks invocation are required to support the minimum disk space requirements shown in Table 4. RAM requirements A minimum of 128MBytes of operating system RAM is recommended. RAM requirements are installation type dependent. Requirements are affected by quantity and activity level of devices monitored by ConsoleWorks in addition to the amount required by the scan files which will be loaded.
4. Installation This section contains information on the first stage of the installation procedure. The second stage of the installation procedure uses a web browser and is discussed in the ConsoleWorks Administrator and User Guide. Note: If ConsoleWorks is being installed as an update to Version 1.4-0, a new directory structure will be created. Save existing template files, action routines, etc. prior to the installation and move them to the proper directory upon completion of the install. 4-1.
When the user launches ConsoleWorksserver.exe, the InstallShield Wizard progress box will appear. After the initial systems checks are completed the following Welcome panel will appear. The local system is now checked for previous versions that might be incompatible with this version. If such a version is currently installed, the following panel will be displayed. Should this panel be displayed, the user should press the Cancel button and proceed to de-install the previous version before continuing.
When all checks are completed successfully, the following panel will be displayed. Depress the Next> button to continue. The installation process will now display the License Agreement. Select the I accept the terms in the license agreement item and press Next>. The Customer Information panel will be displayed. Fill in the blanks and press Next>.
The installation type panel will be displayed. Under normal circumstances, select the Complete installation and press Next>. If ConsoleWorks is to be installed in a non-standard directory, select Custom and follow the direction panels.
When the Ready to Install the Program panel is presented select Install. The installation progress panel will be displayed.
When the installation is complete, the following panel will be displayed. Press the Finish button to exit the installation. 4-3. State of Installation after Completion When the ConsoleWorks installation is completed a new directory structure has been created in either the Default Installation Directory or in the Directory specified during the installation process.
4-5. Starting the ConsoleWorks Server To start the ConsoleWorks server access the Services Control Panel and start each executable, 1) ConsoleWorks LMF Server • note: if you would like to make certain all of your licenses loaded properly, you may check the contents of the following file: C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\Log\ConsoleWorksLMFService_Err.
and click on 'Stop.' Then select ConsoleWorks LMF Server Service and click on 'Stop.' It is recommended that the licensing service be shutdown when the ConsoleWorks Server Service is shutdown. 4-9. Adding functionality Import existing scan definitions ConsoleWorks comes with several scans. The scans can be imported during the installation process or later. The import_pcm.exe command is used to import the scans and events, which follow a PCM format from a command line interface.
corresponding template file is used for the help file. When Help (?) is selected in the web browser the contents of the applicable template file are displayed. Once the Event, Console or User is modified, a separate *.info (where * is the name of the Event, Console or User) file is created for that specific Event, Console or User and is stored in the Config subdirectory under the installation directory for the server. The next time the help (?) is selected, the *.info file is displayed.
help window will be the text contained in the CONSOLE.TEMPLATE file. The text in the file can be modified or completely replaced. If HTML tags are included, they are displayed only as the raw HTML tags and are not interpreted in the window. The file is used in a text box in a web browser environment.
5. Software Update This section provides information regarding an Update of the ConsoleWorks software. Note: If ConsoleWorks is being installed as an update to Version 1.4-0, a new directory structure will be created. Save existing template files, action routines, etc. prior to the installation and move them to the proper directory upon completion of the install. 5-1. Stop the ConsoleWorks Server and License Manager Access the Services Control Panel to stop the currently running ConsoleWorks services.
And if should look similar to the following: %CONWRKS-S-LICLOAD, License loaded for TECSYS-DEVELOPMENT/CONWRKS-DB-HSG %CONWRKS-S-LICLOAD, License loaded for TECSYS-DEVELOPMENT/CONWRKS-DB-HSX %CONWRKS-S-LICLOAD, License loaded for TECSYS-DEVELOPMENT/CONWRKS-SYSLOG %CONWRKS-S-LICLOAD, License loaded for TECSYS-DEVELOPMENT/CONWRKS-DEMO -CONWRKS-I-LICTERMAT, License TECSYS-DEVELOPMENT/CONWRKS-DEMO terminates 1-DEC-2001 2) ConsoleWorks Server Once the ConsoleWorks server is running it will use the ConsoleWorks
Appendices Appendix 1: Profile Rules and Examples Appendix 2: HTML Directory Edits Appendix 3: Directory Listing - of a default ConsoleWorks installation on Windows NT/2000 Appendix 4: ConsoleWorks Version 1.4-0 to Version 1.5-0 Directory Cross-Reference.
This Page Intentionally Blank 24
Appendix 1: Profile Rules and Examples Profile Rules rule 1: each profile has only one set of privileges per console port, rule 2: each profile may have access to one or more console ports, rule 3: each user may have only one active profile at a time, rule 4: more than one user may have access to and use a profile, and rule 5: privileges to a console port may vary between profiles. The following table can be used to help demonstrate the profile rules.
This Page Intentionally Blank 26
Appendix 2: HTML Directory Edits The ConsoleWorks HTML directory contains static HTML files used by the ConsoleWorks web server. These files are NOT intended to be modified by ConsoleWorks customers. If these files are modified, the results may be unpredictable and are not supported by TDi customer support. Replacement of the files with the default files is recommended. TECSys Development does provide for the exception that the TDI_MINI.GIF file with may be replaced with a company logo of the same size.
This Page Intentionally Blank 28
Appendix 3: Directory Listing - of a default ConsoleWorks installation on Windows NT/2000 Below is an example directory listing for a ConsoleWorks installation on Windows NT/2000. Volume in drive C has no label. Volume Serial Number is 1380-0FE3 Directory of C:\Program Files\TECSys Development, Inc 08/20/2001 08/20/2001 10/03/2001 11/28/2001 11/28/2001 01:42p
01:42p 09:05a 02:38p 03:07p 1 File(s) . .. ConsoleWorks Client ConsoleWorks Server 0 dir.10/24/2001 01:40p 1,299 AUTOLOGIN.BAT 07/15/2001 11:10p 3 File(s) 915 BROADCAST.BAT 3,584 bytes Directory of C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\Actions\Purge 11/28/2001 11/28/2001 07/15/2001 07/15/2001 02:38p
02:38p 11:10p 11:10p 2 File(s) . .. 1,370 AUTOCANCEL.BAT 915 BROADCAST.10/24/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 09/28/2001 09/28/2001 09/28/2001 10/24/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 09/28/2001 11/26/2001 09/28/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/
09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 03:32p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 105 File(s) 15,049 TFSHOW.JS 13,283 TPROX.CAB 8,925 TPROX.CLASS 15,917 TPROX.JAR 860 TRIDOWN.GIF 863 TRIRIGHT.GIF 870 X.GIF 726,852 bytes Directory of C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\Default\HTML\PC 11/28/2001 11/28/2001 10/24/2001 02:38p
. 02:38p .. 01:40p 2,440,412 WINNTAGT.10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 09/28/2001 09/28/2001 09/28/2001 10/24/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 09/28/2001 11/26/2001 09/28/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 09/28/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/
10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 09/28/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 10/24/2001 11/28/2001 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 03:32p 01:40p 01:40p 01:40p 01:40p 01:40p 01:40p 02:38p
105 File(s) 118 47 1,428 943 15,360 1,628 1,536 807 818 57,897 67,143 15,049 13,283 8,925 15,917 860 863 870 SICK.GIF SITEBG.GIF STATUSFRAME.CLASS TDICACERT.Directory of C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\LMF\TDI_Licenses 11/28/2001 11/28/2001 08/06/2001 08/06/2001 08/06/2001 08/06/2001 08/08/2001 02:38p
02:38p 11:23a 11:23a 11:23a 11:23a 12:00p 9 File(s) . .. 285 CONWRKS-DB-HSG.lic 285 CONWRKS-DB-HSX.lic 283 CONWRKS-SYSLOG.lic 283 CONWRKS-SYSLOG-6.lic 308 demo.Directory of C:\Program Files\TECSys Development, Inc\ConsoleWorks Server\Config 11/28/2001 11/28/2001 09/28/2001 09/26/2001 09/26/2001 10/24/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 09/28/2001 02:38p
02:38p 03:33p 04:55p 04:55p 01:40p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 03:33p 16 File(s) Total Files Listed: 351 File(s) . .. 245 CONSOLE.TEMPLATE 1,020 EVENT.Appendix 4: ConsoleWorks Version 1.4-0 to Version 1.5-0 Directory Cross-Reference This section provides a guide to locating files from earlier versions of ConsoleWorks on Windows NT/2000. ConsoleWorks Version 1.4-0 ConsoleWorks Version 1.
Document End 38