Part No. 207809-B August 2000 4401 Great America Parkway Santa Clara, CA 95054 Installing and Administering Optivity Quick2Config 2.
Copyright © 2000 Nortel Networks All rights reserved. August 2000. The information in this document is subject to change without notice. The statements, configurations, technical data, and recommendations in this document are believed to be accurate and reliable, but are presented without express or implied warranty. Users must take full responsibility for their applications of any products specified in this document. The information in this document is proprietary to Nortel Networks NA Inc.
Nortel Networks NA Inc. Optivity® Network Management Software License Agreement NOTICE: Please carefully read this license agreement before copying or using the accompanying Optivity network management software or installing the hardware unit with pre-enabled Optivity network management software (each of which is referred to as “Software” in this Agreement). BY COPYING OR USING THE SOFTWARE, YOU ACCEPT ALL OF THE TERMS AND CONDITIONS OF THIS LICENSE AGREEMENT.
with another vendor’s product, resulting in the defect; or (iii) damaged by improper environment, abuse, misuse, accident, or negligence. THE FOREGOING WARRANTIES AND LIMITATIONS ARE EXCLUSIVE REMEDIES AND ARE IN LIEU OF ALL OTHER WARRANTIES EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
LICENSEE ACKNOWLEDGES THAT LICENSEE HAS READ THIS AGREEMENT, UNDERSTANDS IT, AND AGREES TO BE BOUND BY ITS TERMS AND CONDITIONS. LICENSEE FURTHER AGREES THAT THIS AGREEMENT IS THE ENTIRE AND EXCLUSIVE AGREEMENT BETWEEN NORTEL NETWORKS AND LICENSEE, WHICH SUPERSEDES ALL PRIOR ORAL AND WRITTEN AGREEMENTS AND COMMUNICATIONS BETWEEN THE PARTIES PERTAINING TO THE SUBJECT MATTER OF THIS AGREEMENT.
207809-B
Contents 7 Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Text conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Installation directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Chapter 3 Installing Quick2Config on UNIX systems. . . . . . . . . . . . . . . . . . . . . . . . . . 37 Before you begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 What the installation program does . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Gaining access to the installation files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 Running the installation program . .
Contents 9 Configuring the SYSLOG server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71 Enabling remote client software setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 Copying the client installation files to a Windows system . . . . . . . . . . . . . . . . . . . 72 Copying the client installation files to a UNIX system . . . . . . . . . . . . . . . . . . . . . . 73 Setting up sample configuration files . . . . . . . . . . . . . . . .
Contents 207809-B
Figures 11 Figures Figure 1 Optivity Quick2Config 2.2 Introduction dialog box . . . . . . . . . . . . . . . . . . 29 Figure 2 Choose Install Folder dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 Figure 3 Choose Shortcut Location dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 Figure 4 Starting Server progress window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 Figure 5 Optivity Quick2Config Server window—Server ready . . . .
Figures 207809-B
Tables 13 Tables Table 1 Preinstallation checklist . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 Table 2 Supported platform configurations: Quick2Config server . . . . . . . . . . . . . 21 Table 3 Supported platform configurations: Quick2Config standalone client . . . . 22 Table 4 Supported platform configurations: Quick2Config Web client . . . . . . . . . 22 Table 5 Minimum disk space requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables 207809-B
Preface Welcome to Installing and Administering Optivity Quick2Config 2.2. The Optivity Quick2Config™ application offers a solution for one of the most problematic areas of networking—configuration management. By taking advantage of the unique capabilities of the Java programming language, Quick2Config provides comprehensive, platform-independent management capabilities that revolutionize the approach to configuring networks.
Preface Text conventions This guide uses the following text conventions: angle brackets (< >) Indicate that you choose the text to enter based on the description inside the brackets. Do not type the brackets when entering the command. Example: : bold Courier text Indicates command names and options and text that you need to enter. Example: Use the dinfo command. Example: Enter show ip {alerts|routes}. italic text Indicates book titles and variables in command syntax descriptions.
Preface 17 Screen illustrations The screen illustrations in this guide show the Java (Metal) “look and feel” option. You can change the “look and feel” of the Quick2Config window with the View > Preferences menu command. For more information, see Using the Optivity Quick2Config 2.2 Client Software. Related publications For more information about using Quick2Config, refer to: • Using the Optivity Quick2Config 2.
Preface If you purchased a Nortel Networks service program, contact one of the following Nortel Networks Technical Solutions Centers: Technical Solutions Center Telephone EMEA (33) (4) 92-966-968 North America (800) 2LANWAN or (800) 252-6926 Asia Pacific (61) (2) 9927-8800 China (800) 810-5000 An Express Routing Code (ERC) is available for many Nortel Networks products and services.
Chapter 1 Preparing to install the Quick2Config software This chapter describes important information about preparing your system prior to installing the Optivity Quick2Config 2.2 software. Nortel Networks strongly suggests that you read this entire chapter before starting the installation process.
Chapter 1 Preparing to install the Quick2Config software Preinstallation tasks This section describes preinstallation tasks that you must complete before installing the Quick2Config software. Preinstallation checklist Review the preinstallation checklist in Table 1 and perform all listed tasks before installing Optivity Quick2Config. Table 1 Preinstallation checklist Completed Task Verify supported platforms (page 20).
Chapter 1 Preparing to install the Quick2Config software 21 Verify that your system configuration matches one of the configurations listed in the following tables. Table 2 Supported platform configurations: Quick2Config server Hardware platform Operating system Intel Pentium, Pentium Pro, or Pentium II, 300MHz or faster Windows 95, Windows 98, Windows 2000, or Windows NT 4.0 (Server or Workstation) and Service Pack 5 RS/6000 & Power PC AIX 4.2, 4.3, or 4.3.2 AIX Java Developer Kit (JDK) 1.1.
Chapter 1 Preparing to install the Quick2Config software Table 3 Supported platform configurations: Quick2Config standalone client Window environment Network management platform (optional) Windows 95 Windows 98 Windows NT 4.0 Windows 2000 N/A HP Openview 5.x or 6.x RS/6000 & Power PC AIX 4.2, 4.3, or 4.3.2 AIX Java Developer Kit (JDK) 1.1.8 AIX Motif or Common NetView 4.1 or Desktop Environment Tivoli TME 10/Netview, 5.0x (CDE) 700 series HP-UX 10.2 or 11.0 HP-UX JDK 1.1.8 CDE HP Openview 5.
Chapter 1 Preparing to install the Quick2Config software 23 Determining the presence of a Web server The Quick2Config server uses a Web server to communicate with Quick2Config client sessions. You can use the Web server that is integrated with Quick2Config or you can use a third-party Web server. Determine whether the system onto which you are installing the Quick2Config server already has a Web server installed on it and, if it does, decide which Web server you will use.
Chapter 1 Preparing to install the Quick2Config software Table 5 Minimum disk space requirements (continued) Quick2Config software AIX HP-UX Solaris Windows 95 Windows 98 Windows NT Web client 6 MB 6 MB 6 MB 6 MB Standalone client installation files (These files are not required to run the Quick2Config application. For more information, see “Enabling remote client software setup” on page 72.
Chapter 1 Preparing to install the Quick2Config software 25 Where to go from here If you are installing Quick2Config on a Windows system, see Chapter 2, “Installing Quick2Config on Windows systems,” on page 27. If you are installing Quick2Config on a UNIX system, go to Chapter 3, “Installing Quick2Config on UNIX systems,” on page 37. Installing and Administering Optivity Quick2Config 2.
Chapter 1 Preparing to install the Quick2Config software 207809-B
Chapter 2 Installing Quick2Config on Windows systems This chapter describes how to install and uninstall the Optivity Quick2Config 2.2 server software on Windows systems.
Chapter 2 Installing Quick2Config on Windows systems Running the Quick2Config server installation program The Quick2Config server installation program displays a series of dialog boxes that guide you through the installation. When you have completed a dialog box, click Next to continue with the installation. You can click a window’s Previous button to move back through the dialog boxes, in order to review or change a setting.
Chapter 2 Installing Quick2Config on Windows systems 29 Figure 1 Optivity Quick2Config 2.2 Introduction dialog box 6 Click Next. The Software License Agreement dialog box opens. 7 Read the license agreement, and then do one of the following: • • 8 If you agree with the terms of the license, click Yes, and then click Next. The Important Information window opens. If you do not agree with the terms, click No to exit the installation program.
Chapter 2 Installing Quick2Config on Windows systems Figure 2 Choose Install Folder dialog box 9 Specify a location for the Quick2Config files. You can install the Quick2Config files in any directory on a local disk. The default directory is C:\Program Files\Optivity\Quick2Config. If you are using Quick2Config with a third-party Web server instead of the integrated Web server, you must create a link or an alias to the installation directory.
Chapter 2 Installing Quick2Config on Windows systems 31 Figure 3 Choose Shortcut Location dialog box 11 Specify the folder where you want to copy the Quick2Config program icons. By default, the installation program copies the program icons into a folder called Quick2Config 2.2. 12 Click Install. The installation program copies the files from the CD, and after a few moments, the Install Complete dialog box opens. 13 Click Done. This completes the installation process. Now you can verify the installation.
Chapter 2 Installing Quick2Config on Windows systems Verifying the server installation To verify that the Quick2Config server software has been installed correctly, do the following: • • Start the Quick2Config server (next). Start a Quick2Config client session (page 34). Starting the Quick2Config server The way you start the Quick2Config server for the first time depends on whether a third-party Web server is running on the computer where you installed the Quick2Config server.
Chapter 2 Installing Quick2Config on Windows systems 33 Figure 5 shows an example of the Optivity Quick2Config Server window. The message “Optivity Quick2Config Server -- Ready” indicates that the Quick2Config server has been installed correctly and that clients can connect to it.
Chapter 2 Installing Quick2Config on Windows systems where portnumber is a number other than the port on which the third-party Web server is running. If you plan to use a third-party Web server with Quick2Config, you can start the Quick2Config server as follows: ➨ From the Windows Start menu, choose Programs > Quick2Config 2.2 > Server. The Quick2Config server takes a few seconds to perform its startup procedures.
Chapter 2 Installing Quick2Config on Windows systems 35 Figure 6 Optivity Quick2Config Login dialog box You are now ready to log in to the Quick2Config server and complete the setup tasks. See Chapter 5, “Setting up Quick2Config,” on page 61. Or you can cancel the client session and install the Quick2Config standalone client on client computers, and then complete the setup tasks later. See Chapter 4, “Installing the Quick2Config standalone client,” on page 49.
Chapter 2 Installing Quick2Config on Windows systems Removing the Quick2Config server software When you install the Quick2Config server software, the installation program creates an uninstall program, which you can use to remove the Quick2Config files from your system. To remove the Quick2Config server software from your system: 1 Stop the Quick2Config server if it is running. 2 From the Windows Start menu, choose Settings > Control Panel > Add/Remove Programs.
Chapter 3 Installing Quick2Config on UNIX systems This chapter describes how to install and uninstall the Optivity Quick2Config 2.2 software on UNIX systems.
Chapter 3 Installing Quick2Config on UNIX systems What the installation program does The installation program for Quick2Config installs the standalone and Web versions of the client software, as well as the Quick2Config server. In addition, the installation program does the following: • • Creates an uninstall program for the Quick2Config software.
Chapter 3 Installing Quick2Config on UNIX systems 39 4 Navigate to the Quick2Config installation files. For example, if the installation CD is mounted on the drive /cdrom, type the following command: cd /cdrom/Install/ where platform is one of the following: • • • • 5 aix hpux/10.20 hpux/11.0 solaris Type the following command: sh q2c.bin A window opens, informing you that the installation program is being prepared.
Chapter 3 Installing Quick2Config on UNIX systems 6 Click Next. The Software License Agreement dialog box opens. 7 Read the license agreement, and then do one of the following: • • 8 If you agree with the terms of the license, click Yes, and then click Next. The Important Information dialog box opens. If you do not agree with the terms, click No to exit the installation program. Read the information in the Important Information dialog box, and then click Next.
Chapter 3 Installing Quick2Config on UNIX systems 41 If you are using Quick2Config with a third-party Web server instead of the integrated Web server, you must create a soft link to the Quick2Config installation directory. For example, create a Quick2Config directory in the Web server directory structure and link that directory to the Quick2Config installation directory. Caution: Do not install the Quick2Config software directly into the Web server’s document root directory. If you do, the existing index.
Chapter 3 Installing Quick2Config on UNIX systems Starting the Quick2Config server You can start the server from the local console (next) or from a remote console (page 43). Note: By default, the script that starts Quick2Config requires the X Windows system to be running, and it assumes that you want the Quick2Config console window to open when the server starts.
Chapter 3 Installing Quick2Config on UNIX systems 43 The Optivity Configuration Server window opens. This window displays information about the Quick2Config services and device drivers as they are loaded and started. The message “Optivity Quick2Config Server Ready” indicates that Quick2Config has been installed correctly and that clients can connect to the server (Figure 9).
Chapter 3 Installing Quick2Config on UNIX systems 3 Set the display environment variable. • If you are running the UNIX shell (sh) or the Korn shell (ksh), type the following commands: DISPLAY=localsystem:0.0 export DISPLAY where localsystem:0.0 is the local display. • If you are running the C shell (csh), type the following commands: setenv DISPLAY=localsystem:0.0 export DISPLAY where localsystem:0.0 is the local display.
Chapter 3 Installing Quick2Config on UNIX systems 45 After a few moments, the Optivity Quick2Config Login dialog box opens (Figure 10). The opening of this dialog box indicates that the Quick2Config client software has been installed correctly and that the client software can connect to the Quick2Config server. Figure 10 Optivity Quick2Config Login dialog box You are now ready to log in to the Quick2Config server and complete the setup tasks. See Chapter 5, “Setting up Quick2Config,” on page 61.
Chapter 3 Installing Quick2Config on UNIX systems Starting the Quick2Config server without a console window The script that starts the Quick2Config server on UNIX systems, server.lax, includes the -console option. This option requires that the X Window system is running, and it assumes that you want the Quick2Config console window to open when the server starts. If you do not want the Quick2Config console window to be displayed, you can edit the server.
Chapter 3 Installing Quick2Config on UNIX systems 47 3 Type the following command: ./uninstall The Uninstaller dialog box opens. 4 Click Uninstall. The uninstall program removes the Quick2Config server files from your system. The uninstall program does not remove the Quick2Config database directory /database. You might want to back up this directory so that it will be available when you reinstall Quick2Config. Installing and Administering Optivity Quick2Config 2.
Chapter 3 Installing Quick2Config on UNIX systems 207809-B
Chapter 4 Installing the Quick2Config standalone client This chapter describes how to install and uninstall the Optivity Quick2Config 2.2 standalone client software on Windows systems and on UNIX systems.
Chapter 4 Installing the Quick2Config standalone client • Creates a Quick2Config program group if one does not exist, and adds an icon for starting a Quick2Config client session. Running the installation program The installation program for the Quick2Config standalone client displays a series of dialog boxes that guide you through the installation process. When you have completed a dialog box, click Next to continue with the installation.
Chapter 4 Installing the Quick2Config standalone client 51 Figure 11 Optivity Quick2Config 2.2 Standalone Client Introduction dialog box 6 Click Next. The Software License Agreement dialog box opens. 7 Read the license agreement, and then do one of the following: • • 8 If you agree with the terms of the license, click Yes, and then click Next. The Important Information dialog box opens. If you do not agree with the terms, click No to exit the installation program.
Chapter 4 Installing the Quick2Config standalone client Figure 12 Choose Install Folder dialog box 9 Specify a location for the Quick2Config client files. You can install the Quick2Config files in any directory on a local disk. The default directory is: C:\Program Files\Optivity\Quick2Config\StandaloneClient 10 Click Next. The Choose Shortcut Location dialog box opens. 11 Specify the folder where you want the Quick2Config program icons to be copied.
Chapter 4 Installing the Quick2Config standalone client 53 Verifying the client installation on Windows systems To verify that the standalone client software has been installed correctly: 1 Start the Quick2Config server if it is not running. If the server is installed on a Windows system, see “Starting the Quick2Config server” on page 32. If the server is installed on a UNIX system, see “Starting the Quick2Config server” on page 42. 2 From the Windows start menu, choose Programs > Quick2Config 2.
Chapter 4 Installing the Quick2Config standalone client Installing the standalone client software on UNIX systems The installation program for the Quick2Config standalone client does the following: • • Copies the Quick2Config program files from the CD to the installation directory.
Chapter 4 Installing the Quick2Config standalone client 55 4 Navigate to the Quick2Config installation files. For example, if the installation CD is mounted on the drive /cdrom, type the following command: cd /cdrom/Install/ where platform is one of the following: • • • • 5 aix hpux/10.20 hpux/11.0 solaris Type the following command: sh client.bin A window opens, informing you that the installation program is being prepared.
Chapter 4 Installing the Quick2Config standalone client 6 Click Next. The Software License Agreement dialog box opens. 7 Read the agreement, and then do one of the following: • • 8 If you agree with the terms of the license, click Yes, and then click Next. The Important Information dialog box opens. If you do not agree with the terms, click No to exit the installation program. Read the information in the Important Information dialog box, and then click Next.
Chapter 4 Installing the Quick2Config standalone client 57 Verifying the client installation on UNIX systems To verify that the standalone client software has been installed correctly: 1 Start the Quick2Config server if it is not running. If the server is installed on a Windows system, see “Starting the Quick2Config server” on page 32. If the server is installed on a UNIX system, see “Starting the Quick2Config server” on page 42.
Chapter 4 Installing the Quick2Config standalone client Removing the Quick2Config standalone client software When you install the Quick2Config standalone client software, the installation program creates an uninstall program, which you can use to remove the Quick2Config files from your system.
Chapter 4 Installing the Quick2Config standalone client 59 where ClientInstallDir is the directory where you installed the Quick2Config client. The default installation directory is /opt/optivity/ncs/Quick2Config/StandaloneClient. 3 Type the following command: ./uninstall The Uninstaller dialog box opens. 4 Click Uninstall. The uninstall program removes the Quick2Config client files from your system. Installing and Administering Optivity Quick2Config 2.
Chapter 4 Installing the Quick2Config standalone client 207809-B
Chapter 5 Setting up Quick2Config This chapter describes the tasks that you need to perform after you have installed the Quick2Config software.
Chapter 5 Setting up Quick2Config Setup tasks overview After you have installed the Quick2Config server, you need to perform one or more setup tasks. Table 7 lists the tasks and the conditions under which you need to perform them. Table 7 Setup tasks If you... Perform this setup task... Installed the Quick2Config server and verified its installation Change the password for the Quick2Config administrator. See “Assigning the Administrator password” on page 63.
Chapter 5 Setting up Quick2Config 63 Assigning the Administrator password When you install the Quick2Config server, the installation program creates one Quick2Config user account called Administrator. This is the account that you must use to administer the Quick2Config server; it is the only account from which you can create Quick2Config user groups and user accounts, retain control over access permissions, and override locks on configuration data.
Chapter 5 Setting up Quick2Config Figure 15 Optivity Quick2Config Login dialog box 3 Verify that the User ID field reads Administrator and that the Password field is empty. 4 Click OK. After several seconds, the Optivity Quick2Config main window opens (Figure 16).
Chapter 5 Setting up Quick2Config 65 Figure 16 Optivity Quick2Config main window Menu Bar Toolbar Navigation Pane Context-Sensitive Pane Message Pane Status Bar Drag this border to resize the navigation pane. Drag this border to resize the context-sensitive and messages panes. 5 In the navigation pane, choose Server Setup > User Groups > Administrators > Administrator. 6 In the context-sensitive pane, click the Properties tab.
Chapter 5 Setting up Quick2Config 7 Complete the fields in the Basic tab as follows: • • • In the Actual Name field, type your name. In the Email Address field, type your e-mail address. In the Password field, type a password. As you type, asterisks represent the characters; you do not see the password. 8 Press [Enter] or [Tab]. Quick2Config pads the password field with additional asterisks and displays the Confirm password field. 9 In the Confirm password field, type your password.
Chapter 5 Setting up Quick2Config 67 To specify the port for the integrated Web server: 1 Start the Quick2Config server. Note: If the third-party Web server is set to run on the default port (port 80), the integrated Web server will not start and you will not be able to view the Quick2Config Help system. 2 Start a Quick2Config client session. 3 Log in as the Administrator. 4 In the navigation pane, choose Server Setup > Web Server. 5 In the context-sensitive pane, click the Properties tab.
Chapter 5 Setting up Quick2Config 7 In the Port field, type or select a port for the Web server. The standard Web server port is 80. If a third-party Web server is running on port 80, pick another port, such as 8080. Note: If you specify a port other than 80, Quick2Config users must specify that port in the URL when they connect to the server. For example, if you specify port 8080, the URL to connect to the Quick2Config server is http://servername:8080/index.html. 8 Restart the Quick2Config server.
Chapter 5 Setting up Quick2Config 69 4 In the context-sensitive pane, click the Properties tab. The Basic tab displays the properties for the TFTP server (Figure 19). Figure 19 Properties tab—Basic tab for TFTP server 5 In the Directory field, type the directory location of the running TFTP server. 6 Make sure that the port is 69.
Chapter 5 Setting up Quick2Config Determining whether a TFTP server is running On UNIX systems, you can determine whether your system is currently running a TFTP server (and its directory location) as follows: 1 Open a command window. 2 Open the /etc/inetd.conf file. 3 Look for a line that starts with tftp or #tftp, similar to the following: tftp dgram udp wait root /usr/bin/tftpd /tftphome If the line starts with the comment symbol (#), the TFTP server is not running.
Chapter 5 Setting up Quick2Config 71 Configuring the SYSLOG server The Quick2Config server includes a SYSLOG server, which records messages sent from devices within the network. The SYSLOG server starts on port 514 when you start the Quick2Config server. However, if another SYSLOG server is already running on your system, the Quick2Config SYSLOG server does not start and you cannot view the contents of the SYSLOG file from within the Quick2Config environment.
Chapter 5 Setting up Quick2Config Figure 20 Properties tab—Basic tab for SYSLOG server 5 Clear (or check) the Enabled check box. Enabling remote client software setup The login page for the Quick2Config Web client contains a link from which Quick2Config users can download the standalone client software. When users follow this link, their Web browser displays standalone.html, a Web page that contains links for downloading the installation files for each version of the standalone client software.
Chapter 5 Setting up Quick2Config 73 Copying the client installation files to a UNIX system To copy the standalone client installation files to a UNIX system: 1 Mount the CD drive. 2 Insert the installation CD into the CD drive. 3 Open a command window. 4 Create a directory for the files by typing the command: mkdir /usr/Quick2Config/server/bin/Downloads 5 Change to the location of the Quick2Config standalone client installation files.
Chapter 5 Setting up Quick2Config 2 Copy the contents of this directory to the \database\tftp directory. Note: The tftp directory is created the first time that you start the Quick2Config server. If you have not started the Quick2Config server, you can create the directory \database\tftp manually. Copying the configuration files on a UNIX system To copy the configuration files on a UNIX system: 1 Open a command window.
Chapter 6 Administering the Quick2Config server This chapter identifies key administrative tasks and provides recommendations for setting up user accounts, access permissions, and notifications. Information in this chapter is organized as follows: • • • “Viewing server events” (next) “Using command line options” on page 76 “Generating a debug report” on page 79 Viewing server events The Quick2Config server records messages about its operation in an event log file.
Chapter 6 Administering the Quick2Config server Table 9 Server information types for the event log (continued) Types Description Warning Messages about warnings, errors, and severe errors appear. Informative Informative messages, warnings, and all errors appear. This is the default setting. To change the type of information that the Optivity Quick2Config Server window displays: 1 Open the Optivity Quick2Config Server window. 2 Choose Log > Filter.
Chapter 6 Administering the Quick2Config server 77 Table 10 Server command line options (continued) Option Description -console Displays the log console when the server starts. By default, the console is displayed. -database path Specifies the root location of the Quick2Config database. Windows default: \Quick2Config UNIX default: /usr/Quick2Config/server/bin -debug_report Starts the Quick2Config Debug wizard. -docroot path Specifies the document root for the Web server.
Chapter 6 Administering the Quick2Config server Table 10 Server command line options (continued) Option Description -syslogd on | off Specifies whether to enable the built-in SYSLOG daemon on startup. Default: on -tftpd on | off Specifies whether to enable the built-in TFTP server at startup. Default: on -tftpdir path Specifies the default path to the TFTP directory. This option is effective only if the TFTP path has not been previously set. If the path has been set, use the -forcetftpdir option.
Chapter 6 Administering the Quick2Config server 79 Generating a debug report Quick2Config includes a Debug Wizard, which you can use to write bug reports. You can send these bug reports to Nortel Networks support engineers. To generate a debug report on Windows systems: 1 At a command line prompt, navigate to the Quick2Config installation directory. 2 Type the following command: server -debug_report The Debug Package Wizard opens. 3 Complete the information as requested by the Debug Wizard.
Chapter 6 Administering the Quick2Config server 207809-B
Chapter 7 Administering user groups and user accounts As the Quick2Config administrator, you are responsible for creating accounts for network engineers (users) who are authorized to configure network devices. You can create user groups as well as user accounts. This means that you can collect users who perform similar functions (and probably need access to the same set of items) together in one group and assign access permissions to the group instead of to each individual user account.
Chapter 7 Administering user groups and user accounts Adding a user group To add a new user group to the Quick2Config server: 1 Start a Quick2Config client session as Administrator. 2 In the navigation pane, choose Server Setup > User Groups. 3 In the context-sensitive pane, click the Palette tab. 4 Add a new group to the User Groups. You can do this in one of three ways: • • • Double-click the Group icon in the Palette.
Chapter 7 Administering user groups and user accounts 83 Renaming a user group Quick2Config assigns the name Group to each new user group that you create. You will probably want to rename groups to reflect the nature of the group. For example, if you have two levels of network engineers, you might want to create two groups and call one “Level 1” and the other “Level 2.” To rename a user group: 1 In the navigation pane, right-click the user group item that you want to rename.
Chapter 7 Administering user groups and user accounts Creating user accounts To create a user account in Quick2Config, you need to do the following: 1 Add the user account to the Quick2Config database. 2 Rename the user account. 3 Set the account properties—for example, password and e-mail address. 4 Set the account permissions. Each of these procedures is described in the following sections.
Chapter 7 Administering user groups and user accounts 85 The Rename dialog box opens. 3 In the Rename dialog box, type a name for the user account. 4 Click OK. In the navigation pane, the name of the user account changes immediately.
Chapter 7 Administering user groups and user accounts 3 Complete the fields in the Basic tab as follows: • • • • In the User Name field, type the user’s login name. In the Actual Name field, type the user’s name. In the Email Address field, type the user’s e-mail address. In the Password field, type a password. As you type, asterisks represent the characters; you do not see the password. 4 Press [Enter] or [Tab].
Chapter 7 Administering user groups and user accounts 87 You should change the permissions on new user accounts so that users can change their own passwords. Changing the account owner To change the owner of a user account: 1 In the navigation pane, click the user. 2 In the context-sensitive pane, click the Permissions tab. If the Permissions tab is not available, choose View > Context Pane > Permissions. The Permissions tab opens (Figure 25).
Chapter 7 Administering user groups and user accounts Assigning a user account to user groups Although you must create a new user account within a user group, Quick2Config does not automatically assign the new user account to the specified user group. Rather, you must use the Permissions tab to assign the user to the user group. To assign a user to one or more user Groups: 1 In the navigation pane, right-click the user account that you want to assign to a group.
Chapter 7 Administering user groups and user accounts 89 To change the owner of a user account: 1 In the navigation pane, click the user. 2 In the context-sensitive pane, click the Permissions tab. If the Permissions tab is not available, choose View > Context Pane, and select Permissions. The Permissions tab opens (Figure 25). Figure 25 Permissions tab 3 Click the arrow in the Owner box to see a list of possible owners. 4 Choose the new owner for the account.
Chapter 7 Administering user groups and user accounts 207809-B
Appendix A Recommended access permissions Table 12 shows the recommended permissions to restrict access to administrator accounts. Nortel Networks recommends that you implement these access permissions; however, the requirements of your organization might necessitate that you establish a different set of access permissions.
Appendix A Recommended access permissions 207809-B
Appendix B Resetting the Administrator password Quick2Config does not provide an automated mechanism for resetting the password on the Administrator account; however, if you forget the password on the Administrator account, you can use the following procedure to reset it. This procedure maintains device configuration information in the Quick2Config database; however, it removes all the Quick2Config server setup information (for example, Web server port, user groups, and user account information).
Appendix B Resetting the Administrator password 207809-B
Index A access permissions default 86 recommended 91 Administrator account access permissions 91 overview 63 password assigning 63 resetting 93 properties 66, 86 Administrator password, assigning 63 Administrator, Quick2Config, defined 15 C checklist, preinstallation 20 client Quick2Config standalone 19 Quick2Config Web 19 on UNIX systems 79 on Windows systems 79 Debug wizard 79 demonstration files 73 directories, installation 16 disk space requirements 23 E event log specifying information types 75
Index running 28 Quick2Config standalone client described 49 running 50 verifying 53, 57 Administrator account 66, 86 SYSLOG server 72 TFTP server 69 user accounts 85 Web server 67 InstallDir, defined 16 publications, related 17 L Q Login dialog box 35, 45, 64 Quick2Config standalone client 19 Web client 19 M main window 65 memory requirements 24 messages, filtering 76 O options, command line 76 P passwords assigning 63 confirming 66, 86 resetting 93 valid characters in 63 permissions, setting
Index 97 UNIX systems 73 Windows systems 72 installation, verifying 53, 57 installing on UNIX systems 54 Windows systems 49 removing from UNIX systems 58 Windows systems 58 starting on UNIX systems 44 Windows systems 34 Quick2Config tutorial setting up files 73 Quick2Configr program group 27 R related publications 17 requirements disk space 23 memory 24 U user accounts access permissions 91 actual name property 86 adding 84 changing owner of 87, 89 e-mail address property 86 password 86 renaming 84 settin
Index 207809-B