Return to Menu Norstar ICS Remote Tools User Guide NRU version 10 © Copyright Nortel Networks, 2003 Norstar and Meridian are trademarks of Nortel Networks. Microsoft, MS-DOS, Windows and Excel are registered trademarks of Microsoft Corporation in the United States and other countries. InstallShield is a registered trademark of InstallShield Corporation.
P0604573 05
Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 How this guide is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 What is ICSRT? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Getting a Quick Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table of Contents Editing customer records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 Copying customer records to create new records . . . . . . . . . . . . . . . . . . . . . 47 Viewing customer records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 Deleting customer records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Quitting the Customer Info screen . . . . . . . . . . . .
Table of Contents 5 Fatal error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 Chapter 7 Using Workbooks and off-line programming . . . . . . . . . . . . . . . . . . . . . . . 83 Understanding workbooks and off-line programming . . . . . . . . . . . . . . . . . . . . . . . . . 84 Restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 Configuring a workbook . . . . . . . . . . . . . . .
Table of Contents RAD alarm codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122 Error messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123 The Debug tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125 Appendix A Connecting a modem. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figures Figure 1 Connecting through a dial-up modem . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Figure 2 Connecting through a PSTN line to the system attendant . . . . . . . . . . . . 18 Figure 3 Connecting directly to the RAD using a serial cable . . . . . . . . . . . . . . . . 19 Figure 4 Pinouts for direct connect, RAD to computer . . . . . . . . . . . . . . . . . . . . . . 19 Figure 5 Pinouts for direct connect, Global RAD to computer . . . . . . . . . . . . . . . .
Figures Figure 41 Workbook Configuration screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87 Figure 42 Select System Size dialog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 Figure 43 Hardware screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89 Figure 44 Program ICS dialog box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables Table 1 Customer and connection information . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 Table 2 Connection Properties fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52 Table 3 Remote Set tool command buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 Table 4 Navigation tree icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68 Table 5 Program ICS dialog box options . . . . . . . . . . . . . . . .
Tables P0604573 05
Preface This guide is intended for administrators who want to centrally manage one or more Norstar systems from a computer remote to the system. The communication between the system and the remote computer is established by connecting a Remote Access Device (RAD) to the Norstar system, providing a way for the remote computer that is running ICS Remote Tools (ICSRT) to establish a programming connection to the Norstar system.
Preface What is ICSRT? If you have older versions of Norstar systems, you may be familiar with the Norstar Manager application. The ICSRT replicates some functions of that application. Warning: Data created through the Norstar Manager cannot be used by the ICSRT application. You need to re-enter all customer information through the ICSRT application. ICSRT is a software package that assists you in administering, maintaining, and programming a Norstar ICS (Integrated Communications System).
Preface 13 Text conventions This guide uses the following text conventions: angle brackets (< >), italic text Indicates that you choose the text to enter based on the description inside the brackets. Do not type the brackets when entering the command. Example: If the command syntax is: ping you enter: ping 192.32.10.12 angle brackets (< >), bold text Indicates a keyboard command key, such as or .
Preface How to get help USA and Canada Authorized Distributors - ITAS Technical Support Telephone: 1-800-4NORTEL (1-800-466-7835) If you already have a PIN Code, you can enter Express Routing Code (ERC) 196#. If you do not yet have a PIN Code, or for general questions and first line support, you can enter ERC 338#. Website: http://www.nortelnetworks.
Chapter 1 Understanding remote management This chapter provides an overview of the process of using the ICS Remote Tool (ICSRT) for remote system management.
Chapter 1 Understanding remote management Connection hardware requirements Before you can use the ICSRT to configure remote systems, you must install a RAD (MICS), or use a software key to activate the Internal-RAD (CICS) on the systems that you want to manage. The RAD Installation Guide provides details about the RAD module and how to physically connect it to the Norstar system and to the remote computer. The CICS Programming and Installation Guide explains how to configure an I-RAD.
Chapter 1 Understanding remote management 17 Connecting remotely to a Norstar system With this configuration, your computer connects to the RAD by using a dial-up modem and a dial-up connection to an auto-answered line on the Norstar system. When you click on the Connect button on an ICSRT Connection Properties screen that is correctly set for Remote connection (“Connecting to a Norstar system” on page 51), your computer dials the Norstar system using the modem.
Chapter 1 Understanding remote management Connecting to a Norstar system attendant If you want an operator or auto-attendant to direct ICSRT calls to the RAD, you can use the same hardware configuration as you use for the remote connection. However, with this connection, the modem is connected to a supervised line that directly dials the attendant or auto attendant, so you also need to attach an analog telephone to the modem.
Chapter 1 Understanding remote management 19 Connecting directly to the Norstar system If you are using a computer that is at the same site as the Norstar system, you can connect to the RAD serial port using a serial cable (RS-232) connected to one of the serial ports on your computer. Ensure that you note which serial port you use.
Chapter 1 Understanding remote management Figure 5 Pinouts for direct connect, Global RAD to computer Global RAD/ FastRAD 9-pin, D-type male connector Global RAD/ FastRAD 25-pin, D-type male connector 1 2 3 4 5 6 8 1 2 3 4 5 6 8 OCO RX TX DTR GND DSR CTS OCO RX TX DTR GND DSR CTS 8 3 2 20 7 6 5 1 2 3 4 5 6 8 Computer port 25-pin, D-type female connector Computer port 9-pin, D-type female connector Remote system management using ICSRT ICSRT provides you with the configuration ability of the on-s
Chapter 1 Understanding remote management 21 Figure 6 provides a sample of what the folder containing one database could contain. Many customer records can be stored in one database. You can also have a number of databases, each with a set of Norstar customers. You cannot, however, pass customer records back and forth between databases, and you cannot have more than one database per folder. Figure 6 ICSRT database folder contents CustomerInfo.
Chapter 1 Understanding remote management Gathering information before you start Gather the following information before you attempt to add customer sites to the ICSRT database: Customer information System Identification (ID) You need to know the unique system number for the Norstar system you want to add. If your customer does not know this number, get them to check in programming.
Chapter 1 Understanding remote management Notes 23 This is a scratch area. Type any information you want to add about the Norstar system. ICSRT components Database Determine which database the customer information will use. Create a new database folder, if required. Refer to “Creating a database” on page 36. Programming Determine which tool you plan to use for programming. Refer to “Understanding the Remote Set tool” on page 55 and “Understanding the Browser tool” on page 63.
Chapter 1 Understanding remote management P0604573 05
Chapter 2 Setting up ICS Remote Tools This chapter describes how you set up your computer to perform remote management with the ICS Remote Tools (ICSRT) application. This chapter provides information about: • “Setting up your computer for ICSRT” on page 25 • “Installing the ICSRT” on page 29 Setting up your computer for ICSRT Before you can begin using ICSRT, the software must first be installed and set up on the computer you are going to use for system management.
Chapter 2 Setting up ICS Remote Tools • ODBC Drivers. If your computer does not have ODBC installed or the driver versions are older than the ICSRT driver files, the files are automatically installed on to your computer when ICSRT installs.
Chapter 2 Setting up ICS Remote Tools 27 Note: In general, you should not delete or alter any of the commands in the default string. However, the modem wait for carrier delay (S7) must be set to include both the delay before the RAD auto-answers and the time for the call to be dialed and connected. Some modems have a maximum wait of 60 seconds. If this is the case, you may set S7 in the modem init string to a lower value.
Chapter 2 Setting up ICS Remote Tools Shutting down your computer Do not turn off your computer unless absolutely necessary. Scheduled jobs will not run if Scheduler is not running. If you need to shut down your computer, ensure that no scheduled jobs are currently running or are scheduled to run during the shutdown period. When you restart your computer, ensure that Scheduler is running. Refer to “Starting the Scheduler” on page 109.
Chapter 2 Setting up ICS Remote Tools 29 Installing the ICSRT ICSRT installs easily off of the ICSRT CD. The application uses an Install Shield Wizard to move the files to your computer and install them in the C:\Program Files\Nortel Networks folder, or in a folder that you specify during the install process. Note: This application allows you to choose whether you want to uninstall previous versions of the Norstar Remote Tools application. 1 Put the CD with the ICSRT software into your CD drive.
Chapter 2 Setting up ICS Remote Tools 6 Click Yes to move forward. 7 You receive the following prompt: Note: If you do not uninstall previous versions of Norstar ICS Remote Tools, the new version will not install. If you want to uninstall Norstar Manager, use the Add/Remove software option under the Windows Start button on your computer. Do not uninstall Norstar Manager if you are managing any systems running software prior to version 2.0. 8 Click Yes on the dialog box.
Chapter 2 Setting up ICS Remote Tools 31 The next screen (Figure 9) prompts you to choose a destination folder. Unless you use the Browse button to navigate to a new location, the application installs in C:\Program Files\Nortel Networks\ICSRT on your computer. Figure 9 Choose Destination Location screen 10 Click Next. The next screen (Figure 10) prompts you to choose a folder or to accept the default folder, Nortel Networks.
Chapter 2 Setting up ICS Remote Tools 11 Click Next. The next screen (Figure 11) prompts you to choose which Install components you want to install. ICS Programming Tools is the only one checked by default. Figure 11 Select Install Components screen 12 Click Next. The next screen (Figure 12) shows you information about the application and where the files will be placed on your computer. Use the Back button to move back through the wizard if you need to change anything.
Chapter 2 Setting up ICS Remote Tools 33 13 If the settings are okay, click Next. The wizard progresses through the install. When the install is successful, a Setup Complete dialog box appears, on top of the Start Menu folder where the program files are located (Figure 13). Figure 13 Successful installation dialog 14 Click OK to exit the dialog box.
Chapter 2 Setting up ICS Remote Tools P0604573 05
Chapter 3 Setting up customers in ICSRT This chapter provides information about the ICS Remote Tools (ICSRT) Customer Information screen and the CustomerInfo database (.mbd). The CustomerInfo.mdb file resides within a folder on your computer or on a central server. All files associated with the customer records in this database are also stored in this folder. You can create more than one database, each of which contains one CustomerInfo.mdb file. Each database file can contain several customer records.
Chapter 3 Setting up customers in ICSRT If you do not create a new database and then point the Customer Info screen to that database, any Customer records you create will be added to the default database. Creating a database This procedure creates an empty database at a location of your choice on your computer. 1 Open ICSRT. (Start, Nortel Networks, Norstar ICS Remote Tools XX.X, Norstar ICS Customer Info) The Customer Info screen displays.
Chapter 3 Setting up customers in ICSRT 2 On the menu, click on Database and select Create. A Create CustomerInfo Database dialog displays. 3 Click on the button beside the Database Path field. (...) A Browse for Folder dialog appears. 4 Navigate to where you want to put the database. 37 Warning: Do not connect to \ICSRT\Template\CustomerInfo.mdb for any reason. If this file is accessed, it may become corrupted. In that situation, you need to re-install the ICSRT application.
Chapter 3 Setting up customers in ICSRT 7 Press OK. If you entered a new folder name, you will be prompted to confirm that you want the system to create a new folder at the indicated location. Click OK. The program returns to the Create CustomerInfo Database screen. 8 Ensure that the path is correct, then click OK. A popup dialog indicates that the new database was created. 9 Click OK. 10 To open the new database, use the Change Path menu item.
Chapter 3 Setting up customers in ICSRT 39 Copying a database If you want to copy your customer database to another location, follow the steps given below. You might use this to create a backup database or to create a local database copy of customer information sitting in a database on a central server. Warning: If a database is deleted, all the customer records and all the information attached to those customer records is permanently removed.
Chapter 3 Setting up customers in ICSRT When you click OK on the Browse for Folder dialog, the path fills into the Copy CustomerInfo Database dialogue. 4 If the location you chose does not have a folder where you want to put the database, at the end of the entry in the Database Path field, type in \. 5 Click OK. If you entered a new folder name, you will be prompted to confirm that you want the system to create a new folder at the indicated location. 6 Click OK.
Chapter 3 Setting up customers in ICSRT 41 When you click on OK, the ICSRT Customer Info screen opens within the default database, as shown in Figure 16. Figure 16 Customer Info opens in default database Default database path Removing any other database does not have any impact on working of ICS Remote tools application. Warning: Do not delete the default database file Nortel Networks/ICSRT/db/ CustomerInfo.mdb.
Chapter 3 Setting up customers in ICSRT Creating a customer record All information in ICSRT is associated with a customer record stored in a database file. For each Norstar system you want to monitor, you need to create a unique record through the Customer Info screen. 1 Open the ICSRT application. The Customer Info screen displays.
Chapter 3 Setting up customers in ICSRT 43 Figure 18 Add Customer Information screen 4 Fill out the fields, as required. A description of the fields is provided in the following table. Table 1 Customer and connection information Customer information System Identification (ID) This is a unique eight-digit number that identifies a Norstar system. On a programming set, go to Software keys, then press SHOW. Customer Name This is the name of the company or business that owns the Norstar system.
Chapter 3 Setting up customers in ICSRT Table 1 Customer and connection information Connection Properties RAD phone number This is the number, which will be answered by RAD at the Norstar location if you are calling into the RAD over a phone line. RAD password This is the number ICSRT uses to identify itself as a valid user to the RAD.
Chapter 3 Setting up customers in ICSRT 5 Click on OK to save the record. 6 The record name appears in the Customer Info screen. In the database folder, the customer record is added to CustomerInfo.mdb. 45 Figure 19 Customer information on Customer Info screen New customer record Editing customer records If you need to make changes to a customer record, use the Edit setting. You will be allowed to change any field except the System ID field.
Chapter 3 Setting up customers in ICSRT Figure 20 Editing customer information P0604573 05
Chapter 3 Setting up customers in ICSRT 47 Copying customer records to create new records You can copy a customer record to save yourself from entering repeated data. Only the information that is unique to a system, such as the System ID is not copied. 1 On the Customer Info screen, select the record you want to copy. 2 On the menu click on Customer Details, then select Copy. The Copy Customer Information screen appears (Figure 21). 3 Enter the unique data for the new customer record.
Chapter 3 Setting up customers in ICSRT Viewing customer records If you just need to check customer record settings, without making any changes, you can use the View setting. To view customer records: 1 On the Customer Info screen, select the record you want to view. 2 On the menu click on Customer Details, then select View, or double click on the entry in the Customer Info screen. The View Customer Information screen displays (Figure 22).
Chapter 3 Setting up customers in ICSRT 49 Deleting customer records You may occasionally need to delete records from a database.When you do this, all access to customer information is deleted, so ensure that this is really what you want. To delete customer records: 1 On the Customer Info screen, select the record you want to delete. 2 On the menu click on Customer Details, then select Delete. 3 When the confirmation dialog appears, click on OK to delete the record.
Chapter 3 Setting up customers in ICSRT P0604573 05
Chapter 4 Connecting to a Norstar system from ICSRT This chapter describes how to use the ICS Remote Tool (ICSRT) Connection Properties dialog to open a connection to a target Norstar system. Before you attempt to open a connection, ensure that all the hardware connections are complete. The RAD Installation Guide describes how to install a RAD on a Norstar System. Refer to “Explaining RAD connections” on page 16 for an overview of the different types of connections and how to use them.
Chapter 4 Connecting to a Norstar system from ICSRT Figure 23 Connection Properties default dialog Table 2 Connection Properties fields Field name Values Description Note: All fields are required for remote and operator-assisted connections. A direct connection only requires the fields marked with as asterisk (*) RAD phone number <7-digit phone number> This is the number, which will be answered by RAD at the Norstar location if you are calling into the RAD over a phone line.
Chapter 4 Connecting to a Norstar system from ICSRT 53 Table 2 Connection Properties fields Field name Values Description Note: All fields are required for remote and operator-assisted connections. A direct connection only requires the fields marked with as asterisk (*) Dial mode Tone Pulse The dial mode used by ICSRT. The default is tone. Modem init string Some modems require special codes to be sent to them before they are ready to communicate.
Chapter 4 Connecting to a Norstar system from ICSRT Connecting through a customer record You specify connection parameters when you set up the customer record (“Creating a customer record” on page 42). Consequently, when you open a tool when a customer record is selected on the Customer Info screen, the connection parameters will mirror what was entered in the Customer record.
Chapter 5 Understanding the Remote Set tool This chapter describes the Remote Set tool, which is located under the ICS Remote Tools (ICSRT) Run Tool heading. This tool allows you to use a computer-based depiction of a Norstar M7310 or M7324 telephone to program system data.
Chapter 5 Understanding the Remote Set tool Explaining the Remote Set tool Using the Remote Set tool allows you to read and modify the system data of the Norstar system to which you are connected. When your computer has an online connection with the Norstar system, any programming changes you make are either immediate, or take effect when you end the programming session. The Remote Set tool can be used to program any Norstar system running version 2.0 or newer software.
Chapter 5 Understanding the Remote Set tool 57 Accessing the Remote Set tool To access the Remote Set tool: 1 Open ICSRT. 2 If you are not in the correct database, find the database where the correct customer is located. Refer to “Moving between databases” on page 38 for details. 3 Select the customer you want to connect to. 4 Click on Run Tool, and select Remote Set. The connect screen appears, with the connect information for that system. 5 Click on Connect.
Chapter 5 Understanding the Remote Set tool Figure 27 M7324 Remote set screen display 6 Use this interface in the same way that you would use a programming telephone on-site. The buttons on the screen correspond with the type of telephone listed in the title bar. Note: Instead of a programming template, the screens show the Heading, Back, Show and Next labels above the button to which they refer. Once you enter programming, the indicators for the four headings appear, as shown in the figure above.
Chapter 5 Understanding the Remote Set tool 59 Remote Set tool command buttons You can perform the following functions with the three buttons found at the top of the Remote Set tools screen. Table 3 Remote Set tool command buttons Button label Description of function M7310 or M7324 To change the screen from one telephone simulation to another, click the M7310/M7324 button that appears at the top, left of the Remote Set screen. The button displays the telephone model that is not currently displayed.
Chapter 5 Understanding the Remote Set tool • When doing tasks such as name administration, advance or back up the cursor by pressing a softkey after pressing each letter. (Softkeys are located directly below the display screen in the telephone simulation window. They are also called display buttons.) After you press a letter, you will see an arrow symbol on the telephone display. This is your prompt to press the softkey located beneath the arrow.
Chapter 5 Understanding the Remote Set tool 61 Remote Set tool restrictions When a connection is made to the ICS, the Remote Set tool window simulates a telephone attached to the system (but does not have all the telephone capabilities of an actual telephone). With this in mind, it is important to note the following: • Do not disable the port/extension or the B2 channel for either the RAD or the RAD line. The only method of recovery is to enable the port/extension B2 channel locally with a telephone.
Chapter 5 Understanding the Remote Set tool P0604573 05
Chapter 6 Understanding the Browser tool This chapter describes the Browser tool, which provides a Windows-type of screen and navigation system for system programming. The Browser tool is located under the ICS Remote Tools (ICSRT) Run Tool heading.
Chapter 6 Understanding the Browser tool Understanding the Browser tool Like the Remote Set tool, the Browser tool allows you to see programming and make changes to the Norstar system programming using an online connection. Instead of simulating the telephone display, the Browser tool shows multiple levels in a programming tree, which appears in a Windows type of frame on your computer.
Chapter 6 Understanding the Browser tool 65 Accessing the Browser tool To access the Browser tool to add or change programming for a Norstar system: 1 Open ICSRT. 2 If you are not in the correct database, find the database where the correct customer is located. Refer to “Moving between databases” on page 38 for details. 3 Select the listing for the customer to which you want to connect. 4 Click on Run Tool, and select Browser.
Chapter 6 Understanding the Browser tool b On the top menu of this screen, click on Tool, and select Terminate Connection. Understanding the Browser window The window for the Browser tool is split into two side-by-side frames (panes). The navigation tree is in the left pane. As well, some of the headings on the navigation tree have additional settings that appear in the right pane when the heading is selected. Refer to Figure 31.
Chapter 6 Understanding the Browser tool 67 Note that the information box on the bottom, right corner of the screen indicates which programming Map is being used by the Browser. Note: Press CTRL+TAB to move clockwise through the window (left pane, toolbar, right pane), and CTRL+SHIFT+TAB to move counter-clockwise.
Chapter 6 Understanding the Browser tool The following table describes the navigation tree icons. Table 4 Navigation tree icons Icon What it does Alternate access + Click to expand a heading to reveal subheadings. - Collapse menu under heading. Select heading and press right-pointing arrow on the keyboard Note: If the Norstar system you are working with does not have anything currently programmed under this heading, the icon disappears when you click the heading.
Chapter 6 Understanding the Browser tool 69 The dialog boxes for operations work differently depending on whether the operation is usually performed once or repeated several times. • • If the dialog box has OK and Cancel buttons, it performs an operation once. If the dialog has Close and a command button, such as Copy, the operation can be repeated. Click Close to exit the dialog box. Refer to Figure 34.
Chapter 6 Understanding the Browser tool To change the time and date, do one of the following: • Select the number for the year, month, day, hour, minute, or seconds, then type a new value, then press Apply. or • Select the number for the year, month, day, hour, minute, or seconds and adjust the value up or down using the pair of arrows to the right of the box, then press Apply. or • Click Load local time and date. The system enters the time and date from the computer clock into the boxes.
Chapter 6 Understanding the Browser tool 71 If the value box is blank, it means no value has been given for the item. For instance, if you had only selected Restriction service in the case shown in Figure 36, the label box would read Schedule, but the value box would be blank. Using the task bar buttons The top bar also allows you to add, remove, or remove the entire list of items under headings that have a variable list of similar items.
Chapter 6 Understanding the Browser tool Examining the Browser navigation tree menu The Browser navigation tree is based on the layout of set programming. However, not all fields can be programmed, and these do not appear on the navigation tree. Also, some fields may be in a slightly different location than found in set programming.
Chapter 6 Understanding the Browser tool 73 Expanded navigation tree The following table provides an overview of the navigation tree menu in the Browser tool. Which headings appear on the Browser navigation tree depend on the map being used by ICSRT, which is determined by system software version and vintage of the Norstar system. The headings in bold/blue indicate settings that are found in a different location in the Browser from where they are in set programming.
Chapter 6 Understanding the Browser tool Time & date yyyy/mm/dd/hh/mm/ss System programming Business Name SM sets Hunt groups Mode Hunt delay If busy Time out Overflow Name Aux ringer Distinct ring Hunt group 01-XX Members Member 001-XXX DN Appearance type Line assignment Line XXX Feature settings Background music On hold Receiver volume Camp timeout Park timeout Park mode Transfer callback timeout DRT to prime DRT delay Held line reminder Directed pickup Page tone Page timeout Daylight savings time A
Chapter 6 Understanding the Browser tool 75 Troubleshooting the Browser window The following section discusses areas where the Browser may respond unexpectedly. Refreshing an invalid navigation tree In some cases, the programming changes you make are so significant that the Browser window fails to respond. If you try to make changes, an error message appears and you are forced to end your session with the Browser. To refresh the tool, exit the screen and restart the Browser from the Run Tool menu.
Chapter 6 Understanding the Browser tool Feature messages Messages also appear when the value you are attempting to enter is not valid because of its format, or does not work with the feature you are programming. For example, you might see: is not a valid option for ‘Name’. This means that you entered characters that are not valid for a set name. The line is private to a set and cannot be used here. This means that you tried to assign a line that is private to one set to another set.
Chapter 6 Understanding the Browser tool 77 Message: - cannot be accessed at this time. Try later. Explanation: You cannot view or change the programming item because the ICS is busy. Suggested response: Continue with other programming tasks and return to the item later. Fatal error messages If you click OK or EXIT in a fatal error message window, the Browser tool window is closed. To restart the tool, click on the Browser icon or select the Browser tool from the Run Tool menu.
Chapter 6 Understanding the Browser tool Suggested response: Obtain Software Keys from Nortel and enter them under the Software Keys heading using set programming at the Compact ICS site. If remote access programming has been set up on the Nortel system, you can enter the keys remotely, but you cannot see any other part of programming until the keys are entered successfully. See the CICS Installer Guide for more information. Message: You are connected to system .
Chapter 6 Understanding the Browser tool 79 Message: Cannot browse because a programming session is already in progress on the system of the customer. Try later. Explanation: You have started the Browser tool when someone is already in a programming session at the Norstar system, or the Norstar system has not yet recognized that a remote user has ended the programming session by closing the Browser tool.
Chapter 6 Understanding the Browser tool Message: Programming session timed out. Explanation: There has been no activity in the Browser tool for 30 minutes. The tool is automatically closed, and this message appears. The connection to the Norstar system is dropped after three additional minutes of inactivity. Suggested response: Click OK. If you wish to continue working with the Browser tool, you must start the application again.
Chapter 6 Understanding the Browser tool 81 Message: This is an old version of the browser that does not know how to browse the system of the customer. Please contact your system administrator. OR Map file:
Chapter 6 Understanding the Browser tool P0604573 05
Chapter 7 Using Workbooks and off-line programming This chapter describes the OLP Workbook tool which allows you to enter system programming data offline into Excel worksheets called Workbooks. You then can upload that data to the Norstar system. Workbooks also allow you to acquire all or part of the data from a Norstar system, and then reload just the corrected information back to the system.
Chapter 7 Using Workbooks and off-line programming Understanding workbooks and off-line programming Use the ICSRT off-line programming tool as another way to enter programming into a Norstar system. This tool also allows you to acquire programming from a Norstar system. This Off-line Programming tool uses a Microsoft Excel workbook file which contains a number of worksheets that contain the system data, some macros, and a map file specific to the type of system you are programming.
Chapter 7 Using Workbooks and off-line programming 85 Configuring a workbook The ICSRT supplies default workbooks that reflect the different types of Norstar software, from version 2.0 forward. Within these workbooks, there are further system definitions and settings that need to be set before you use the workbook to program a system.
Chapter 7 Using Workbooks and off-line programming Configuring the Workbook parameters When you first create a workbook file you need to determine what type of system you will be programming so the workbook can display the correct information. 1 Open the workbook you want to program. • • If you already assigned a workbook to a customer, refer to “Accessing an assigned workbook” on page 85.
Chapter 7 Using Workbooks and off-line programming 87 Figure 41 Workbook Configuration screen 3 In the Workbook box, select the appropriate system descriptor. 4 In the Language box, select the language for the worksheet. 5 Click OK. The workbook changes to the parameters defined by the system. If a language change is required, it could take up to 10 minutes to reconfigure the workbook. 6 Under the ICS menu, select Configure System Size. A confirmation dialog box appears.
Chapter 7 Using Workbooks and off-line programming 7 Click Yes. The Select System Size dialog box appears. Figure 42 Select System Size dialog 8 Select the correct size of the system you will be programming, then click on OK. If you do not know the size of the system you are programming, click Cancel, and find out this information before you proceed. 9 Under the ICS menu, select Configure Hardware The Hardware screen appears (Figure 43).
Chapter 7 Using Workbooks and off-line programming 89 Figure 43 Hardware screen 11 Enter the parameters supplied by your customer into the Excel worksheets or go to step 14, if you want to configure the data later. 12 Save the workbook. • If you are working with a workbook already assigned to the customer, the workbook is saved in the same folder where the CustomerInfo.mdb is located, in a folder called OlpWorkbooks\. Customer.mdb OlpWorksheets X *.
Chapter 7 Using Workbooks and off-line programming Warning: If the following prompt appears when you are trying to save a workbook, press Cancel. If you press Yes, the original workbook may become corrupted. In this case, save the workbook with a different name. • If you have not yet assigned the workbook, it resides in :\Programming Files\Nortel Networks\Icsrt\Workbook. a Open the ICSRT application.
Chapter 7 Using Workbooks and off-line programming 91 Using the workbook for programming 1 Open ICSRT. This step is optional, but it provides access to the customer record if you need to refer to customer information or connection settings. 2 Open the workbook that you prepared following the appropriate instructions under “Configuring a workbook” on page 85. 3 Enter the required data into the various worksheets.
Chapter 7 Using Workbooks and off-line programming 5 Choose the Program ICS options that suit the way you want to program the system. Refer to the table below for detailed descriptions. Table 5 Program ICS dialog box options Option Description Partial Programming Choose this option if you only want to program only parts of the new system. For instance, the installer may have configured the module settings when the system was installed, and therefore you do not want to overwrite these settings.
Chapter 7 Using Workbooks and off-line programming 6 93 If you chose Partial Programming, from the Regions box and associated settings, select any specific regions of programming information to overwrite by holding down the control key and clicking on the headings you want to program. If you want to select all of any category, such as all B1s (Set DNs), click on the button above the column. Notice that the Select All label above the button changes to Deselect all.
Chapter 7 Using Workbooks and off-line programming Click Stop to stop programming. Note: Stopping the activity does not cancel the programming changes which are made before you stopped the activity. Any programming which is transferred to the ICS before you click Stop becomes part of the ICS programming. If you stop an acquire, you can discard the information and return the workbook file to its original state by closing the file without saving changes, then re-opening the file.
Chapter 7 Using Workbooks and off-line programming 4 95 Click on OK on the dialog box. A default Windows Open dialog appears, showing all the Excel workbook files that are associated with the Norstar System record you selected (Figure 47). 5 Select the workbook you want to copy, then click Open. 6 Use Save As to save a new workbook file. 7 Edit the information that you want to add or change on the system on the Excel worksheets and save the file.
Chapter 7 Using Workbooks and off-line programming Acquiring information from a programmed system You can populate a workbook file with the current programming data from a Norstar system. You must select the appropriate ICS type for the workbook before you acquire data, as explained in “Configuring a workbook” on page 85. 1 Open ICSRT. 2 Select the customer record you want to work with. 3 From the Run Tool menu, click Select Workbook.
Chapter 7 Using Workbooks and off-line programming 97 Figure 49 Acquire ICS screen 8 Choose the Acquire ICS options that suit the way you want to program the system. Refer to the table below for detailed descriptions. Table 6 Acquisition variables Option Description Partial Acquisition Choose this option if you only want to acquire only specific parts of the system.
Chapter 7 Using Workbooks and off-line programming Warning: Do not use the cut or paste functions in any applications on your PC when you are acquiring programming from a Norstar system. Warning: Acquiring programming information from a Norstar system overwrites some or all of the information in the workbook. To avoid losing data, acquire information into a new, clean copy of the workbook file.
Chapter 7 Using Workbooks and off-line programming 99 11 Ensure that the connection properties are correct for the system you want to connect to, then click on Connect. The Current Activity field on the Program ICS screen displays information about the current status of the connection. Once the connection is established, this field shows activity as the workbook is updated from the Norstar system.
Chapter 7 Using Workbooks and off-line programming Using the OLP Error dialog If you notice there are errors during the programming or acquisition process, you can view these errors on the OLP Errors dialog box. You can also correct the error from this dialog box. 1 If the workbook is not already open, open the workbook where the errors occurred. 2 Under the ICS menu, select Edit Errors. The OLP Errors dialog box appears. Table 7 describes the fields found on this dialog box.
Chapter 7 Using Workbooks and off-line programming 101 Table 7 OLP Error dialog fields Field Description Sheet This field displays the name of the worksheet where the selected error occurred. Value This is the current value entered in the indicated cell. Errors This is a description of the actual error. To view details, double click on the error line or select the error line and click the Goto button.
Chapter 7 Using Workbooks and off-line programming Changing the property settings for the workbook There are a number of settings that you can adjust to determine the operation of the off-line programming tool. These are found on the OLP Settings dialog. To open the dialog box, click on ICS, then select Settings.
Chapter 7 Using Workbooks and off-line programming 103 The following table describes each of the settings on the OLP Settings dialog box: Table 8 OLP Settings dialog box fields Field Description Default Path This setting defines the path to a directory where intermediate transfer files are placed during programming and acquisition. The default is c:\windows\temp. It is also the directory where the debug log file is placed. Default This button changes the settings on the dialog to default values.
Chapter 7 Using Workbooks and off-line programming Table 8 OLP Settings dialog box fields (Continued) Field Description Display OLP errors dialog Once errors are detected, you can correct them using the Errors dialog box. If the Display OLP errors dialog option is selected, the dialog box is displayed automatically after completing an operation (program or acquire). Understanding the About ICS Workbook dialog The About ICS Workbook heading under ICS opens the About ICS Workbook dialog box.
Chapter 7 Using Workbooks and off-line programming 105 Table 9 OLP Settings dialog box fields (Continued) Field Description ICS Description A description of the Norstar system that uses this workbook. ICS Map Filename The map name that the workbook uses. Workbook Language The language to which the workbook is set. Troubleshooting worksheet data transfer The following are errors that you might encounter when workbook information transfers to the Norstar system.
Chapter 7 Using Workbooks and off-line programming P0604573 05
Chapter 8 Backing up and restoring Norstar data It is important that you backup the system data for the Norstar systems you are managing on a regular basis to prevent long delays for reprogramming in the event of a system failure. The ICS Remote Tool (ICSRT) allows you to schedule a backup for times of low system activity at four frequency levels. You can also schedule a restore to occur on a specific time and date.
Chapter 8 Backing up and restoring Norstar data Either of these files could be used to restore the programming to a Norstar system through a scheduled or manual restore in the event of complete programming loss. Tips: If the computer you are using is in the same building as the Norstar system, we strongly recommend that you copy backup files to CD and store it offsite. When you perform a backup, the Norstar system being backed up may slow down, but it remains operational.
Chapter 8 Backing up and restoring Norstar data 109 Starting the Scheduler Scheduler is automatically started when you start up the computer running ICSRT. However, if you close the icon at any time, you can start scheduler manually from Windows by selecting Start\Programs\Nortel networks\Norstar ICS Remote Tools 10.0, then click on Norstar ICS Scheduler. Scheduler runs in background, which is indicated by a Scheduler icon in the system icon tray.
Chapter 8 Backing up and restoring Norstar data Figure 55 Add/Submit Job screen 4 Change the fields, as required to set up the job schedule. Refer to Table 10 for values and descriptions for each field. Table 10 Add/Submit job fields Field name Values Description Date The date on which you want the backup or restore to occur. Format: YYYY : MM : DD The default date is the current date on the computer form which you are running ICSRT.
Chapter 8 Backing up and restoring Norstar data 111 Table 10 Add/Submit job fields (Continued) Job type Backup - System Programming Backup - AA Greetings Backup - All Restore - System Programming Restore - AA Greetings Restore - All Determine what type of action you want the system to perform. The Backup AA Greetings/Restore AA Greetings selections are valid only for CICS systems.
Chapter 8 Backing up and restoring Norstar data Exiting Scheduler You can close Scheduler by right clicking on Scheduler system tray icon and selecting the Exit option. Note: It is recommended not to close the scheduler application as jobs scheduled for that particular duration will not be scheduled for execution. Troubleshooting with Scheduler If Scheduler crashes or if you face any problem while performing scheduled backup/restore operations you need to find the job and scheduler log files.
Chapter 8 Backing up and restoring Norstar data 113 Understanding the job queue The Jobs in Queue screen lists all Norstar systems scheduled for a backup or restore. Each backup or restore in the list is called a job. To access the Jobs in Queue screen, either click on Scheduler, then select Job Queue or double click on the Scheduler icon on the task bar. Click on Done to exit the screen.
Chapter 8 Backing up and restoring Norstar data • Re-Scheduled: A suspended job, which has a Repeat attribute set, will be scheduled for next time, and the current job status changes to indicate this rescheduling. Completed jobs are not deleted from the Jobs in Queue. The jobs are left on the screen so you can view the status of the completed jobs. The maximum number of jobs that can be on the JobQueue database is 4096.
Chapter 8 Backing up and restoring Norstar data 115 Viewing a submitted job When you double click on any job in Jobs in Queue dialog, the View Job Info screen appears. All the fields in View Job Info dialog will be filled with values read from JobQueue database. All the dialog elements in View Job Info dialog are grayed out and cannot be changed.
Chapter 8 Backing up and restoring Norstar data Backing up data with the Backup Restore tool If you want to do an immediate restore or backup of the system programming, you can use the Backup Restore tool found under the Run Tool heading. Caution: We recommend that you create a separate folder under your CustomerInfo database/backup folder for manual backups. Refer to Figure 58.
Chapter 8 Backing up and restoring Norstar data 117 Caution: If you do not change the database path, the backup file is saved in the default backup file in the ICSRT folder. Saving the file in this folder can be a security risk, as any other manual backup file saved to the default folder will replace this file. If you choose to save the file in the default backup folder, it is strongly recommended that you move the file to another location once the backup is complete.
Chapter 8 Backing up and restoring Norstar data Restoring data with the Backup Restore tool If you want to do an immediate restore of a backed up file, you can use the Backup Restore tool found under the Run Tool heading. 1 Decide which backup file you are going to restore: • If you are restoring a backup file that was created by a scheduled backup, rename the file as FNVRAM.new. Refer to Figure 60. Figure 60 Renaming a scheduled backup file CustomerInfo.
Chapter 8 Backing up and restoring Norstar data 119 Figure 61 Backup and Restore screen, Restore tab :\\ 12 Click on Restore Now. The restore begins immediately. The Progress field indicates how the restore is progressing. If you encounter errors or need to stop the restore process, slick on Stop. 13 When the restore is complete, click on Done. If you need to restart the restore while it is running, click on the Reset button.
Chapter 8 Backing up and restoring Norstar data P0604573 05
Chapter 9 Troubleshooting the ICS Remote Tool This chapter describes the following troubleshooting tools: • • • “Setting up a RAD alarm center” on page 121 “Error messages” on page 123 “The Debug tool” on page 125 Setting up a RAD alarm center The RAD can be programmed to report alarms to a dedicated alarm device. An alarm device can be a printer, a terminal or a computer that is set up to log incoming reports.
Chapter 9 Troubleshooting the ICS Remote Tool RAD alarm codes When a RAD receives an alarm from the KSU, it dials the telephone number of the modem attached to the dedicated alarm device and transmits an alarm string. This string identifies the System ID number and the alarm code. In some cases RAD alarm codes do not match ICS alarm codes. The following table shows the ICS alarm code equivalents to RAD alarm codes.
Chapter 9 Troubleshooting the ICS Remote Tool 123 Error messages This section contains the most common and/or most critical error messages that you might come across as you are using the ICS Remote Tools (ICSRT) application: Table 12 ICSRT error messages SL NO ERROR MESSAGE BRIEF EXPLANATION 1. Copy operation failed Copy operation failed 2. Failed to connect to Database The ICSRT is unable to connect to the specified database.
Chapter 9 Troubleshooting the ICS Remote Tool Table 12 ICSRT error messages (Continued) SL NO ERROR MESSAGE BRIEF EXPLANATION 13. The folder -------cannot be created. Please double check Create directory failed during database creation/copying. 14. Failed to connect to default database The application fails to connect to the default CustomerInfo database. This can occur if the default database directory is removed. This may require reinstallation of ICSRT. 15.
Chapter 9 Troubleshooting the ICS Remote Tool 125 The Debug tool The Debug tool, which is located under the ICSRT Run Tools menu, allows the technical support personnel to dial into a Norstar system over the ICSRT RAD connection and initiate a memory dump to assist in diagnosing system issues. Use this tool only under the direction of technical support personnel. Access to this tool requires a password that will be provided by technical support personnel if they need you to run the tool for them.
Chapter 9 Troubleshooting the ICS Remote Tool P0604573 05
Appendix A Connecting a modem This appendix provides information required for a remote connection from Norstar ICS Remote Tools (ICSRT) to the RAD at 9600 baud. Note: This does not apply to the FastRAD.
Appendix A Connecting a modem 6 These setting must then be saved in the Modem NVRAM (Non Volatile Memory) so the settings will become the modem power up defaults. Note: If the settings are not saved and the modem is powered off and on, they will disappear, and the modem will not communicate with a RAD until it is reprogrammed. Preparing the remote modem To prepare the remote modem, connect it to the computer. The Windows installation process puts Terminal in the Accessories folder by default.
Appendix A Connecting a modem 129 Installing remote equipment To install remote equipment for a direct connection: 1 Connect the RAD to the Norstar ICS port with a standard TCM cable. 2 Connect the pre-configured modem to the RS-232 port on the RAD using the null modem cable. 3 Connect the modem to the direct line using the standard RJ11 telephone cable.
Appendix A Connecting a modem P0604573 05
Glossary The following terms occur within the ICS Remote Tools (ICSRT) documents. Alarm Backup Block Cancel Command Configuration Connection Indicates an error condition in the Norstar system. The process of making a copy of a Norstar ICS programming. For manual connection, this copy is then stored in the \backup folder. For scheduled backups, this copy is stored in \backup folder. A section of text or data.
Glossary Job A scheduled operation, such as a Backup or Restore of a Norstar system. Job Queue A screen that displays a list of scheduled jobs waiting to be completed. Access this screen to determine the status of the scheduled jobs. M7310 telephone The Norstar model M7310 telephone that has a two-line display and can be used to program Norstar system features. This telephone is one of the telephone emulated in the Remote Set Tool.
Index A setting time and date 69 stop programming 94 task bar 70 troubleshooting 75 understanding the tool 64 viewing recent changes 71 window descriptions 66 About ICS Workbook 104 acquire data, workbook 96 errors 99 stop 99 acronyms 13 Active Workbook 104 C Add 70 Cancel 53 Add to ICS Program 92 Cell, OLP errors 101 Add/Submit Job, process 109 Change password 59 address 22, 43 Change Path 38 alarm center, RAD 121 CICS, backup/restore job types 111 Allowable errors before stopping, OLP 1
Index through customer record 54 Connection Properties 111 contact 22, 43 copy customer record 47 database 39 delete customer record 49 database 40 Deselect All 93, 98 dial mode 44, 53 dial mode, modem string 22 Current Activity 93, 99 Display OLP errors dialog 104 Current Path 40 Done 117, 119 customer connection properties 54 copy record 47 creating record 42 Customer Details 42, 47 delete record 49 edit records 45 Info and database 35 quit program 49 view record 48 workbook location 89 Custom
Index Global RAD 13 information, before you start 22 glossary 131 install date 22, 43 default folder 31 H hardware computer 25 do not use workbook 84 modem 26, 127 modem equipment 129 requirements 16 workbook system configuration 88 installing ICSRT 25, 29 IRAD 13 Issue Date 104 J Job type 110, 113 Heading 58 JobQueue.
Index MICS, backup/restore job types 111 Minimize Excel while operating, OLP 103 Minimize OLP while operating 103 modem baud rate 44 connecting 127 equipment 129 hardware 127 init string 44 Modem init string 53 preparing 128 requirements 26 sample configuration 128 specifications 127 modem init string, default 26 N navigation tree 66 Browser 65 collapse 68 comparison to set programming 72 example 73 headings 67 icons 67 keyboard 67 refresh 75 using 67 open Browser tool 65 remote set tool 57 workbook
Index Select Workbook 85, 96 workbooks 83 Regions 93 Remote 70 remote connection, preparing the modem 128 remote management, overview 20 remote set tool access 57 change RAD password 59 command buttons 59 configuration tool 55 F-key equivalents 59 keyboard equivalents 59 keyboard mappings 59 keyboard tabbing 60 purpose 56 restrictions 61 Running 113 S Scheduler Add/Submit Job 109 exiting 112 log file 112 repeat periods 111 setting up backup/restore 109 starting 109 time/date change 109 troubleshooting 11
Index text conventions 13 Time 110 time change Scheduler 109 Time Difference 111 time/date, Browser setting 69 troubleshooting browser 75 debug tool 125 ICSRT error messages 123 RAD alarm center 121 Scheduler 112 U uninstall ICSRT 27 uninstall old versions 29 Update 114 Use Defaults 53 Use Preferences 53 V Value, OLP errors 101 view, customer information 48 W Windows compatibility 25 workbook About ICS Workbook dialog 104 acquire data 96 acquire restrictions 98 acquisition errors 99 Add to ICS Prog
