Teradata SMWeb Server Management Software User Guide

displays a Measurement Graph Manager dialog box ( Figure 59 ).

120 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Using Predefined System Queries to Generate Measurement Graphs

The Event Mgmt > View Measurement Graph > Predefined Queries > System Queries command

Figure 59: Measurement Graph Manager (Predefined System Queries)

The dialog box lists predefined queries that retrieve information from the CMIC

Measurement Database and generate graphs for components in the system.

Related Topics

•

To Generate an xy Graph Showing All Temperature Readings for All Nodes and CMICs .

•

To Generate a Bar Graph Showing the Most Recent Temperature Readings for All Nodes and CMICs .

•

To Generate an xy Graph Showing All UPS Power Consumption for All Cabinets

•

To Generate a Stacked Bar Graph Showing the Most Recent UPS Power Consumption for

All Cabinets .

•

To Generate an xy Graph Showing UPS Power Output for All Cabinets

Teradata Server Management Web Services User Guide 121

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate an xy Graph Showing All Temperature Readings for All Nodes and CMICs

With the correct Site ID selected in the Tree View, select Event Mgmt > View Measurement

Graph > Predefined Queries > System Queries.

From the Measurement Graph Manager, select Front Panel Temperature: All Readings.

Click Create Graph.

The query retrieves all front panel and ambient temperature data for all nodes and CMICs in the system. The query generates an xy graph that plots the temperature change, in

Celsius, as measured over time.

Figure 60: xy Graph of All Temperature Readings (Example)

122 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate a Bar Graph Showing the Most Recent Temperature Readings for All Nodes and CMICs

With the correct Site ID selected in the Tree View, select Event Mgmt > View Measurement

Graph > Predefined Queries > System Queries.

From the Measurement Graph Manager, select Front Panel Temperature: Recent.

Click Create Graph.

The query retrieves the most recent front panel or ambient temperature data of each node and CMIC in the system. The query generates a bar graph that shows the temperature reading of each sensor, in Celsius, for each component.

Figure 61: Bar Graph of Most Recent Temperature Readings (Example)

Teradata Server Management Web Services User Guide 123

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate an xy Graph Showing All UPS Power Consumption for All Cabinets

With the correct Site ID selected in the Tree View, select Event Mgmt > View Measurement

Graph > Predefined Queries > System Queries.

From the Measurement Graph Manager, select UPS Input Power: Grouped by Cabinet.

Click Create Graph.

The query retrieves data for all UPSs in the system, grouped by cabinet, and uses the data in the following formula to calculate UPS power consumption:

average input watts = average input current (A RMS) multiplied by average input voltage

(V RMS)

Note: RMS is Root Mean Square, the method used to average the volts.

The resulting xy graph plots the power consumption (UPS Input Watts RMS) for the UPSs in each cabinet, as measured over time.

Figure 62: xy Graph of All UPS Power Consumption Data (Example)

124 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate a Stacked Bar Graph Showing the Most Recent UPS Power Consumption for All Cabinets

With the correct Site ID selected in the Tree View, select Event Mgmt > View Measurement

Graph > Predefined Queries > System Queries.

From the Measurement Graph Manager, select UPS Input Power: Recent.

Click Create Graph.

The query retrieves the most recent data for all UPSs in the system, grouped by cabinet, and uses the data in the following formula to calculate UPS power consumption:

average input watts = average input current (A RMS) multiplied by average input voltage

(V RMS)

Note: RMS is Root Mean Square, the method used to average the volts.

The resulting stacked bar graph plots the power consumption (UPS Input Watts RMS) for the UPSs in each cabinet, as measured over time:

•

Each bar represents one cabinet. The height of the bar represents the sum of the average input watts of all the UPSs in the cabinet.

•

Each band of color in the bar represents one UPS in the cabinet. To find the average input watts of each individual UPS, take the value from the top of the band and subtract the value of the bottom of the band.

For example (

Figure 63

): In cabinet 70, the blue band represents UPS 2. (~625 watts to

1500 watts). So, for this measurement, UPS 2 in cabinet 1 in collective 70 received 875 input watts (1500 - 625 = 875).

Teradata Server Management Web Services User Guide 125

Chapter 7: Managing Component Information

Generating Measurement Graphs

Figure 63: Stacked Bar Graph of Most Recent UPS Power Consumption Data (Example)

126 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate an xy Graph Showing UPS Power Output for All Cabinets

With the correct Site ID selected in the Tree View, select Event Mgmt > View Measurement

Graph > Predefined Queries > System Queries.

From the Measurement Graph Manager, select UPS Output Watts: Grouped by Cabinet.

Click Create Graph.

The query adds the output watts of each UPS in a cabinet and displays an xy graph of the output power of each cabinet, in watts, as measured over time.

Figure 64: xy Graph of All UPS Power Output Data (Example)

Teradata Server Management Web Services User Guide 127

Chapter 7: Managing Component Information

Generating Measurement Graphs

Using Predefined Cabinet-Level Queries to Generate Measurement Graphs

When you select one or more cabinets that contain nodes and CMICs, the Event Mgmt > View

Measurement Graph > Predefined Queries > Cabinet-Level Queries command displays a

Measurement Graph Manager dialog box (

Figure 65

Figure 65: Measurement Graph Manager (Predefined Cabinet-Level Queries)

The dialog box contains a predefined query that retrieves information from the CMIC

Measurement Database and generates a temperature graph for the nodes and CMICs in one or more selected cabinets.

Related Topics

•

To Generate an xy Graph Showing All Temperature Readings for Nodes and CMICs in

Selected Cabinets

•

To Save a System or Cabinet-Level Measurement Graph in HTML Format

128 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

To Generate an xy Graph Showing All Temperature Readings for Nodes and CMICs in

Selected Cabinets

From the Tree View, with the correct Site ID selected, select one or more processing node cabinets.

Select Event Mgmt > View Measurement Graph > Predefined Queries > Cabinet-Level

Queries.

From the Measurement Graph Manager, select Front Panel Temperature: Selected

Cabinet(s).

Click Create Graph.

The query retrieves all front panel and ambient temperature data for all nodes and CMICs in the selected cabinet(s). The query generates an xy graph that plots the temperature change, in Celsius, as measured over time.

Figure 66: xy Graph of All Temperature Readings for Selected Cabinet(s) (Example)

Teradata Server Management Web Services User Guide 129

Chapter 7: Managing Component Information

Generating Measurement Graphs

Using Custom Queries to Generate Graphs

When you select one or more chassis of the same or similar type, Event Mgmt > View

Measurement Graph > Custom Queries displays a Measurement Graph Manager dialog box

(

Figure 67

). The chassis must have at least one sensor in common.

Figure 67: Measurement Graph Manager (Custom Queries)

130

The dialog box contains a set of commands that allow you to create and work with custom queries. The custom queries retrieve information from the CMIC Measurement Database for the selected components, and generate graphs based on the queries. You can also modify and delete the custom queries, and save the custom query and graph.

Related Topics

•

Creating a New Custom Query

•

Editing the SQL Statement Generated from a Custom Query

•

Running an Existing Custom Query

•

Editing an Existing Custom Query

•

•

•

“Editing the SQL Statement

Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Creating a New Custom Query

To Create a New Custom Query

5 b c

From the Tree View, with the correct Site ID selected, select one or more chassis.

Note: If you select chassis that do not have sensors in common, a message displays.

Select Event Mgmt > View Measurement Graph > Custom Queries.

From the Measurement Graph Manager dialog box, click New.

From the Measurement Graph dialog box, choose the sensor, graph, and time criteria options you want to use.

Note: You can select only one unit of measurement from the Sensors list (Amps, for example). However, you can expand the unit of measurement and select one or more individual sensors (node or CMIC Power Supply : PS1 +12V Current, for example).

To edit the resulting SQL query and generate a graph, see

Generated from a Custom Query” on page 135 .

Click Create Graph.

Do one of the following:

To save the custom query or graph, see

page 140 .

“To Save a Custom Query or Graph” on

To close the graph without saving the custom query or the graph, click Close.

To continue creating new graphs for the same chassis or set of chassis, return to on page 131

step 3

To work with a different chassis or set of chassis, click Cancel and start with

page 131 .

step 1 on

The Measurement Graph Dialog Box (Custom Queries): General Tab

The General tab allows you to create a custom query and generate a graph based on your choice of hardware sensors. When you select more than one chassis, the General tab contains only the units of measurement and hardware sensors that the selected chassis have in common. For example, two 5500 nodes have more sensors in common than one 5500 node and one 5400 node.

Although you can select only one unit of measurement from the list in the Sensors section, you can expand each unit of measurement and select one or more hardware sensors. The units of measurement and hardware sensors are described in the following table.

Teradata Server Management Web Services User Guide 131

Chapter 7: Managing Component Information

Generating Measurement Graphs

Figure 68: Measurement Graph Dialog Box (Custom Queries): General Tab

132

Table 42: Measurement Graph Dialog Box: General Tab Description

Item

# Components

Selected

Sensors

Amps

Description

Lists the default Alias or CIM path for the selected exists, it is displayed instead of the default Alias. chassis

. If a user-defined Alias

Unit of measurement for the current of node or CMIC power supplies. Selecting

Amps chooses all available power supply sensors. Expanding Amps allows you to select one or more power supply sensors.

Amps RMS (Root

Mean Square)

Unit of measurement for UPS input current. Selecting Amps RMS chooses all available input current sensors. Expanding Amps RMS allows you to select one or more input current sensors.

Celsius

Unit of measurement for temperature. Selecting Celsius chooses all available temperature sensors. Expanding Celsius allows you to select one or more temperature sensors.

Count

A count of operating system processes, threads, and handles running on a CMIC.

Selecting Count chooses all operating system items. Expanding Count allows you to select one or more operating system items.

A count of the megabytes of memory used on a CMIC. Selecting MB chooses all measurements. Expanding MB allows you to select one or more types of memory measurements.

Milliamps

Milliwatts

A measure of the current transmitted by a port on the BYA32S chassis.

A measure of the power used to transmit a message through a port on the

BYA32S chassis.

Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Table 42: Measurement Graph Dialog Box: General Tab Description (continued)

Item

Percent

RPM

Volts

Volts RMS (Root

Mean Square)

Watts

Description

•

Nodes: Percent of thermal control on processors. Selecting Percent chooses all processors. Expanding Percent allows you to select one or more processors.

•

CMICs: Percent of space available on CMIC hard drives. Selecting Percent chooses all drives. Expanding Percent allows you to select one or more drives.

Revolutions per minute of baseboard fans on nodes or CMICs. Selecting RPM chooses all available fans. Expanding RPM allows you to select one or more fans.

•

Nodes or CMICs: Unit of measurement for a variety of system baseboard and processor power sensors on nodes or CMICs. Selecting Volts chooses all available power sensors. Expanding Volts allows you to select one or more power sensors.

•

UPSs: Unit of measurement for UPS battery voltage. To select the battery, select Volts, or expand Volts and select Battery: Battery Voltage.

•

BYA32S chassis: Unit of measurement for the volts received by a port.

Unit of measurement for UPS input or output voltage. Selecting Volts RMS chooses all available voltage sensors. Expanding Volts RMS allows you to select one or more voltage sensors.

•

Nodes and CMICs: Unit of measurement for node or CMIC power supply gauges. Selecting Watts chooses both gauges. Expanding Watts allows you to select one or more gauges.

•

UPSs: UPS output watts. To select UPS output watts, select Watts, or expand

Watts and select Output: Output Watts.

Graph Options

Graph Title

Time Series

Bar Graph

The name you want to use for the graph; the title appears at the top of the generated graph.

Retrieves the data for the sensors selected in Sensors and generates an xy graph that plots the change, as measured in the relevant unit of measurement, over the time specified in Time Options.

Retrieves the data for the sensors selected in Sensors and generates a bar graph that shows the latest measurements for each of the selected sensors within the time specified in Time Options.

Teradata Server Management Web Services User Guide 133

Chapter 7: Managing Component Information

Generating Measurement Graphs

Table 42: Measurement Graph Dialog Box: General Tab Description (continued)

Item Description

Periodic Groups

Retrieves the data for the sensors selected in Sensors and uses the setting in

Group values into intervals of to cluster the data into groups. The query calculates the average value of each group, then plots the average value, instead of all values that made up the group, over the time specified in Time Options.

•

Overlay standard deviation lines: Selecting this option calculates the standard deviation of each group, then draws a vertical line through the point, where the bottom of the line indicates the average - the standard deviation and the top of the line indicates the average + the standard deviation.

•

Group values into intervals of: Determines the size of the group:

•

automatic: Calculates how many days of data are available in the CMIC

Measurement Database. If it is less than 30 days, the query groups the data by 3-day intervals. If it is more than 30 days, but less than 60, the query groups the data in 1-week intervals. Between 60 and 120 days groups the data into 2-week intervals, and anything more than 120 days is grouped into monthly intervals.

•

3 days: Groups the data by 3-day intervals

•

1 week: Groups the data by 1-week intervals

•

2 weeks: Groups the data by 2-week intervals

•

1 month: Groups the data by monthly intervals

Note: If the time specified in Time Options is less than the interval, the query clusters all the data into one point.

Time Options

Do not restrict time

Before this time

(inclusive)

After this time

(inclusive)

Between these times

Within the last

Retrieves all measurements stored in the CMIC Measurement Database.

Retrieves measurements stored before the time specified in Start date.

Retrieves measurements stored after the time specified in Start date.

Retrieves measurements stored between the times specified in Start date and End

date.

Retrieves measurements for one of the following intervals: Day, Week, Month, 2

Months, 3 Months, 6 Months.

134 Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Editing the SQL Statement Generated from a Custom Query

Note: You cannot edit predefined system and cabinet-level queries.

If you do not specify a Site ID in a custom query, the results will be unexpected. To avoid getting results from everything, you must filter on Site ID.

To Edit the SQL Statement Generated from a Custom Query

c d a b e

The following procedure assumes you have created a custom query using

“To Create a New

Custom Query,” .

On the Measurement Graph dialog box, click the SQL Statement tab.

Select Edit SQL.

When the confirmation dialog box displays, click Yes.

Using the information in “The Measurement Graph Dialog Box (Custom Queries): SQL

Statement Tab” as a guideline, edit the SQL statement.

Click Create Graph.

Do one of the following:

To save the custom query or graph, see

To continue creating new graphs for the same chassis or set of chassis, return to

To close the graph without saving the custom query or the graph, click Close.

To work with a different chassis or set of chassis, click Cancel and start with

step 3 step 1

To work with previously saved custom queries displayed in the Measurement Graph

Manager, see one of the following:

•

Running an Existing Custom Query

•

Editing an Existing Custom Query

•

•

To save the graph, see Saving Queries and Graphs .

The Measurement Graph Dialog Box (Custom Queries): SQL

Statement Tab

The SQL Statement tab allows you to edit the SQL statement generated from the options selected on the General tab. When you edit the SQL statement, the Sensors and Time Options on the General tab are unavailable.

To edit SQL statements, you must be familiar with SQL syntax and the components and units of measurement stored in the CMIC Measurement database. Use the following information to edit the SQL statement:

•

Do not edit or remove the following line (it shows the program where to find the database):

FROM [$IPS$\x3gsma].[3gsmm].dbo.Measurements1

Teradata Server Management Web Services User Guide 135

Chapter 7: Managing Component Information

Generating Measurement Graphs

•

The custom query can only retrieve data from selected cabinets. To edit the statement so that the SQL retrieves data for all chassis in all cabinets, you must select at least one chassis in each cabinet before you select Event Mgmt > View Measurement Graph > Custom Queries.

•

After you click Create Graph, the program automatically adds an

ORDER BY

clause to the

SQL statement. This ensures that the program can create a graph from the query. If you add an

ORDER BY

clause before you click Create Graph, there are two

ORDER BY

clauses, which will return an error.

•

The program uses the selected chassis to determine where the CMIC Measurement database resides. When the database resides in more than one location (across multiple IP addresses), the program automatically changes the query to: query to ip address1 UNION ALL query to ip address 2 UNION ALL query to ip address 3

In these cases, when the program adds UNION ALL, a valid SQL statement may return an error.

Figure 69: Measurement Graph Dialog Box (Custom Queries): SQL Statement Tab

136

Table 43: Measurement Graph Dialog Box: SQL Statement Tab Description

Item

Edit SQL

Description

When selected, this checkbox allows you to edit the SQL statement on the tab.

Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Running an Existing Custom Query

To Run an Existing Custom Query

Select the chassis that you want to run an existing custom query on.

Note: You can run an existing custom query on chassis that are of the same type as the chassis used to create the query. For example, you can use CMIC 70 to create a query, then run the same query on CMIC 500.

Select Event Mgmt > View Measurement Graph > Custom Queries.

From the Measurement Graph Manager, select the query you want to run.

5 b c

Click Create Graph.

Do one of the following:

To close the graph without saving it, click Close.

To work with other previously saved custom queries displayed in the Measurement

Graph Manager, see one of the following:

•

Editing an Existing Custom Query

•

•

When the Measurement Graph dialog box displays, use the information in The

Teradata Server Management Web Services User Guide 137

Chapter 7: Managing Component Information

Generating Measurement Graphs

Editing an Existing Custom Query

You can edit previously-created custom queries. You cannot edit predefined queries.

To Edit an Existing Custom Query

Select the chassis to query.

Note: You can edit the options used to create an existing custom query, but you cannot change the chassis originally used to create the query.

Select Event Mgmt > View Measurement Graph > Custom Queries.

From the Measurement Graph Manager, select the query you want to edit.

138

7 b c

Click Edit.

Measurement Graph Dialog Box (Custom Queries): General Tab

or The Measurement

Graph Dialog Box (Custom Queries): SQL Statement Tab

to edit the query.

Click Create Graph.

Do one of the following:

To save the custom query or graph, see

Running an Existing Custom Query

To close the graph without saving the custom query or the graph, click Close.

To work with other previously saved custom queries displayed in the Measurement

Graph Manager, see one of the following:

•

•

•

Connecting to Components from the Tree View

Teradata Server Management Web Services User Guide

Chapter 7: Managing Component Information

Generating Measurement Graphs

Renaming an Existing Custom Query

To Rename an Existing Custom Query

Select the chassis to query.

Select Event Mgmt > View Measurement Graph > Custom Queries.

From the Measurement Graph Manager, select the query you want to rename.

In the Rename Query dialog box, type the new name at Enter new name for query.

Click Save. The renamed query appears on the Measurement Graph Manager dialog box.

Deleting an Existing Custom Query

To Delete an Existing Custom Query

Select the chassis.

Select Event Mgmt > View Measurement Graph > Custom Queries.

From the Measurement Graph Manager, select the query you want to delete.

Click Delete.

Teradata Server Management Web Services User Guide 139

Chapter 7: Managing Component Information

Generating Measurement Graphs

Saving Queries and Graphs

To Save a System or Cabinet-Level Measurement Graph in HTML Format

After you create a graph, on the Graph window, click Save.

In the Save Graph Window dialog box, type the file name at File Name.

Note: Do not use a file extension.

Click Save. The file is saved, in HTML format, to the location indicated on the dialog box.

To Save a Custom Query or Graph

Create the graph.

On the Graph window, click Save.

On the Save Graph Window dialog box, the graph title is automatically entered in File

Name and Save query as, if used.

To change the file name or query name, do one of the following:

Note: Do not use a file extension.

•

To save only the graph, type the file name at File Name.

•

To save only the custom query, type a name for the query at Save query as.

•

To save both the graph and the custom query, type a file name at File Name, and a query name at Save query as.

Click Save.

•

If there is a file name in File Name, the graph is saved, in HTML format.

•

If there is a name in Save query as, the query is saved and appears on the Measurement

Graph Manager dialog box.

140 Teradata Server Management Web Services User Guide

CHAPTER 8

Connecting to System Components

SMWeb provides interfaces and connection options that allow you to make LAN, console, and browser-based connections to system components.

Related Topics

•

Connecting to a CMIC

•

•

Connecting to Components from the Client Connections Window

•

Setting Options for Component Connections

•

The Client Connections Window

•

Connecting to Components from the Address Book

•

Working with the Address Book

Connecting to a CMIC

The CMIC Summary displays information about a selected CMIC. The summary is also a gateway for field and development personnel to perform CMIC, server management, and cabinet administration functions.

You can display the CMIC summary from the SMWeb Home page, or from within SMClient.

To Access a CMIC From SMClient

In the Tree View, with the correct Site ID selected, select the CMIC you want to access.

Select Functions > Manage CMIC.

If prompted, log on.

The system displays the CMIC Summary.

Teradata Server Management Web Services User Guide 141

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

Figure 70: CMIC Web Page

To Access a CMIC From SMWeb

From the SMWeb Home page, select Network, Devices, and CMICs.

If prompted, log on.

Click the Primary or Secondary address of the CMIC you want to display.

The system displays the CMIC Summary.

Connecting to Components from the Tree View

SMClient allows you to select components in the Tree View and use the Functions > Connect command to connect to the components. When the New Connection dialog box displays, use the tabs to set connection options.

•

To Connect to a CMIC

•

To Connect to a VM CMIC

•

To Connect to a VMS

•

To Connect to a Node

•

To Connect to a VM Node

•

To Connect to a UPS, Disk Array Controller, Ethernet Switch, BYNET Switch, or Fibre

Channel Switch

142 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

To Connect to a CMIC

In the Tree View, with the correct Site ID selected, select the CMIC you want to connect to.

Select Functions > Connect.

In the Connect dialog box, select the connection type you want to use.

Figure 71: Connect Dialog Box

Table 44: Connect Dialog Box (CMIC) Description

Options

Console

Secure Shell (SSH)

Description

Displays the New Connection dialog box, which allows you to make a connection to a CMIC. This option is used to display the CMIC’s messages during the BIOS booting process or to access the BIOS setup

Displays the New Connection dialog box, which allows you to make a connection. Port 22 is always used for SSH connections.

Teradata Server Management Web Services User Guide 143

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

To Connect to a VM CMIC

In the Tree View, with the correct Site ID selected, select the VM CMIC you want to connect to.

Select Functions > Connect.

In the Connect dialog box, select the SSH connection.

Figure 72: Connect Dialog Box

Table 45: Connect Dialog Box (VM CMIC) Description

Options

Secure Shell (SSH)

Description

Displays the New Connection dialog box, which allows you to make a connection. Port 22 is always used for SSH connections.

144 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

To Connect to a VMS

In the Tree View, with the correct Site ID selected, select the VMS you want to connect to.

Select Functions > Connect.

In the Connect dialog box, select the connection type you want to use.

Figure 73: Connect Dialog Box

Table 46: Connect Dialog Box (VMS) Description

Options

Console

Secure Shell (SSH)

Description

Displays the New Connection dialog box, which allows you to make a connection to a VMS. This option is used to display the VMS’s messages during the BIOS booting process or to access the BIOS setup.

Displays the New Connection dialog box, which allows you to make a connection. Port 22 is always used for SSH connections.

Teradata Server Management Web Services User Guide 145

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

To Connect to a Node

Only the types of connections compatible with the selected node are available.

Note: If the Telnet server is not enabled on the selected node, you cannot make a Telnet connection to the node.

In the Tree View, with the correct Site ID selected, select the node you want to connect to.

Select Functions > Connect.

In the Connect dialog box, select the connection type you want to use.

Figure 74: Connect Dialog Box

146

Table 47: Connect Dialog Box (Node) Description

Options

Console

Secure Shell (SSH)

Telnet

Description

Displays the New Connection dialog box, which allows you to make a connection to a node’s console over the primary server management network. This option is used mainly to display a node’s messages during the BIOS booting process or to access the node’s BIOS setup.

Note: If the primary network is down, a console connection cannot be made.

Displays the New Connection dialog box, which allows you to make an

SSH connection. This option is available if an SSH server is enabled on the node. Port 22 is always used for SSH connections.

Displays the New Connection dialog box, which allows you to make a

Telnet connection to a node. This option is available if the node’s

Telnet server is enabled. Port 23 is always used for Telnet connections.

Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Connecting to Components from the Tree View

Table 47: Connect Dialog Box (Node) Description (continued)

Options

Terminal Services

Description

Allows you to make a Terminal Services or Remote Desktop Client connection to Windows nodes. This option is available if a path to a

Terminal Services Client is specified using the Tools > Options dialog box.

Note: If you are running SMClient on Linux, and you connect to a

Windows node, the Terminal Services connection is not available.

To Connect to a VM Node

In the Tree View, with the correct Site ID selected, select the VM node (e.g., the SWS) you want to connect to.

Select Functions > Connect.

In the Connect dialog box, select the SSH connection type.

Figure 75: Connect Dialog Box

Table 48: Connect Dialog Box (VM Node) Description

Options

Secure Shell (SSH)

Description

Displays the New Connection dialog box, which allows you to make an

SSH connection. This option is available if an SSH server is enabled on the node. Port 22 is always used for SSH connections.

Teradata Server Management Web Services User Guide 147

Chapter 8: Connecting to System Components

Connecting to Components from the Client Connections Window

To Connect to a UPS, Disk Array Controller, Ethernet Switch, BYNET Switch, or Fibre

Channel Switch

In the Tree View, with the correct Site ID selected, select the UPS, disk array controller,

Ethernet switch, BYNET switch, or Fibre Channel switch you want to connect to.

Select Functions > Connect.

Connecting to Components from the Client

Connections Window

The Client Connections Window allows you to connect to system components.

To Connect to One or More Components with the Client Connections Window

Select Tools > Client Connections Window.

Figure 76: Client Connections Window

Select Connection > New.

Setting Options for Component Connections

The tabs on the New Connection dialog box allow you to set options for connecting to components. The dialog box displays when you select the following commands:

•

SMClient’s Functions > Connect

Note: If the New Connection dialog box does not display, select Tools > Options, then select

Prompt for connection settings.

•

Client Connections Window Connection > New

148 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

•

The New Entry command on the New Address Book Entry dialog box (Client Connections

Window Tools > Manage Address Book command)

The New Connection dialog box contains tabs for setting connection options.

The Window Tab, New Connection Dialog Box

The Window tab on the New Connection dialog box allows you to specify display options for the Client Connections Window. The Window tab displays only when you use the Teradata

Functions > Connect command. The default port number is used for the connection.

Figure 77: Window Tab, New Connection Dialog Box

Table 49: New Connection Dialog Box: Window Tab Description

Option Description

Display Connections Manager Displays the Connections Manager in the Client Connections

Window.

Hide terminals until requested Opens the Client Connections Window with all terminal windows hidden.

Teradata Server Management Web Services User Guide 149

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Table 49: New Connection Dialog Box: Window Tab Description (continued)

Option

Open connection(s) in separate Client Connections

Window

Window Options

Description

When making multiple connections, this option displays each connection in a separate Client Connections Window. The settings in the Window tab are used for all the windows.

Displays the Client Connections Window’s Options dialog box. The options are used for the connection. For a description of the options, see

Table 57

150 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

The Connect Tab, New Connection Dialog Box

The Connect tab on the New Connection and New Address Book Entry dialog boxes allows you to specify generic connection options, such as information about the remote host you want to connect to. For example, you can provide the port number and domain name or IP address of the component to which you want to connect.

The port number and other connection information are retained for future connections.

Note: When you use the Functions > Connect command, the Window tab replaces the Connect tab, using the default port number.

Figure 78: Connect Tab, New Connection Dialog Box

Table 50: New Connection Dialog Box: Connect Tab Description

Option

Host

Protocol

Port

Description

The domain name or the IP Address of the host to connect to. This field is required.

The protocol used to establish the connection. The available options are: SFTP (Secure

File Transfer Protocol), SSH (Secure Shell), and Telnet.

The port to connect to on the remote host. This field is required. The default for Telnet is 23. The default for SSH and SFTP is 22. If this field is greater than 65,535, an error message displays.

Teradata Server Management Web Services User Guide 151

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Table 50: New Connection Dialog Box: Connect Tab Description (continued)

Option

Name

Description

The name (alias) of the component or the path to the component; the path follows the hierarchy displayed in the Tree View. If no name is specified, then the host and port number (<host name> (<port number>)) are used.

This value is used as the title of the terminal frame or tab in the Client Connections

Window, and to refer to the connection in the Connection Manager.

Capture text

or data to file

This option allows you to capture data or text sent from the server and save it to a file.

•

Data saves the data interpreted by the terminal, and the text, to a file.

•

Text saves only the text to a file.

for the file where you want to save the text or data.

The default is capture.txt, located in \Documents and Settings\<username>\

sm_client_8_0\<host> in Windows and <username>/sm_client_8_0/<host> in Linux.

To change the path and file name, use the Browse button. where you specify the name and path of the file to save text or data.

152 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

The Terminal Tab, New Connection Dialog Box

The Terminal tab on the New Connection and New Address Book Entry dialog boxes allows you to specify options related to the terminal type and display.

Figure 79: Terminal Tab, New Connection Dialog Box: Terminal Tab

Table 51: New Connection Dialog Box: Terminal Tab Description

Options

Terminal Type

Description

The type of terminal to emulate: ansi-bbs, pc-ansi, vt100, vt100+, vt-utf8.

In addition, a Preferred option is available through the Functions > Connect command, which obtains the selected component’s default terminal type from a

CMIC and uses the default to connect to the selected component.

Restore Defaults

Button

Encoding

Rows

Returns the values on the Terminal tab to their default settings.

The type of encoding used to display data in the terminal. The default is ASCII.

The number of rows to display in the terminal. The number of Rows in Display cannot be greater than the number of Rows in Buffer.

Columns

The number of columns to display in the terminal. The number of Columns in

Display cannot be greater than the number of Columns in Buffer.

Teradata Server Management Web Services User Guide 153

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Table 51: New Connection Dialog Box: Terminal Tab Description (continued)

Options

Foreground

Color

Background

Color

Adjust the number of rows and columns to fit the display area

Font Name

Description

The font color to use in the terminal.

The background color to use in the terminal.

Allows the number of rows and columns to change dynamically as the width and the height of the terminal window changes.

Scroll Screen

Displays the name of the current font used in the terminal.

Font Size

... Button

Displays the size of the current font used in the terminal.

Displays the Select Font dialog box. To change the current font, style, and size of the text displayed in a terminal, select the options, then click Ok.

Buffer Rows

Sets the number of rows in the buffer. The number of Rows in Buffer cannot be less than the number of Rows in Display.

Buffer Columns

Sets the number of columns contained within the buffer. The number of Columns in Buffer cannot be less than the number of Columns in Display.

Cursor Size

The size of the cursor in the terminal.

•

Small: The cursor fills part of the lower half of a character cell.

•

Medium: The cursor fills the lower half of a character cell.

•

Large: The cursor fills a character cell.

Tab Size

The number of character cells that a tab character spans. The default is 4 character cells.

Line Wrap

Causes text to line wrap if the number of columns a line of text spans is greater than the number of columns in the buffer.

Causes the terminal to scroll to the active cursor position when either the server or the user enters text into the terminal.

154 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

The Telnet Tab, New Connection Dialog Box

The Telnet tab on the New Connection and New Address Book Entry dialog boxes allows you to specify Telnet options. If you are connecting to an SMP node, the node’s Telnet server must be enabled before you can make a Telnet connection.

Figure 80: New Connection Dialog Box: Telnet Tab

Table 52: New Connection Dialog Box: Telnet Tab Description

Option

Local Echo

Description

When you enter text, this option causes the client, and not the server, to echo user input.

Send CR as telnet <CR>

<NULL>

Receive data in binary

mode

Causes the Enter key to send a Carriage Return/NULL (0) sequence to the server instead of the Carriage Return/Line Feed sequence.

Causes the server to send data in binary mode.

Send data in binary mode Causes data to be sent to the server in binary mode.

Teradata Server Management Web Services User Guide 155

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Table 52: New Connection Dialog Box: Telnet Tab Description (continued)

Option

Escape Character

Restore Defaults

Description

Specifies the character used to escape from the current interactive session.

When you enter the escape character, a command prompt displays at the terminal. The command prompt allows you to send specific Telnet commands or enter commands that change options. For more information, type help at the command prompt. When you finish, you can use the escape character to return to the interactive session.

Resets the values in the Telnet tab to their default values.

The SSH/SFTP Tab, New Connection Dialog Box

The SSH/SFTP tab on the New Connection and New Address Book Entry dialog boxes allows you to specify options for SSH and SFTP connections. If you are connecting to a node, SSH server must be enabled on the node before you can make an SSH connection or use SFTP. The options you set on the SSH/SFTP tab depend on how the SSH server is configured on the nodes.

There are four types of client authentication that can be configured on the SSH server on the nodes:

•

Host-based authentication (by host)

•

Public key authentication (by user)

•

Password authentication (default)

•

Keyboard interactive authentication (allows for any authentication method that only requires keyboard input)

Note: For more information about configuring SSH Server host and private key authentication on Linux or Windows nodes, see the OpenSSH documentation available online at http://www.openssh.org

. Man pages are available on Linux nodes, and an OpenSSH-

Help.htm file is available on Windows nodes.

Password authentication is used as the default until you use the Set Key dialog box to specify the necessary keys for using host-based and public key authentication.

•

If a host key is specified, and the SSH server allows host-based authentication, then host-based authentication is attempted.

•

If no host key is specified, or if host-based authentication fails, and a user key is specified, and the SSH server allows public key authentication, then public key authentication is attempted.

Note: The Client Connections Window can be used to generate the host and user keys to be used with host-based and public key authentication.

•

If no user key is specified, or if public key authentication fails, and the SSH server allows password authentication, then password authentication is attempted.

•

If password authentication fails, and the SSH server allows keyboard interactive authentication, then keyboard interactive authentication is attempted.

156 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

•

If keyboard interactive authentication fails, an “Authentication Failed” message displays and the connection is closed.

When connecting to an SSH Server the following occurs during host-based authentication:

3 a b

The hosts file is checked to see if the server is trusted.

If the server is not trusted a message states that the host is unknown.

The user is asked if they would like to trust the host.

If the user enters

the connection is closed.

Yes

the connection proceeds as usual.

If the user enters

Always

then the unknown host is added to the hosts file and the user is no longer prompted about trust on subsequent connections to the same server.

Figure 81: New Connection Dialog Box: SSH/SFTP Tab

Table 53: New Connection Dialog Box: SSH/SFTP Tab Description

Option

Default Username

Description

The name used to log on to SMClient.

Teradata Server Management Web Services User Guide 157

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Table 53: New Connection Dialog Box: SSH/SFTP Tab Description (continued)

Option Description

used with host-based and public key authentication. Use the Client

Connection Window’s Tools > Generate Key command to generate host and user keys.

158

•

Host Private Key File: Contains the location and name of the host private key file; to specify a host key for host-based authentication, click Browse and select the appropriate file.

•

User Private Key File: Contains the location and name of the user private key file; to specify a user key for public key authentication, click Browse and select the appropriate file.

•

User Key Passphrase: The password/string used to decrypt the user’s private key.

user. To specify the location of the Hosts File, click Browse and use the Open dialog box. The default is .ssh in <username> in Linux or \Documents and

Settings\<username> in Windows.

For more information, see the SSH server documentation.

Local Home Directory SFTP is a protocol that uses the SSH communication protocol to transfer files securely across a network. This option applies only to SFTP.

Click Browse and use the Open dialog box to set a local directory. The default is the local working directory, which is \Documents and Settings\<username> in Windows and <username> in Linux.

Note: For a list of SFTP commands create an SFTP session and type help at the prompt. The “*” and “?” wild cards can be used in all path-related command arguments. The “*” wildcard substitutes for more than one character. The “?” wildcard substitutes for one character.

Restore Defaults

Button

Resets the values in the SSH/SFTP tab to their default values.

SSH Escape Character Specifies the character used to escape from the current interactive session.

When you enter the escape character, a command prompt displays at the terminal. The command prompt allows you to enter commands to change the terminal emulation type. For more information, type help at the command prompt. When you finish, use the escape character to return to the interactive session.

Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Setting Options for Component Connections

Generating SSH Keys for Use with the SSH Protocol

The Client Connection Window Tools > Generate Keys command allows you to generate keys for use with the SSH protocol’s host-based and public key authentication. After the keys are generated, you must place the public key file on the nodes. The location of the private key file is specified using the Set Keys dialog box on the SSH/SFTP tab.

Figure 82: Key Generator Dialog Box

Table 54: Key Generator Dialog Box Description

Option

Key Location

Password

Algorithm

Verify Password

Key Size

Public Key Format

Description

The location where the public and private keys are stored. For example, if you enter c:\Temp\key, the private key is stored in c:\Temp\key and the public key is stored in c:\Temp\key.pub.

Click Browse to browse to the location to store the key files.

The password that should be used to protect the private key file. If no password is specified, a message allows you to confirm that you want the private key stored in clear text.

Note: Host-based keys should not be password protected.

Specifies whether you want to use the RSA or DSA key algorithm.

Verifies that you entered the correct password in Password.

The size of the key in bits. The key size must be in the range 512 to 2048.

The format of the public key: IETF (Internet Engineering Task Force) standard or OpenSSH format.

Teradata Server Management Web Services User Guide 159

Chapter 8: Connecting to System Components

The Client Connections Window

The Client Connections Window provides an interface for connecting to components and managing component connections. All connections are displayed in the Client Connections

Window.

Figure 83: Client Connections Window

160

To Display the Client Connections Window

✔

From SMClient, select Tools > Client Connections Window.

To Hide or Display the Connections Manager

✔

Click Window > Connections Manager to toggle the display of the Connections Manager.

To Hide or Display the Status Bar

The Status bar displays is at the bottom of the Connections Manager window. It contains the name of the active connection, its terminal type, its status, and the number of active connections in the Client Connections Window.

✔

Click Window > Status Bar to toggle the display of the Status bar.

To Close the Client Connections Window

When you close the Client Connections Window, all open connections are terminated.

✔

In the Client Connections Window, select Connection > Exit.

Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

The Client Connections Window

Working with Terminal Windows

This section lists procedures for working with a terminal window.

Related Topics

•

Opening Terminal Windows

•

Hiding and Displaying Terminal Windows

•

Modifying the Display of Terminal Windows and Terminal Icons

•

Working with Text in a Terminal Window or the Connections Manager

•

Viewing the Properties of Existing Connections

•

Reconnecting to a Terminal Window

•

Saving Open Connections to the Address Book

•

Closing an Existing Connection

Opening Terminal Windows

The File > Open command in the Client Connections Window allows you to open connections whose addresses are stored in the Address Book.

Hiding and Displaying Terminal Windows

The following commands on the Client Connections Window View menu hide and display terminal windows. If there are no open terminal windows, the commands are unavailable.

View Command

Hide <terminal>

Hide Selected

Hide All

Display Selected

Display All

Description

Hides the active terminal window.

•

If you used the Tree View to connect to the component, the component name set with SMClient’s Tools > Options command displays in quotation marks.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays in quotation marks.

Hides the terminal connections selected in the Connections Manager.

Hides all open terminal windows.

Displays the terminal connections selected in the Connections Manager.

Displays all terminal windows.

Modifying the Display of Terminal Windows and Terminal Icons

When you collapse a terminal window, use the following commands in the Client

Connections Window’s Window menu to modify how the window icon displays

. If there is no active terminal in the Client Connections Window, or if the Tabbed layout is used, the commands in the Window menu are unavailable.

Teradata Server Management Web Services User Guide 161

Chapter 8: Connecting to System Components

The Client Connections Window

Window Command

Arrange Icons

Cascade

Description

Arranges window icons in the lower portion of the Client Connections

Window.

Displays each terminal window below and to the right of the window behind it in the Client Connections Window; this command does not display terminal windows outside the boundary of the Client Connections

Window.

Tiles terminal frames within the Connection Desktop Pane.

Tile

Working with Text in a Terminal Window or the Connections

Manager

Use the following commands in the Edit menu to manipulate text in an active terminal or the

Connections Manager. However, the Clear Terminal command is unavailable with the

Connections Manager.

If there is no active terminal displayed in the Client Connections Window, or the Connections

Manager is not displayed, the commands on the Edit menu are unavailable.

Edit Command

Clear Terminal

Copy

Paste

Select All

Deselect All

Description

Clears the buffer of the active terminal.

Copies the selected text from an active terminal or Connections Manager to the system clipboard.

Pastes text from the system clipboard into the active terminal or

Connections Manager. You can also click the right mouse button.

Selects all the text in the active terminal or the Connections Manager.

Deselects all text in the active terminal or the Connections Manager.

162 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

The Client Connections Window

Viewing the Properties of Existing Connections

The Client Connections Window’s Connection > Properties commands display the properties of a selected terminal in the Client Connections Window or a selected connection in the

Connections Manager. If there are no open terminal windows, the commands are unavailable.

Connections Command

Properties <terminal>

Properties for Selected

Description

Displays the properties of the connection.

•

If you used the Tree View to connect to the component, the component name set with SMClient’s Tools > Options command displays in quotation marks.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays in quotation marks.

Displays the properties of the connection selected in the Connections

Manager. This command displays only if the Connections Manager is open and is active when only one connection is selected.

The properties are displayed in a Properties dialog box, which contains a Connect tab, a

Terminal Tab, and either a Telnet tab or SSH/SFTP tab (depending upon the type of connection). The options on the tab match those on the New Connection dialog box, but some options are unavailable because they cannot be changed.

Related Topics

•

To Set Options for the Client Connections Window

To View the Properties of Existing Connections

Do one of the following:

•

If Tabbed layout is used, select the connection tab.

•

If Desktop layout is used, select the connection’s terminal window or icon.

•

If the Client Connections Manager displays

, select the connection row.

In the Client Connections Window, select Connection > Properties <terminal>, or

Connection > Properties for Selected.

Teradata Server Management Web Services User Guide 163

Chapter 8: Connecting to System Components

The Client Connections Window

Reconnecting to a Terminal Window

If a connection in a terminal window is lost, use one of the following Client Connections

Window Connection > Reconnect commands to re-establish the connection. If there are no open terminal windows, the commands are unavailable.

Connections Command

Reconnect <terminal>

Reconnect Selected

Description

Re-establishes the specified connection.

•

If you used the Tree View to connect to the component, the component name set with SMClient’s Tools > Options command displays in quotation marks.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays in quotation marks.

Displays only if the Connections Manager is open. It re-establishes the connections selected in the Connections Manager.

Related Topics

•

Saving Open Connections to the Address Book

•

Closing an Existing Connection

•

To Set Options for the Client Connections Window

Saving Open Connections to the Address Book

The Connection > Save commands in the Client Connections Window allows you to store one or more open connections in the Address Book.

Save Command

Save <terminal>

Save Selected

Save All

Description

Saves the connection in the active terminal window.

•

If you used the Tree View to connect to the component, the component name set with SMClient’s Tools > Options command displays in quotation marks.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays in quotation marks.

Saves the connections selected in the Connections Manager. This command displays only if the Connections Manager is open.

Saves all active connections.

164 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

The Client Connections Window

Closing an Existing Connection

The Connection > Close commands in the Client Connections Window close open terminal windows. If there are no open terminal windows, the commands are unavailable.

Note: The Connection > Close commands do not close the Client Connection Window.

Connections Command

Close <terminal>

Close Selected

Close All

Description

Terminates the connection in the active terminal window and closes the terminal window.

•

If you used the Tree View to connect to the component, the component name set with SMClient’s Tools > Options command displays in quotation marks.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays in quotation marks.

Terminates the connections selected in the Connections Manager and closes its terminal window. This command displays only if the

Connections Manager is open.

Terminates all active connections and closes all open terminal windows.

Working with the Connections Manager

The Client Connections Window’s Window > Connections Manager command displays and hides the Connections Manager. The Connections Manager:

•

Lists each open connection and displays information about the connection.

•

Has an optional Send To toolbar that allows you to send commands to multiple hosts at the same time.

When working with the Connections Manager, you can:

•

Move and resize the columns in a table

•

Sort the columns

•

Select one or more rows

•

Use the commands in the Client Connections Window Edit menu

•

Choose commands from pop-up menus

Note: You can also choose commands from pop-up menus in terminal window title bars.

The active terminal window and the Connections Manager are not dependent on one another.

Teradata Server Management Web Services User Guide 165

Chapter 8: Connecting to System Components

The Client Connections Window

Figure 84: Client Connections Window: Tabbed Layout, Connections Manager, Send To Toolbar

166

Table 55: Connections Manager Description

Column

Send toolbar

Name

Description

Allows you to send commands to multiple hosts at the same time:

If you want input to be sent only to selected terminals, in the Client

Connections Manager, select the terminals.

Specify whether the command should be sent to All terminals or

Selected terminals.

In the Mode list, select one of the following options:

To send input one command at a time in the Send text box, select Command.

To hide the input as you type it in the Send text box, and send the input one command at a time, select Password.

To send input as you type it in the Send text box, select

Keyboard; the input displays in the open terminal windows, and all keyboard keys, such as function keys, can be used for input.

Type or copy and paste the text in the Send text box.

Click the Send button.

The component name or connection:

•

If you used the Tree View to connect to the component, the component name set with the Tools > Options command displays.

•

If you did not use the Tree View to connect to the component,

<hostname> (<port number>) displays.

Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

The Client Connections Window

Table 55: Connections Manager Description (continued)

Column Description

Last Line

IP Address

Port

Protocol Type

Terminal Type

The last line displayed in the terminal window.

The IP address of the component you are connected to.

The port number for the connection.

The connection protocol (SSH, SFTP, or Telnet).

The type of terminal emulation used for the connection (ansi-bbs, pc-ansi,

vt100, vt100+, vt-utf8). The terminal type is specified on the Terminal tab of the

New Connection dialog box.

The date and time the connection was established.

The time that has passed since Time Established.

Time Established

Time Elapsed

Related Topics

•

Working with Text in a Terminal Window or the Connections Manager

•

Client Connections Window Display Options

The following commands allow you to set display options for the Client Connections

Window:

•

Tools > Options displays the Options dialog box, which contains options for:

•

Selecting the display name for the component names displayed in the Client

Connections Window

•

Displaying the New Connection dialog box when the following commands are selected:

Functions > Connect or Tools > Client Connections Window

•

Configuring the program Functions > Connect uses to make connections

•

The Client Connection Window Window > Options command displays the Options dialog box, which allows you to set display options for the Client Connections Window:

Related Topics

•

To Set Options for the Client Connections Window

•

To Set Display Options for the Client Connections Window

•

To Type a User-Defined Alias for a Component Name

•

To Connect to One or More Components with the Client Connections Window

Teradata Server Management Web Services User Guide 167

Chapter 8: Connecting to System Components

The Client Connections Window

To Set Options for the Client Connections Window

From SMClient, select Tools > Options.

In the Client Connections section of the Options dialog box, select the options you want to use. The options are described in

Table 56

Click Ok.

Table 56: Options Dialog Box (Tools > Options): Client Connections Options

Option Description

Connection Names

•

Default: Displays the default names of components in the Tree View; the path reflects the position the component occupies in the hierarchy.

•

Alias: Displays the default aliases of components in the Tree View. If a user-defined alias exists, it displays instead of the default alias.

•

Component ID: Displays the Component IDs of components in the Tree

View.

Prompt for

connection settings

Terminal Services

Client Location

Specifies whether you want to display the New Connection dialog box. The default is checked.

Before the Connect command can be used to make a remote Terminal Services

Connection to an SMP node, you must specify the path to a local Terminal

Services Client or a URL to a Terminal Services Client.

168 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

The Client Connections Window

To Set Display Options for the Client Connections Window

From the Client Connections Window menu bar, select the Window > Options command.

When the Options dialog box displays, use the information in

Table 57

to set the display options you want to use.

Click Ok.

Figure 85: Client Connections Window Options Dialog Box

Table 57: Client Connections Window Display Options

Option Description

Connections Layout

Specifies the type of layout you want to use in the Client Connections Window.

•

Desktop: Displays each connection in its own window on the desktop.

•

Extracted: Displays each connection in its own frame outside of the Client

Connections Window.

Note: When you use this option, if the Connections Manager is not already displayed, it displays, and all frames are automatically hidden. To display the terminal windows, use the Client Connection Window View > Display

Selected or View > Display All command. In addition, each extracted window contains Connection, Edit, and Help menus.

•

Tabbed: Displays each connection on a separate tab.

Tile Layout

Specifies whether you want to use a Vertical, Horizontal, or Grid layout when you use the Client Connections Window’s Window >Tile command.

Teradata Server Management Web Services User Guide 169

Chapter 8: Connecting to System Components

Connecting to Components from the Address Book

Table 57: Client Connections Window Display Options (continued)

Option

Enable Ctrl+C/Ctrl+V

for Copy/Paste

Description

Allows you to use Ctrl+C for the copy command and Ctrl+V for the paste command. If this option is unchecked, Ctrl+C and Ctrl+V are sent to the server.

Enable Ctrl+Tab for

Terminal Traversal

Location

Allows you to use Ctrl+Tab to activate the next terminal in the stack. If this option is unchecked, Ctrl+Tab is sent to the server.

Specifies whether the Connections Manager is located at the Top, Bottom, Left, or Right in the Client Connections Window.

Display “Send To” toolbar

Number of connections to display per line

Displays the Send To toolbar at the top of the Connections Manager.

Connections are usually displayed in one table. Use this option to split the display into two or more tables. All open connections are distributed among the number of tables you specify. This option is useful in large systems.

Columns Displayed

Specifies which columns are displayed in the Connections Manager. The options are Name, Status, Last Line, Terminal Type, IP Address, Port, Protocol

Type, Time Established, and Time Elapsed. For a description of these, see

Table 55 .

Connecting to Components from the Address

Book

Connections stored in the Address Book with the Client Connection Window’s Tools >

Manage Address Book command allow you use the following commands to connect to components:

•

The Client Connection Window Connection > Open command

•

The Open command on the Address Book dialog box (accessible with the Client

Connection Window Tools > Manage Address Book command)

When you add connection entries to the Address Book, the tabs for setting connection options are the same as the tabs on the New Connection dialog box.

Related Topics

•

To Use the Address Book to Open One or More Connections

•

To Open Connections from the Client Connections Window

•

Working with the Address Book

170 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Working with the Address Book

To Use the Address Book to Open One or More Connections

From the Client Connections Window, click Tools > Manage Address Book.

In the Address Book dialog box, on the Content tab, select one or more connection entries or group entries.

To hide the terminals when you open the connection, on the Options tab, select the Hide

terminals when opening connections text box.

Select Open. The selected connections open in the Client Connections Window.

To close the Address Book dialog box, click Ok.

To Open Connections from the Client Connections Window

From the Client Connections Window, select Connection > Open.

On the Open dialog box, Select one or more connection entries or group entries

Click Open.

Working with the Address Book

The Client Connections Window’s Tools > Manage Address Book command and File > Save commands allow you to store connections to components as entries in an Address Book. You can open the connections stored in the Address Book with the File > Open command in the

Client Connections Window, and the Open command provided through the Tools > Manage

Address Book command. The Manage Address Book command also provides commands for editing, managing and organizing the entries in the Address Book.

Related Topics

•

Displaying the Address Book

•

Adding Entries

•

Organizing and Managing Entries

•

Editing Entries

•

Backing Up and Restoring the Address Book

Teradata Server Management Web Services User Guide 171

Chapter 8: Connecting to System Components

Working with the Address Book

Displaying the Address Book

To Display the Address Book

✔

From the Client Connections Window, click Tools > Manage Address Book.

Note: When you make changes on the Address Book dialog box, you must click Ok on the

Address Book dialog box to save the changes and close the Address Book.

Figure 86: Address Book Dialog Box

172

Related Topics

•

Adding Entries

•

Organizing and Managing Entries

•

Editing Entries

•

Connecting to Components from the Address Book

•

Backing Up and Restoring the Address Book

Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Working with the Address Book

Adding Entries

To Add a Connection to the Address Book

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, select New Entry. The New Address Book Entry dialog box displays.

On the Connect tab, specify the host you want to connect to in the Host field.

Use the Name field to store the connection in the Address Book. If Name is empty, type a name for the connection, or provide a name after you save the connection to the Address

Book.

Use the tabs on the New Address Book Entry dialog box to set the rest of the options you want. The tabs are the same as the tabs on the New Connection dialog box.

Click Ok. The Address Book dialog box displays, containing the connection entry.

If you did not provide a name for the connection, the entry is named New Connection.

Click Rename to enter a new name.

To add additional connections, repeat step 2

through

step 6 .

To save the connections to the Address Book, click Ok.

Teradata Server Management Web Services User Guide 173

Chapter 8: Connecting to System Components

Working with the Address Book

To Save Open Connections from the Client Connections Window to the Address Book

The connection name used for the entry is the component’s path, alias, or component ID, depending on the option set for the Tree View.

From the Client Connections Window:

•

To save the active connection, select File > Save <connection name>.

•

To save more than one connection, but not all connections:

Display the Connections Manager (Window > Connections Manager).

Select the connections from the list.

iii

Select File > Save Selected.

•

To save all connections, select File > Save All.

When the Save dialog box displays, do one of the following:

•

If you selected the Save <connection name> command, type a new name for the connection, or leave the default displayed, then click Save. In the Address Book, the new name, or the <connection name>, respectively, is used for the entry.

•

If you selected the Save Selected or Save All commands, do one of the following:

•

To store the selected connections in a group (the default), type the group name in the File name text box, then click Save. In the Address Book, the entries are stored under the group name. The <connection name> is used for the individual entries.

•

To save the connections as individual entries in the Address Book, verify that /

AddressBook is displayed in the File name text box, then click Save. In the Address

Book, the <connection name> is used for the entries.

Organizing and Managing Entries

Organizing and managing entries in the Address Book is similar to organizing and managing folders in a Windows directory.

Connection entries can be grouped into folders and subfolders, and a connection entry can be included in more than one folder. When you open a group with the File > Open command or the Open command in the Address Book dialog box, terminal windows for all connections in the group open in the Client Connections Window.

Related Topics

•

To Create a Group in the Address Book

•

To Copy or Move Existing Entries in the Address Book

•

To Rename an Entry or Group

•

To Remove an Entry or Group

174 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Working with the Address Book

To Create a Group in the Address Book

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, select the Address Book folder or an existing group.

Click New Group. A new folder with the name New Connection Group displays

Click Rename.

Type a name for the group.

Add connections to groups.

To save the connection or connections to the Address Book, click Ok.

To Copy or Move Existing Entries in the Address Book

On the Content tab, select one or more individual entries or group entries.

Do one of the following:

•

To copy the entries to another location, click Copy, select a group folder or the Address

Book folder, then click Paste.

•

To move the entries to another location, drag the entries to the group folder or the

Address Book folder.

To save the changes to the Address Book, and close the Address Book dialog box, click Ok.

Teradata Server Management Web Services User Guide 175

Chapter 8: Connecting to System Components

Working with the Address Book

To Rename an Entry or Group

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, select the entry or group you want to rename.

Click Rename.

Type the new name for the entry or group.

To save the change to the Address Book, click Ok.

To Remove an Entry or Group

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, select the entry or group you want to remove.

Click Remove.

To save the change to the Address Book, click Ok.

Editing Entries

To Edit the Connection Options of an Entry

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, select the connection whose options you want to edit.

Select Edit. The New Address Book Entry dialog box displays.

176 Teradata Server Management Web Services User Guide

Chapter 8: Connecting to System Components

Working with the Address Book

Use the tabs to edit the rest of the options. The tabs are the same as the New Connection dialog box.

Click Ok. The Address Book dialog box displays.

To save the changes to the Address Book, click Ok.

Related Topics

•

Setting Options for Component Connections

Backing Up and Restoring the Address Book

To Back Up the Address Book

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, do one of the following:

•

To back up an individual entry, select the entry.

•

To back up the entire Address Book, select Address Book.

Click Export.

When the Save dialog box displays, it is set to the MyDocuments directory. If you want to save the backup file to a different directory, select the directory from the Save in list.

In the File name field, type a name for the backup file.

Select Save.

To close the Address Book dialog box, click Ok.

To Restore the Address Book

From the Client Connections Window, click Tools > Manage Address Book.

On the Content tab, click Import.

When the Open dialog box displays, it is set to the MyDocuments directory. If the backup file is stored in a different directory, select the directory from the Save in list.

Select Open.

To close the Address Book dialog box, click Ok.

Teradata Server Management Web Services User Guide 177

Chapter 8: Connecting to System Components

Working with the Address Book

178 Teradata Server Management Web Services User Guide

CHAPTER 9

Servicing, Maintenance, and

Troubleshooting

This section describes servicing, maintenance, and troubleshooting procedures.

Related Topics

•

Opening and Closing a Maintenance Window

•

Recording Site Activity

•

Enabling the Locator LED

•

Setting SMClient Options

•

Replacing Hardware Components (FRUs)

•

Checking and Flashing Firmware Versions

•

Setting Battery Installation Dates

•

Managing Support Bundles

•

Dumping Memory

•

Resetting Components

•

Managing System Power

•

Performing Diagnostic Tests

•

Performing the Alert Escalation Test

•

Using SMWeb During SOV Failover

•

Marking a Drive as Failed from SMClient

•

Using SMClient When a Network Is Down

•

Attaching a Device Temporarily to a Virtual Machine

Teradata Server Management Web Services User Guide 179

Chapter 9: Servicing, Maintenance, and Troubleshooting

Opening and Closing a Maintenance Window

The Functions > Maintenance Window command allows you to temporarily suppress Incident

Create. You should open a maintenance window to perform system maintenance, implement a change control, or perform any other task that would generate alerts. Task examples include rebooting a node, replacing a disk drive in a disk array, installing software, or installing firmware.

You can open a maintenance window for the following, per Site ID:

•

System

•

Collectives

•

Cabinets

•

Chassis

•

Chassis components

Schedule the maintenance window ahead of time. When the start time is reached, TAS sends the maintenance window data to Teradata’s Customer Teradata Warehouse (CTW) for the historical record.

During an open maintenance window, Server Management continues to collect data, including summary alerts and reports. Alerts that are processed during the maintenance window are marked with the TVI_Disposition Ignore_Maintenance and the Summary Alert

Escalated is marked Maintenance On to suppress incident creation.

You can extend the duration of the maintenance window while it is open.

In a multi-Site ID configuration, you cannot set a maintenance window globally. Instead, you must create a maintenance window for the system component in each Site ID.

Opening a Maintenance Window

In the Tree View, with the correct Site ID selected, select the system, collective, cabinet, chassis, or chassis component for which you want to open or schedule a maintenance window.

Select Functions > Maintenance Window.

180 Teradata Server Management Web Services User Guide

The Maintenance Window appears.

Figure 87: Maintenance Window

Chapter 9: Servicing, Maintenance, and Troubleshooting

Opening and Closing a Maintenance Window

Table 58: Maintenance Window Description

Item

Current List

Start Time

Description

A list of the maintenance windows currently open or scheduled.

The date and time the maintenance window opens; must be entered in the format YYYY-MM-DD HH:MM:SS. The default is the current date and time, but can be changed to schedule the maintenance window in advance.

Teradata Server Management Web Services User Guide 181

Chapter 9: Servicing, Maintenance, and Troubleshooting

Opening and Closing a Maintenance Window

Table 58: Maintenance Window Description (continued)

Item

End Time

Component

Apply to all

Subsystem

Name

Comments

Current System Status

Description

The date and time the maintenance window closes; must be entered in the format YYYY-MM-DD HH:MM:SS. The default is four hours later than the Start Time. The limit is 672 hours (4 weeks) later than the start time.

Identifies the alias of the component in the Tree view on which the maintenance window is open.

Select this option to put all components of the same object class into maintenance. Alerts generated for components with a matching object class are ignored.

When a subsystem is selected, alerts coming from the component

(or components it contains) that match the subsystem are ignored.

Categorizing alerts by subsystem groups alerts that are related by the hardware or software subsystem of origin.

For example, if there’s a recurring OS problem on a node, select the node, open a Maintenance window for it, and select a subsystem of

OS.

A name to identify this maintenance window.

Additional information about the maintenance window.

Shows whether a maintenance window is open for the system, collective, cabinet, chassis, or component:

•

If a maintenance window is open, Maintenance Mode is ON displays.

•

If a maintenance window is closed, Maintenance Mode is OFF displays.

Complete the fields on the Maintenance window, and click Activate.

Editing an Open or Scheduled Maintenance Window

Use the following procedure to:

•

Provide additional information for an open maintenance window

•

Change the duration of an open or scheduled maintenance window

•

Edit the information for a scheduled (future) maintenance window

To Edit an Open or Scheduled Maintenance Window

In the Tree View, with the correct Site ID selected, select the system, collective, cabinet, chassis, or chassis component for which you want to edit a maintenance window.

Select Functions > Maintenance Window. The Maintenance Window appears.

Select the maintenance window from the Current List.

182 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Recording Site Activity

Edit the fields as needed.

Click Update.

At the confirmation, click Yes.

Click OK to close the window.

Closing a Maintenance Window

Use the following procedure to:

•

Close an open maintenance window if you finish a task early.

•

Delete unneeded, scheduled maintenance windows that have a future date and time.

If there are no other open maintenance windows, alerts stop being marked

Ignore_Maintenance.

Note: Allowing the time to expire also closes a maintenance window.

To Close or Delete a Maintenance Window

In the Tree View, with the correct Site ID selected, select the system, collective, cabinet, chassis, or chassis component for which you want to close a maintenance window.

Select Functions > Maintenance Window. The Maintenance Window appears.

Select the maintenance window from the Current List.

Click Delete.

At the confirmation, click Yes.

Click OK to close the window.

This closes an open maintenance window or deletes a scheduled maintenance window.

The information is sent to Teradata Services immediately.

Note: If you select an open maintenance window and click Delete, the time is set to the current time, and the open maintenance window closes.

Recording Site Activity

The Record Site Activity command (Functions > Record Site Activity in SMClient or the Alert

Viewer) allows you to record and save information about activities performed on a system, collective, cabinet, chassis, or component.

You can record information about activities that are related to alerts, incidents, FROs, FRUs, and change controls. You can also record notes about other site activities, such as preventive maintenance activity or a note to other site team members.

The Event Viewer allows you to view site log entries entered with the Record Site Activity command.

You can also record site activity from the Summary Alert Viewer.

Teradata Server Management Web Services User Guide 183

Chapter 9: Servicing, Maintenance, and Troubleshooting

Recording Site Activity

Related Topics

•

Working with the New Site Activity Entry Dialog Box

The New Site Activity Entry dialog box allows you to enter information into the site log. For example, you can record your investigation into a problem, or record an action performed to solve a problem, such as replacing a FRU.

The New Site Activity Entry dialog box accessed from the Summary Alert Viewer has fewer entries as shown below.

Related Topics

•

Recording Site Activity in the Site Log

•

Viewing Site Log Entries

Figure 88: New Site Activity Entry Dialog Box

184 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Recording Site Activity

Figure 89: New Site Activity Entry Dialog Box (From Summary Alert Viewer)

Table 59: New Site Activity Entry Dialog Box Description

Item

Date

User Name

Change Control Number

Incident Number

FRO Number

Maintenance Action

Description

Activities that start on the specified date and time, in the format YYYY-MM-DD

HH:MM:SS

. The default is the current date and time, which are automatically entered when you select the Record Site Activity command.

Allows you to type the name or user name of the person who is investigating a problem, who performed an action to resolve a problem, or who is now indicating that a problem is resolved. The name does not have to correspond to a user account login name. This field is optional.

Maintenance Action plus one of the following fields are required: User Name or Comments.

Valid change control number (1000 - 999999).

Must begin with RAZ, REC, XAZ, or XEC, followed by six alpha-numeric characters.

Must begin with 35-, followed by four numbers.

Specifies which maintenance action was performed to resolve the problem:

•

Under_Investigation: The problem is currently being investigated.

•

Maintenance_Scheduled: A maintenance action is expected at a future date to fix the problem.

•

Action_Taken: An action was performed.

•

Solved: The problem was corrected.

•

Parts_Ordered: The investigation resulted in a replacement part or parts being ordered.

•

FRU_Replaced: A component was replaced.

•

Reseated: The problem was resolved by reseating the component.

Maintenance Action plus one of the following fields are required: User Name or Comments.

Teradata Server Management Web Services User Guide 185

Chapter 9: Servicing, Maintenance, and Troubleshooting

Recording Site Activity

Table 59: New Site Activity Entry Dialog Box Description (continued)

Item

Comments

Description

Allows you to enter additional information about the maintenance actions performed to resolve the problem; this information appears in the Description field of the Event Viewer.

The Maintenance Action field plus one of the following fields are required: User Name or

Comments.

Recording Site Activity in the Site Log

To Record Site Activity in the Site Log from the Alert Viewer or SMClient

Do one of the following:

•

In the Alert Viewer, select one or more alerts, then select Functions > Record Site

Activity.

•

In SMClient, with the correct Site ID selected, select the system, collective, cabinet, chassis, or component in the Tree View, then select Functions > Record Site Activity.

In the New Site Activity Entry dialog box, select a Maintenance Action, then do one or both of the following:

•

Type your name in User Name.

•

Add text to Comments.

Provide additional information (optional).

Click Save.

To Record Site Activity in the Site Log from the Summary Alert Viewer

In the Summary Alert Viewer, select one or more scenarios, then select Functions > Record

Site Activity from the Summary Alert Viewer.

In the New Site Activity Entry dialog box:

•

Type your name in User Name.

•

Add text to Comments.

Click Save.

Viewing Site Log Entries

To Search for Site Log Entries in the Event Viewer

In the SMClient Tree View, with the correct Site ID selected, select the system, collective, cabinet, chassis, or component whose entries you want to view

Select Event Mgmt > Event Viewer. The View Events dialog box appears.

Set the Events for the last or Most recent options.

186 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Enabling the Locator LED

Select Enable Event Type Filtering.

Select Site Log.

Deselect all other options.

Click Ok. Site log entries, if present, are listed in the Event Viewer.

In the Event Viewer, select the site log entry you want to view, then select View > Detail. The details of the site log entry are displayed in the Event Details window.

Enabling the Locator LED

The Functions > Enable Locator LED command in SMClient illuminates the locator LED on a node, CMIC node, VMS, disk enclosure, UPS, or drive within a disk enclosure. The LED remains illuminated until you turn it off.

To Enable the Locator LED of a Node, CMIC, VMS, UPS, Disk Enclosure, or Drive in a

Disk Enclosure

In the Tree View, with the correct Site ID selected, select a node, CMIC, VMS, UPS, disk enclosure, or drive within a disk enclosure.

Select Functions > Enable Locator LED. The locator LED is illuminated, and the Locator

LED Enabled dialog box appears.

Figure 90: Locator LED Enabled

When you have finished, click Disable to turn off its locator LED.

Teradata Server Management Web Services User Guide 187

Chapter 9: Servicing, Maintenance, and Troubleshooting

Setting SMClient Options

Set SMClient options through the Tools > Options command. This command displays the

Options dialog box.

Figure 91: Options Dialog Box

188

For Information on:

Component Tree Options

Cabinet Window Options

Alert Viewer Options

Client Connections Options

Command Output Window Options

Event Viewer Options

Summary Alert Viewer Options

See:

Changing the Component Label in the Tree View

Creating a Cabinet Window

Displaying the Alert Viewer

Setting Options for Component Connections

Viewing Command Output

Displaying the Event Viewer

Displaying the Summary Alert Viewer

Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Replacing Hardware Components (FRUs)

Note: Components are serviced or replaced by Teradata Service personnel.

If a Teradata Service agreement is in place, notification or prediction of a failed component is made directly to Teradata Services through TVI software, and Teradata Services responds per the agreement. If the customer does not use TVI, they must create an incident through

Teradata@YourService.

The following SMClient commands are used to replace components:

•

Functions > Replace FRU

Some Field-Replaceable Units (FRUs) can be replaced with this command, which uses an interactive script to step through the replacement process. Only one FRU Replace command can be active at one time.

•

Functions > Power Off and Functions > Power On

Some FRUs are not replaceable with Functions > Replace FRU. They are replaced by powering off the chassis with Functions > Power Off, replacing the component, and powering on the chassis with Functions > Power On. Some FRUs do not need to be powered off to replace them. For more information, see the service guide for the chassis.

The appropriate hardware replacement procedures for FRUs can be found in the chassis hardware service guide .

Related Topics

•

Replacing FRU Components

•

Using the FRU Replace Procedure Window

Replacing FRU Components

The Functions > Replace FRU command in SMClient steps through the FRU replacement process.

Note: This procedure is not supported for tape libraries.

Related Topics

•

To Replace a Chassis

•

To Replace a Chassis Component

•

Using the FRU Replace Procedure Window

Teradata Server Management Web Services User Guide 189

Chapter 9: Servicing, Maintenance, and Troubleshooting

Replacing Hardware Components (FRUs)

To Replace a Chassis

In the Tree View, with the correct Site ID selected, select the chassis to be replaced.

Select Functions > Replace FRU.

When the Replace FRU dialog box displays, select Entire chassis.

Click Ok.

When the FRU Replace Procedure window displays, use it to replace the chassis.

To Replace a Chassis Component

In the Tree View, with the correct Site ID selected, select the chassis whose component is to be replaced.

Select Functions > Replace FRU.

When the Replace FRU dialog box displays, select Chassis component.

190

Click Ok.

If a FRU Replace Procedure window displays, use it to replace the component.

If you are replacing a disk array component, in the Key list, select the component you want to replace. For all other components, skip this step.

Select the button corresponding to the view that contains the component you want to replace.

In the Chassis Layout View, the components with numbered squares denote components that you can replace. Click the square associated with the component you want to replace.

When the FRU Replace Procedure window displays, use it to replace the component.

Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Replacing Hardware Components (FRUs)

Using the FRU Replace Procedure Window

The FRU Replace Procedure window guides you through the procedure for replacing components. Each procedure is an ordered list of steps, descriptions, and actions that are performed manually or automatically by running a command step. Steps are then run (or skipped) contingent upon user confirmation.

To Replace a FRU with the FRU Replace Procedure Window

For the step highlighted in the left panel, do one of the following:

•

Follow the process outlined in the Step Description on the right panel, then click Ok.

•

Click Skip, if appropriate.

Repeat for each step until the procedure is complete.

Figure 92: FRU Replace Procedure Window

Teradata Server Management Web Services User Guide 191

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

Table 60: FRU Replace Procedure Window Description

Item Description

Title Bar Contains the path of the component you selected, and the Session ID.

Each replacement procedure has a Session ID that prevents simultaneous, conflicting

FRU replace procedures for chassis and chassis components managed by a specific component. For example, you cannot replace two different components in the same chassis at the same time.

If you attempt simultaneous FRU replace procedures, a warning message informs you that a conflicting FRU replace session is active. The warning message displays the

Session ID of the active session:

•

Click No to the question “Do you wish to override the active session?” to continue with the session that is already in progress.

•

Click Yes to the question “Do you wish to override the active session?” aborts the session that is in progress and displays a new FRU replace window. The original

FRU replace window remains open until you either close that window, or issue a command from that window.

Aborting active FRU replace procedures is not recommended. However, if the application is closed before an active session is complete, the system assumes that the session is still active. When you restart SMClient and attempt to initiate another session that is in conflict with the previous session, click Yes to abort the previous session.

Steps panel

Lists all the steps that need to be completed to replace the selected component.

Step

Description panel

Describes the highlighted step in Steps and provides additional information you may need to run the step.

Checking and Flashing Firmware Versions

The Tools > Firmware Version Checker command in SMClient highlights out-of-date firmware and displays corresponding information for firmware that can be flashed through server management, per Site ID.

Note: Firmware Version Checker only reports on versions that can be flashed through server management. Obtain the firmware version information of chassis flashed with other applications through Asset information.

You can also use the Firmware Version Checker to flash firmware. In addition, the Functions menu in SMClient offers a Flash Firmware option.

Related Topics

•

Checking Firmware with the Firmware Version Checker

•

Flashing Firmware from the Firmware Version Checker

•

The Firmware Version Checker Window

•

Flashing Firmware from the SMClient Functions Menu

192 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

Checking Firmware with the Firmware Version Checker

The Tools > Firmware Version Checker command allows you to compare the active (i.e., currently running) firmware versions against the uploaded or flashed CMIC image. The results display in the Firmware Version Checker window.

To Check Firmware Versions

In SMClient, with the correct Site ID selected, select Tools > Firmware Version Checker.

The system checks for an uploaded CMIC image. If it finds one, it asks if you’d like to compare it against the firmware. Click Yes.

The Firmware Version Checker window displays, with mismatches highlighted. You can only view the different versions, since the CMIC image has not yet been flashed.

Flashing Firmware from the Firmware Version Checker

To Use the Firmware Version Checker to Flash Firmware

With the correct Site ID selected, select Tools > Firmware Version Checker.

If there is no uploaded CMIC image available, the system does not prompt for comparison.

On the Firmware Version Checker window, select one or more components to flash.

Note: Firmware on UPS adapters and UPSs cannot be flashed at the same time. Flash the firmware on the UPS adapters first, then the firmware on the UPSs. The Powerware UPS has one UPS adapter (ADPCARD.x.x.x.1 in the Firmware Version Checker), the APC UPS has two UPS adapters (ADPCARD.x.x.x.x.1 and ADPCARD.x.x.x.x.2).

Select Functions > Flash.

When prompted, click Yes.

The Firmware Version Checker Window

The Firmware Version Checker contains a row for each firmware instance in the system. The arrow indicates sort order. The columns are described in

Table 61

Note: Highlighted rows are described in the Status column.

Note: Some components have more than one firmware instance.

Teradata Server Management Web Services User Guide 193

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

Figure 93: Firmware Version Checker Window

Table 61: Firmware Version Checker Window Description

Column

Component

Type

Available Version

Active Version

Definition

Path, default alias, or component ID of the component, depending on the option set in the View menu:

•

View > Alias displays the default alias. If a user-defined alias exists, it displays

instead.

•

View > Name displays the hierarchy displayed in the Tree View.

•

View > ID displays the CIM path.

Type of firmware:

•

Adapter Card Firmware (UPSs)

•

CMIC Image (CMICs)

Note: The CMIC image only displays when you are comparing against the uploaded image

•

Ethernet Switch Firmware (48-port Ethernet switches)

•

FCSW Firmware (16-port or 20-port Fibre Channel switch)

•

UPS Firmware (UPSs)

•

VMS Firmware (VMS)

Note: Firmware on UPS adapters and the UPS cannot be flashed at the same time. For an APC UPS, flash both adapters first, then the UPS. For a Powerware UPS, flash the adapter first, then the UPS.

The latest available firmware version from the uploaded CMIC image or the flashed CMIC image, depending on the display.

The firmware version currently running

194 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

Table 61: Firmware Version Checker Window Description (continued)

Column

Status

Definition

Indicates the relationship between the Available Version and Active Version columns:

•

OK: The firmware version installed matches the currently-supported version.

•

Mismatch: The firmware version installed is not the currently supported version.

•

Unknown: The firmware version information is missing or unavailable.

When there is a mismatch or missing information, the following colors highlight the row:

•

Red: A more current version of the CMIC Image is available.

•

Yellow: A more current version of firmware is available (all components except the CMIC Image).

•

Gray: Firmware version information is missing.

Working with the Firmware Version Checker

To Change the Component Name Displayed in the Firmware Version Checker

✔

In the View menu of the Firmware Version Checker, select Alias, Name, or ID.

A dot to the left of the command in the View menu identifies the current setting for the

Component column.

To Rediscover the Firmware Version of Components

In the Firmware Version Checker, select the component you want to rediscover. To reload the firmware version of all components, deselect them all.

Select View > Reload to reload the selected component, or View > Reload All to reload all firmware versions.

Flashing Firmware from the SMClient Functions Menu

The Functions > Flash Firmware command downloads new firmware to these components:

•

UPS adapters and UPSs

•

Fibre channel switches (16-port and 20-port)

•

Ethernet switches (48-port)

When a new version of firmware has been released, use the CMIC Monitor to install the currently supported CMIC image on the CMICs before you use the Functions > Flash command to update UPS adapter, UPS, Fibre Channel switch, or Ethernet switch firmware.

For more information, see the appropriate Hardware Service Guide for your platform.

You can also use the Tools > Firmware Version Checker command to flash firmware.

Teradata Server Management Web Services User Guide 195

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

Related Topics

•

Flashing UPS Adapter and UPS Firmware

•

Flashing Fibre Channel Switch Firmware

•

Flashing Ethernet Switch Firmware

•

Flashing VMS Firmware

Flashing UPS Adapter and UPS Firmware

Caution:

When flashing the firmware of UPS adapters and UPSs, a power check is performed. If the power check fails, a dialog box allows you to force the command to run. Do not force a

command to run until you review the warning in Forcing a Command to Run after a

Power Check Failure .

To Flash the Firmware on APC UPS Adapters and an APC UPS

Caution:

Firmware on the UPS adapters and UPS cannot be flashed at the same time. Flash the firmware on the

UPS adapters first, then the firmware on the UPS. (

APC UPS firmware is extracted from APC UPS adapter 1.)

Download the current version of the CMIC image. The firmware for both the UPS and

UPS adapters is included with the CMIC image. For more information, see the appropriate Hardware Service Guide for your platform.

In the Tree View, with the correct Site ID selected, select both UPS adapters of each UPS you want to flash.

Note: If you select more than one pair of UPS adapters in a cabinet, they are flashed one at a time (serially).

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes.

In the Tree View, with the correct Site ID selected, select one or more UPSs whose adapter firmware has been flashed.

Note: If you select more than one UPS in a cabinet, they are flashed one at a time

(serially).

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes.

196 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

To Flash the Firmware on a Powerware UPS and UPS Adapter

Caution:

Firmware on the UPS adapter and UPS cannot be flashed at the same time. Flash the firmware on the

UPS adapter first, then the firmware on the UPS.

Download the current version of the CMIC image. The firmware for both the UPS and

UPS adapters is included with the CMIC image. For more information, see the appropriate Hardware Service Guide for your platform.

In the Tree View, with the correct Site ID selected, select the UPS adapter of each UPS you want to flash.

Note: If you select more than one UPS adapter in a cabinet, they are flashed one at a time

(serially).

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes.

In the Tree View, with the correct Site ID selected, select one or more UPSs whose adapter firmware has been flashed.

Note: If you select more than one UPS in a cabinet, they are flashed one at a time

(serially).

At the confirmation dialog box, click Yes.

Caution:

When flashing the firmware on the bottom two UPSs in the cabinet (UPS1 and/or UPS2), a short-term primary or secondary network outage may occur.

Flashing Fibre Channel Switch Firmware

To Flash the Firmware on a Fibre Channel Switch

Note: If you select more than one Fibre Channel switch, the firmware of each switch is flashed one switch at a time (serially).

Download the current version of the CMIC image. The Fibre Channel switch firmware is included with the CMIC image. For more information, see the appropriate Hardware

Service Guide for your platform.

In the Tree View, with the correct Site ID selected, select the Fibre Channel switch to be flashed.

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes. (The dialog box also reminds you to reset the

Fibre Channel switch after the firmware flash completes. Resetting the switch activates the firmware.)

When the firmware flash completes, click Yes.

When the command status window displays, verify that the flash completed successfully.

Teradata Server Management Web Services User Guide 197

Chapter 9: Servicing, Maintenance, and Troubleshooting

Checking and Flashing Firmware Versions

If the flash is successful, do the following to activate the firmware:

Select the same Fibre Channel switch.

Select Functions > Reset.

At the confirmation dialog box, click Yes. (The dialog box also informs you that the switch is temporarily out of service.)

When the reset completes, click Yes.

Verify the results of the reset by checking the output in the command status window.

Flashing Ethernet Switch Firmware

To Flash the Firmware on an Ethernet Switch

Download the current version of the CMIC image. The Ethernet switch firmware is included with the CMIC image. For more information, see the appropriate Hardware

Service Guide for your platform.

In the Tree View, with the correct Site ID selected, select one or more Ethernet switches.

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes

When the firmware flash and switch reset completes, click Yes.

In the command status window, verify that the flash completed successfully and that the switch was reset.

Flashing VMS Firmware

To Flash the Firmware on a VMS

Download the current version of the VMSimage zip file from TSS.

Display the CMIC Monitor, by selecting Network, Devices, and CMICs from SMWeb.

Select CMICs > Firmware Upload.

Browse to the zip file, and click Upload.

Click Continue to go to the next page.

On the CMIC Selection page, select the CMICs that will get the firmware bundle.

Continue to the next screen where the firmware bundle is distributed to the selected

CMICs.

In the Tree View, with the correct Site ID selected, select one or more VMS devices.

Select Functions > Flash Firmware.

At the confirmation dialog box, click Yes

When the firmware flash completes, click Yes.

198 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Setting Battery Installation Dates

If the flash is successful, reset the VMS devices:

Select the same VMS devices.

Select Functions > Reset.

At the confirmation dialog box, click Yes.

When the reset completes, click Yes.

In the command status window, verify that the flash completed successfully and that the

VMS was reset.

Setting Battery Installation Dates

The life of a UPS battery is three years. UPS batteries must be replaced before they expire. The following SMClient commands allow you to set and track battery installation and replacement dates:

•

Functions > Set Battery Date allows you to change the installation date for batteries.

•

Tools > Battery Date Information displays date information for batteries and allows you to change the installation date.

Related Topics

•

Changing Battery Installation Dates with Set Battery Date

•

Viewing and Changing Battery Installation Dates

Changing Battery Installation Dates with Set Battery Date

To Use the Set Battery Date Command to Change Battery Installation Dates

In the Tree View, with the correct Site ID selected, select one or more UPS batteries.

Select Functions > Set Battery Date.

Teradata Server Management Web Services User Guide 199

Chapter 9: Servicing, Maintenance, and Troubleshooting

Setting Battery Installation Dates

Figure 94: Set Battery Date Dialog Box

On the Set Battery Date dialog box, enter the new battery date for the selected batteries at

Battery Installation Date. Use the format

YYYYMMDD

Click Ok.

Viewing and Changing Battery Installation Dates

To View and Change Battery Installation Dates

In SMClient, select Tools > Battery Date Information.

The Battery Date Information window displays a list of all batteries in the system, with their installation and replacement dates.

Figure 95: Battery Date Information Window

200

The icon on the left is a severity indicator:

•

Green (OK) displays if the battery installation date is newer than 2.5 years.

Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing Support Bundles

•

Orange (degraded) displays for a battery older than 2.5 years.

•

Magenta (critical) displays for any battery older than 3.0 years.

If there are no batteries available in the selected Site ID, an informational message displays.

Select the batteries to change. To change the installation date of all the batteries in the window, select Functions > Select All.

Select Functions > Set Battery Date.

On the Set Battery Installation Date(s) dialog box, enter the new battery date for the selected batteries at Battery Installation Date. Use the format

YYYYMMDD

Figure 96: Set Battery Installation Date(s) Window

Click Ok.

Managing Support Bundles

Support bundles are packages of device-dependent support data, which are primarily used to diagnose problems. For example, support bundles are collected from certain disk array controllers and drive enclosures.

Note: Support bundles are collected by default. You can use parameters in the CMIC

Configuration to enable or disable support bundle collection for supported devices.

The Functions > Retrieve Support Bundles command allows you to:

•

Download existing support bundles for viewing

•

Trigger the collection of new support bundles

Teradata Server Management Web Services User Guide 201

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing Support Bundles

Support bundle collection is:

•

Automatically triggered by an alert; the alert is based on a set of rules in Alert Knowledge

•

Manually triggered by using the Functions > Collect New Bundle command on the Support

Bundles window.

Support bundles are automatically escalated to the TVI backend as soon as they are available.

Events in the Event Viewer track the collection of each support bundle.

Note: If the CMIC managing the component experiences a CMIC failover, support bundles are not collected for that component until the CMIC failover is resolved.

Working with Support Bundles

The Support Bundles window lists all available support bundles stored on the managing

CMIC. The selected component’s system, collective, cabinet, and chassis ID are displayed at the root of the list.

Due to size constraints, the file is archived in a compressed (zipped) format. Use your standard compression tools to view and extract the contents of the file.

While the window is open, the list is updated with newly created support bundles. The managing CMIC stores a maximum of 10 support bundles for each component. When this threshold is reached, the oldest support bundle is deleted.

Related Topics

•

Collecting New Support Bundles

•

Retrieving Existing Support Bundles

•

Downloading a Support Bundle for Viewing

Figure 97: Support Bundles Window

202 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing Support Bundles

Collecting New Support Bundles

To Collect New Support Bundles

In the Tree View, with the correct Site ID selected, select a component for which support bundles are collected.

Click Functions > Retrieve Support Bundles. The Support Bundles window displays the list of available support bundles.

From the Support Bundles window, click Functions > Collect New Bundle.

Note: A command output window shows the progress of the support bundle collection.

The new support bundle is displayed at the top of the list in the Support Bundles window.

Retrieving Existing Support Bundles

To Retrieve Existing Support Bundles

In the Tree View, with the correct Site ID selected, select a component for which support bundles are collected.

Select Functions > Retrieve Support Bundles. The Support Bundles window displays the list of available support bundles.

Downloading a Support Bundle for Viewing

To Download a Support Bundle for Viewing

From the Support Bundles window (Functions > Retrieve Support Bundles), click the support bundle you want to download. Support bundles have a .gz file extension.

Note: If you are on the customer LAN, you must log in as a Service User to download support bundles.

On the File Download dialog box, click Save

Specify the directory where you want to download the support bundle zip file.

Note: The downloaded bundle is compressed. To extract and view the files, you must use a compression utility.

Teradata Server Management Web Services User Guide 203

Chapter 9: Servicing, Maintenance, and Troubleshooting

Dumping Memory

Select this item only when instructed to do so by Teradata technical support personnel. It is used when a node, VM node, CMIC, VM CMIC, or VMS is unresponsive.

To start the Memory Dump process, in the correct Site ID select the unresponsive component from the Tree View, then select Functions > Dump Memory.

If you perform a memory dump on the VMS, all of the associated VMs power cycle after the memory dump is complete.

If the command will impact additional Site IDs, a warning message displays.

Caution:

This operation does not perform a graceful shutdown.

Resetting Components

The Functions > Reset command lets you reset components. If the command will impact additional Site IDs, a warning message displays.

Table 62

lists the components you can reset from the Tree View.

Table 62: Resettable Components

Component

System

Node Cabinet

CMIC

Node Chassis

VMS

VMs

BYNET Chassis

Result

A graceful shutdown and reboot of all the nodes in the system is attempted.

A graceful shutdown and reboot of the nodes in the cabinet is attempted.

During a reset of a CMIC, the CMIC reboots.

A graceful shutdown and reboot of the specific node is attempted.

A graceful shutdown and reboot of the VMS is attempted. This also resets the

VMs on the VMS.

A graceful shutdown and restart of the VM is attempted.

Resets the BYNET chassis.

Note: This does not reset the BYNET network. If the system contains a

BYB64G chassis in the BYNET network, it may be necessary to use the

BYNET Utility to reset the BYNET network after resetting a BYNET chassis.

After the Reset command completes, a dialog box asks if the BYNET Utility should be invoked. For information about when it is appropriate to use the

BYNET Utility, see the Service Guide appropriate for your system.

Note: This applies to BYNET v3 only. BYNET v4 does not have reset capability.

Ethernet Switch

(24-port and 48-port)

Resets the Ethernet switch; the ports on the attached devices are unavailable during the reset.

204 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Resetting Components

Table 62: Resettable Components (continued)

Component

Fibre Channel Switch

(16-port and 20-port)

UPS Adapter

Result

Resets the Fibre Channel switch; the ports on the attached devices go to “link down” and are unavailable during the reset.

You must also use the Reset command to activate Fibre Channel switch firmware after a firmware flash.

Resets the adapters in the UPS in systems that have one.

Note: When resetting adapters for an APC UPS, select both APC UPS adapters.

To Reset Components

Caution:

Before starting the reset of a system, node chassis, processing node cabinet, VMS, or VM node, shut down appropriate applications to ensure data integrity.

In the Tree View, with the correct Site ID selected, select one or more components.

Note: If you select one or more Fibre Channel switches and any other component, the

Reset command is unavailable.

Select Functions > Reset.

Caution:

If a power check fails during the reset of a UPS adapter or Fibre Channel switch, a dialog box allows you to force the command to run. Do not force any command to run until you review the

warning in Forcing a Command to Run after a Power Check Failure

To Perform a Hard Reset on a Node, VM Node, or VMS

Caution:

A hard reset is an immediate reset of the node, VM node, or VMS. Database corruption on the nodes may occur. Perform this command only when all other attempts to reset have failed.

Performing a hard reset on the VMS also resets the associated VMs.

In the Tree View, with the correct Site ID selected, select the VMS, or one or more nodes.

Select Functions > Hard Reset.

At the warning message, click Yes.

Teradata Server Management Web Services User Guide 205

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing System Power

The Functions > Power Off and Functions > Power On commands power systems, cabinets, chassis, and VMs off and on.

If the command will impact additional Site IDs, a warning message displays.

Related Topics

•

Forcing a Command to Run after a Power Check Failure

•

Powering Off a System/Cabinet/Chassis

•

Powering On a System/Cabinet/Chassis

•

Recovering from a Power Failure

Forcing a Command to Run after a Power Check Failure

Warning: Forcing a command to run should only be done as a last resort, and only under the direction of a Customer Service Representative.

If a power check fails, a dialog box displays, allowing you to force the command to run. Click

Yes to run the command.

You can force a command to run during the following commands:

Command

Reset

Power On

Flash Firmware

UPS Self Test

UPS Input Selector Test

Component

•

UPS adapters

•

Fibre channel switch

•

System

•

Cabinet

•

UPS and UPS adapters

•

UPS

•

UPS adapter

•

UPS

•

UPS adapter

206 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing System Power

Powering Off a System/Cabinet/Chassis

Use Functions > Power Off to power off the following components.

Table 63: Effects of Power Off Command on Components

Component

System

Node Cabinet

Disk Cabinet

BYNET Cabinet

Node or VM Node

VMS Chassis

CMIC or VM CMIC

Effect of the Functions > Power Off command:

Powers off all the cabinets in the system, in the following order:

Processing node cabinets after an orderly shutdown of the nodes; if a node does not power off successfully, none of the subsequent cabinets are powered off.

Disk array cabinets.

BYNET cabinets, if present.

Powers off the nodes after an orderly shutdown.

Powers off the disk array chassis.

Powers off the UPSs, which powers off all remaining chassis in cabinet.

Powers off only the selected nodes and VM nodes after an orderly shutdown.

Powers off only the selected VMS chassis after an orderly shutdown. This also powers off the VMs on that VMS.

Powers off only the selected CMICs and VM CMICs after an orderly shutdown.

To Power Off a System, Cabinet, Chassis, or VM

Caution:

Before removing power from a system, cabinet, chassis, or VM, notify users and determine if any applications are running on the nodes. If applications are running, terminate them. Data integrity cannot be ensured unless you shut down all applications before starting a power off.

In the Tree View, with the correct Site ID selected, select the component you want to power off.

Select Functions > Power Off.

When prompted to confirm, click Yes.

If your selection included a nodes, VMS chassis, or VM node, the operating system performs an orderly shutdown and the components are powered off.

To Perform a Hard Power Off on a Node, VM Node, or VMS

Caution:

A hard power off is an immediate drop of power to the node, VM node, or VMS. Database corruption on the nodes may occur. Perform this command only when all other attempts to power off have failed.

Teradata Server Management Web Services User Guide 207

Chapter 9: Servicing, Maintenance, and Troubleshooting

Managing System Power

Performing a hard power off on the VMS also powers off the associated VMs.

In the Tree View, with the correct Site ID selected, select the VMS, or one or more nodes or

VM nodes.

Select Functions > Hard Power Off.

At the warning message, click Yes.

Powering On a System/Cabinet/Chassis

Use Functions > Power On to power on the following components.

Table 64: Effects of Power On Command on Components

Component

System

Node Cabinet

Disk Cabinet

BYNET Cabinet

Node or VM Node

VMS Chassis

CMIC or VM CMIC

Effect of the Functions > Power On command

Powers on all the cabinets in the system, in the following order:

BYNET cabinets, if present

Disk array cabinets

Processing node cabinets

Powers on all chassis except the nodes. Nodes must be powered on individually with the Power On command.

Powers on the disk array chassis

Powers on the UPSs, which powers on remaining chassis

Powers on only the selected nodes and VM modes

Powers on the selected VMS chassis and the associated VMs

Powers on only the selected CMICs and VM CMICs

To Power On a System, Cabinet, Chassis, or VM

In the Tree View, with the correct Site ID selected, select the component you want to power on.

Select Functions > Power On.

When prompted to confirm, click Yes.

Caution:

If a power check fails when a system or cabinet is being powered on, a dialog box allows you to force the command to run. Do not force any command to run until you review the warning in

Forcing a Command to Run after a Power Check Failure

208 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

Recovering from a Power Failure

A power failure occurs when AC power has been lost to one or more cabinets. AC power can be lost for up to 15 seconds without harm. After 15 seconds, an orderly shutdown of the nodes, disk arrays, and BYNET cabinets occurs.

To Recover from a Power Failure to All Cabinets in the System

Note: To recover from an EPO activation, follow the procedure “Restoring Power After an

EPO Event” in the Hardware Service Guide for your platform.

After AC power has been restored, wait for the CMIC to boot.

Start SMWeb, and log on to SMClient.

With the correct Site ID selected, select the system in the Tree View.

Select Functions > Power On.

Verify that system components are operating normally. In SMClient, select the system in the tree and run View > Status. Ensure that all chassis have a green icon indicating operational status is OK. Address any issues for any chassis without a green icon.

When all nodes have booted, the system is ready to begin recovery of any application that was disrupted when power was lost.

Performing Diagnostic Tests

Related Topics

•

UPS Power Cabling Test

•

UPS Self-Test

•

UPS Input Selector Test

UPS Power Cabling Test

The Functions > Power Cable Test command verifies whether the chassis are correctly cabled to the UPSs. The command allows you to troubleshoot cabinet power failure problems. It is recommended that you run the test after system installation and when new components are added to the cabinet.

The Power Cable Test can be run against a single cabinet, a selection of cabinets, or at the system level. If you run the command at the system level, only cabinets containing a UPS are tested. If you select a number of cabinets, and one does not have a UPS, the command is grayed-out.

The Power Cable Test command first checks the status of each UPS and chassis power supply to see if there are problems. If there are no problems, the command runs. If there are problems, the UPSs and power supplies with problems display. You can continue with the test, or cancel.

Teradata Server Management Web Services User Guide 209

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

Next, the CMIC powers off and on each of the load groups on every UPS in the cabinets selected, one at a time. As each load group powers off, the CMIC detects and logs:

•

Any chassis power supply that lost power when it should not have

•

Any chassis power supply that did not lose power when it should have

To Test UPS Power Cabling for a Cabinet

Stop the Teradata Database.

In the Tree View, with the correct Site ID selected, select one or more cabinets to test. To test all cabinets, select the system.

Select Functions > Power Cable Test. The Power Cable Test dialog box displays.

Figure 98: Power Cable Test Dialog Box

210

The confirmation dialog box contains instructions that need to be done manually. These instructions are unique to the cabinet being checked, such as verify the CMIC power supply cabling and check the network switch connections. After you perform those verification steps, click Yes to continue.

If there are no UPS or power supply problems, the power cable test continues. If errors exist, they display on the dialog box. Click Yes to continue the test or No to stop.

Teradata Server Management Web Services User Guide

Figure 99: Power Cable Test with Errors

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

While the test runs, the status displays in Status. All tests are on the same dialog box.

Figure 100: Power Cable Test Command Summary, In Progress

Double-click on a line to see additional details, even if the test is still in progress.

Figure 101 shows a sample detailed Power Cable Test dialog box.

When all the tests are complete, the Summary dialog box displays whether it completed, or completed with errors. All results are summarized on the same dialog box.

Double-click any line in the summary for detailed information. Then click Details for additional data.

Teradata Server Management Web Services User Guide 211

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

Figure 101: Power Cable Test, Details

When the command completes, the Power Cable Test dialog box displays the tests completed, and any errors found. All results are summarized on the same dialog box.

212 Teradata Server Management Web Services User Guide

Figure 102: Power Cable Test, Result Summary

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

Power Cable Test Details Dialog Box

The Power Cable Test dialog box (

Figure 101

) displays the detailed results of the test. See

Table 65

for a description of the fields and dialog box buttons.

Table 65: Power Cable Test Dialog Box Description

Item

Status

Overall Progress

Load Group

Expected

Unexpected

Description

Shows command status as each UPS load group and chassis power supply is tested; lists UPS load group and chassis power supplies that are incorrectly cabled.

Shows the progress of each UPS load group and power supply tested as the command runs.

The default Alias or CIM path for the UPS load group being tested.

If a user-defined Alias exists, it displays instead of the default Alias.

The default Alias or CIM path for the power supply the UPS load group should be cabled to. Correctly cabled power supplies are in green.

If a user-defined Alias exists, it displays instead of the default Alias.

The default Alias or CIM path for the power supply the UPS load group is incorrectly cabled to. Incorrectly cabled power supplies are in red.

If a user-defined Alias exists, it displays instead of the default Alias.

Teradata Server Management Web Services User Guide 213

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing Diagnostic Tests

Table 65: Power Cable Test Dialog Box Description (continued)

Item

Result

Details/No Details button

Cancel button

Description

Shows the results of the power cabling test for each UPS load group and power supply:

•

OK (green): Power supply is correctly cabled.

•

ERROR (red): Power supply is incorrectly cabled.

Toggles between hiding and displaying additional details for the UPS load groups and chassis power supplies being tested

Cancels the command

UPS Self-Test

The Functions > UPS Self Test command checks the functionality of the UPS to determine whether its internal components are working properly. The command runs only if all other power-related components in the cabinet have an operating status of OK. It should be run on only one UPS at a time in a cabinet.

To Run a UPS Self-Test

Caution:

If a power check fails during the UPS self-test, a dialog box displays that allows you to force the

command to run. Do not force any command to run until you review the warning in Forcing a

Command to Run after a Power Check Failure

In the Tree View, with the correct Site ID selected, select a UPS.

Select Functions > UPS Self Test.

Command results, whether the test completed successfully or not, are available in the

Command Summary window. Details about test errors, if any, appear in the Event Viewer and

Alert Viewer.

UPS Input Selector Test

The Functions > UPS Input Selector Test command checks the functionality of the UPS Input

Selector to determine whether it is working properly. The UPS Input Selector Test forces a switch from the default power source to the alternate power source to verify that the switchover capability is functional. The UPS goes on battery for a short time as it transitions between the default and the alternate power source. When the test is complete, the system switches power back to the default power source.

214 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing the Alert Escalation Test

The system does not switch to the alternate power source if the alternate power source is not operating normally. When you run this test, all other power-related components in the cabinet should have an operating status of OK. The test should be run on only one UPS at a time in a cabinet.

Caution:

If a power check fails during UPS input selector test, a dialog box displays that allows you to force the command to run. Do not force any command to run until you review the warning in

Forcing a Command to Run after a Power Check Failure

To Run a UPS Input Selector Test

In the Tree View, with the correct Site ID selected, check the status of the UPS you want to test.

Select the UPS.

Select Functions > UPS Input Selector Test.

Command results, whether the test completed successfully or not, are available in the

Command Summary window. Details about the test, including test errors, if any, appear in the

Event Viewer and Alert Viewer.

Performing the Alert Escalation Test

Alert Escalation tests the full alert detection path on one or more nodes. This is the end-toend path that events and alerts take from managed nodes to the TVI backend. During the test:

•

TAS sends an alert test request (the TVIA DCA FaultTest) to TVIA.

•

The test is logged in the node.

•

The node’s SM3GNode agent sends the log through the event path to the CMIC managing the node.

•

The CMIC managing the node detects the log event as an alert.

•

The alert is sent to Alert Group Detector to be grouped into PSR TEST_FAULT summary alert.

•

TAS sends the summary alert via Axeda to the TVI backend.

Maintenance is ON and Notify is ON, so an incident is not generated, but notification is sent.

To Run the Alert Escalation Test

In the Tree View, with the correct Site ID selected, select one or more nodes, cabinets, collectives, or the system.

Select Event Mgmt > Alert Escalation Test.

Teradata Server Management Web Services User Guide 215

Chapter 9: Servicing, Maintenance, and Troubleshooting

Performing the Alert Escalation Test

The system asks you to verify the components being tested.

Figure 103: Alert Escalation Test Prompt

If the prompt displays the correct components to test, click Yes.

The tests begin on the selected components.

Figure 104: Alert Escalation Test

When the test is complete, the PSR Summary Alert is generated.

Figure 105: Generating the PSR Summary Alert

After the PSR Summary Alert is generated and sent, click OK at the confirmation message.

Figure 106: Alert Escalation Success Message

216 Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Using SMWeb During SOV Failover

When a problem occurs with the SOV CMIC, the CMIC designated as the failover CMIC temporarily assumes the role of the SOV CMIC.

For CMIC failover to occur, the failover CMIC must be identified in the CMIC Configuration.

See the SMWeb Configuration Guide for instructions.

To maintain the same functionality, the failed over CMIC should have the same LAN configuration as the active CMIC. For example, if the SOV CMIC has a customer LAN connection, the failover CMIC should also have a customer LAN connection.

When failover occurs, SMWeb displays a warning message.

Figure 107: SOV Failover Warning

Click the link to continue to the failover CMIC.

The SMWeb Home page reports when a CMIC is in failover. In addition, unavailable options on the Home page are grayed out.

When you start SMClient on the failover CMIC, a warning displays.

Figure 108: SMClient Failover Warning

In addition, the SMClient title bar warns: Connected to failover SOV CMIC.

Teradata Server Management Web Services User Guide 217

Chapter 9: Servicing, Maintenance, and Troubleshooting

Using SMWeb During SOV Failover

When running in failover:

•

Any user-created data created does not migrate back to the original CMIC when it fails back.

•

Configuration changes cannot be made, except to change the Functionality status of the

CMIC. See Changing a Failover CMIC to the Active CMIC .

•

Changes to alert subscriptions are not allowed.

•

Maintenance windows can still be created, updated, and deleted.

•

TVI files (Alerts, Reports, Assets, and Heartbeat) continue to be sent to the TVI backend through the SWS.

•

Alerts matching customer-configured criteria continue to be sent through SNMP trap action, if the failover CMIC is on the customer LAN.

•

From the Home page, the Users and Groups, TVI Connection, and Save and Restore options are not available.

•

If you are running a CLI when failover occurs, a message prompts you to restart the command.

When the original SOV CMIC is restored, SMWeb displays a message.

Figure 109: SOV Failover Warning

218

Click the link to continue to the restored CMIC.

Changing a Failover CMIC to the Active CMIC

If a failed SOV CMIC is expected to be out of service for an extended period (for example, while waiting for a replacement part), you can change the failover CMIC to the active CMIC, which restores full use of SMWeb.

In the Tree View, with the correct Site ID selected, select the failover CMIC.

Select Functions > Manage CMIC.

If prompted, log in.

From the web page of the failover CMIC, select CMIC > System > CMIC Configuration.

Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Marking a Drive as Failed from SMClient

In the CMIC configuration, change the Functionality line from:

To:

Save the file locally using the down arrow button on the toolbar.

Click the Put button on the toolbar to save the configuration to the CMIC.

If the original (failed) CMIC is recovered, duplicate alerts are sent home unless a Maintenance window suppresses escalation. To correct that, change the original (failed) CMIC or the current active SOV CMIC to type “failover.”

Marking a Drive as Failed from SMClient

Occasionally you may want to mark a drive inside a disk enclosure for servicing. For example, you may mark a drive if it is reporting intermittent errors, but the drive is still functional and therefore not in a failed state.

Marking the drive as failed allows the technician to identify the drive quickly and replace it, if needed.

Marking the drive enables the Service Action Required LED on the drive. It does not affect the database, the Amps, or how the drive responds.

Follow the procedures below to mark and unmark a drive from SMClient. The procedure only works on drives in a drive enclosure.

To Mark a Drive as Failed

In the Tree View, with the correct Site ID selected, select the drive.

Select Functions > Set Service Action Required.

The system checks the AMPs, then displays the Set Service Action Required dialog box.

Teradata Server Management Web Services User Guide 219

Chapter 9: Servicing, Maintenance, and Troubleshooting

Marking a Drive as Failed from SMClient

Figure 110: Set Service Action Required Dialog Box

220

Click Yes to continue.

The system reports that the action was successful.

To Clear a Marked Drive

Occasionally, you may decide that a drive no longer needs to be marked. Clearing the state turns off the Service Action Required LED.

Note: Do not clear this status unless you are sure the drive was manually marked. Otherwise you could mask a real error.

In the Tree View, with the correct Site ID selected, select the marked drive. The drive is flagged Service Action Required.

Select Functions > Clear Service Action Required.

The system displays the Clear Service Action Required dialog box.

Teradata Server Management Web Services User Guide

Chapter 9: Servicing, Maintenance, and Troubleshooting

Using SMClient When a Network Is Down

Figure 111: Clear Service Action Required Dialog Box

Click Yes to continue.

The system reports that the action was successful.

Using SMClient When a Network Is Down

When a problem occurs with a network connection, anyone accessing the system is notified that the connection can no longer be made. Because the server management applications do not automatically switch to a working network, you must close and then re-open them on a working network.

Teradata Server Management Web Services User Guide 221

Chapter 9: Servicing, Maintenance, and Troubleshooting

Attaching a Device Temporarily to a Virtual Machine

Attaching a Device Temporarily to a Virtual

Machine

The Attach Temporary Device option in SMClient allows you to temporarily attach a USB or

CD-ROM device to a VM. For example, you may want temporary access to a dump drive.

This option opens a guided procedure.

To Attach a Device Temporarily

In the Tree View, with the correct Site ID selected, expand the cabinet, and select the virtual machine to which you want to attach a device.

You can select the CMIC, the SWS, or the Viewpoint virtual machine.

Select Functions > Attach Temporary Device to display Step 1 of the guided procedure.

Figure 112: Step 1, Attach Temporary Device

222

As instructed, attach the device into the VMS, either by attaching the USB device, or by putting a disk into the CD-ROM drive.

Teradata Server Management Web Services User Guide

Click Next to display Step 2.

Figure 113: Step 2, Attach Temporary Device

Chapter 9: Servicing, Maintenance, and Troubleshooting

Attaching a Device Temporarily to a Virtual Machine

Once the system retrieves the devices, select the device you want to use.

At Attach Option, select Read-write or Read-only, as needed.

Read-write

Read-only

Allows the device to be accessed as a read/write device.

Selecting this option does not make read-only devices writable. It just allows writing to the device, if the device is writable.

The device may require exclusive access (i.e., it cannot be attached to other virtual machines).

Allows read-only access to the device. It allows most devices to be attached to more than one virtual machine.

Teradata Server Management Web Services User Guide 223

Chapter 9: Servicing, Maintenance, and Troubleshooting

Attaching a Device Temporarily to a Virtual Machine

Click Next to display Step 3.

Figure 114: Step 3, Attach Temporary Device

When the procedure reports that the device is available, use it as needed.

When you are done using the device, click Next to detach the device.

Figure 115: Step 4, Attach Temporary Device

224

When the Step 4 reports that the device is detached from the virtual machine, remove the device from the USB port or CD-ROM drive.

Click Close.

Teradata Server Management Web Services User Guide

CHAPTER 10

Command Line Interface Utilities

The SMWeb Command-Line Interface (CLI) provides many of the same commands as

SMClient. The commands can be used in scripts and programs.

Java 1.6 is required to run the CLIs. Run java -version to confirm the Java version.

Related Topics

•

CLI Setup

•

Using the CLI

•

Access to CLI Utilities

CLI Setup

CLI utilities are downloaded from the SMWeb Home page. Once the utilities have been downloaded and set up, they can be run from the command line or in scripts.

Note: You must use the directories specified here if you’re downloading the utilities to the

SWS. Otherwise, these directories are recommended, but not required. If you move the utilities to a new directory, you must run setup again.

To Set Up the CLI in Windows

Display the SMWeb Main page.

Click Command Line Interface for Windows Clients.

When prompted, click Save to save the zip file.

Navigate to \Program Files\teradata\sm, and click Save.

Create the directory if it doesn’t exist.

In a Command window, navigate to the saved zip file.

Unzip the file to the current directory.

The Unzip program creates a new subdirectory called WinCLIs. It then extracts the files into that directory.

In the WinCLIs directory, run setup.bat.

When prompted, enter your SMClient login.

When prompted, enter your SMClient password.

Teradata Server Management Web Services User Guide 225

Chapter 10: Command Line Interface Utilities

Using the CLI

When prompted, enter a pass phrase to encrypt the password file.

The pass phrase must be at least six characters long.

When the prompt returns, enter setup.bat -test to test the connection.

To Set Up the CLI in Linux

Display the SMWeb Main page.

Click Command Line Interface for Linux Clients

When prompted, click Save to save the zip file to your local system.

Navigate to /opt/teradata/sm, and click Save.

Create the directory if it doesn’t exist.

In a shell window, navigate to the saved zip file.

Extract the zip file using the -a option: unzip -a filename.zip

The Unzip program creates a new subdirectory called linuxCLIs. It then extracts the files into that directory.

In the linuxCLIs directory, run chmod +x * to make the files executable.

In the linuxCLIs directory, run ./setup.

When prompted, enter your SMClient login.

When prompted, enter your SMClient password.

When prompted, enter a pass phrase to encrypt the password file.

The pass phrase must be at least six characters long.

When the prompt returns, open a new shell and run setup -test to test the connection.

Note: If you move the CLI utility files, run setup again from the new directory.

Using the CLI

Once set up, the CLI is accessible from a Command window (Windows) or Shell window

(Linux).

Caution:

When you run a CLI utility, the command is executed when you press return. You are not asked for confirmation.

CLI utilities generally rely on a Component ID or alias to identify the component that is being operated upon. The ShowComponents utility allows you to find Component IDs or aliases.

You can also get them through View > Properties in SMClient.

The following general rules apply to all CLI commands:

•

Command names are case-sensitive in Linux, but not in Windows.

226 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities

Using the CLI

•

All commands, except where noted, accept more than one Component ID or alias, separated by commas or spaces. For example, you can power on two cabinets with one command.

•

All options start with either “-” or “/”. Anything else is interpreted as a Component ID or alias.

•

Partial words for options may be typed, as long as enough letters are typed to identify the option. For example,

-r

and

-rec

and

-recursive

all mean the same thing.

Access to CLI Utilities

CLI access is determined by your user group membership. Service Users have access to all CLI utilities. Users and Enhanced Users can access the CLI utilities marked with an asterisk in

Table 66

Table 66: CLI Utilities Access

CLI Utilities

viewmeasurementhistory *

Available to Users and Enhanced Users

Teradata Server Management Web Services User Guide 227

Chapter 10: Command Line Interface Utilities alertutil

alertutil

This command displays alerts retrieved from server management.

Related Topics

•

alertutil Syntax

•

alertutil Options

•

alertutil Time Options

•

alertutil Display Options

•

alertutil Filter Options

•

alertutil SiteID Options

•

alertutil Monitor Options

•

alertutil Examples

alertutil Syntax

alertutil -h[elp] | [components] [timeOptions] [displayOptions] [filterOptions]

[siteIDOptions]

alertutil -id {alertGUID} [-sequence sequencenumber]

alertutil -detail -timeStamp mm/dd/yyyy hh:mm:ss -sequence sequencenumber

alertutil -monitor [monitorOptions] [displayOptions] [filterOptions] [siteIDOptions]

alertutil -summary [components] [timeOptions] [displayOptions] [filterOptions]

[summaryOptions] [siteIDOptions]

alertutil -clear [siteIDOptions] -start mm/dd/yyyy hh:mm:ss -end mm/dd/yyyy hh:mm:ss

alertutil -clear [siteIDOptions] -id alertGUID [-sequence sequencenumber]

alertutil -clear [siteIDOptions] -timeStamp mm/dd/yyyy hh:mm:ss -sequence sequencenumber

alertutil -summary [siteIDOptions]-clear -id alertGUID [-sequence sequenceNumber] [addtositelog msg]

alertutil Options

Option

-h[elp]

-id

{alertGUID}

Description

Displays help for this command.

Displays details for the alert specified by {alertGUID}; using the sequence option speeds up event retrieval.

Unique ID that identifies an alert.

228 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities alertutil

Option

components

-detail

-monitor

-summary

-clear

Description

Unique ID of the components whose alerts you want to display. The unique ID can be a

Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, alerts for the first system display.

Displays details for the specified alert.

Monitors for new alerts coming from server management and display. Press CTRL C to quit.

Displays summary alert information.

Clears specified alerts or alerts between the specified times. Combined with -summary, also clears specified summary alerts.

alertutil Time Options

Option

-start [mm/dd/yyyy] [hh:mm:ss]

-end [mm/dd/yyyy] [hh:mm:ss]

-sec |-min |-hrs |-days x

-desc |-asc

-all

-max x

-sequence sequenceNumber

Description

Selects the start date or time. Default is current date or time 0.

Selects the end date or time. Default is current date or time 23:59:59.

Selects events x seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.

For example:

-start 10/02/2008 -days 2

Displays 2 days of events, starting Oct 2 00:00:00 and ending 2 days later, on Oct 3

23:59:59.

-end 10/15/2008 -days 4

Displays 4 days of events, starting on 10/11/2008 00:00:00 and ending on 10/15/2008

23:59:59.

-days 4

Display events starting 4 days earlier up to current time.

Specifies sort order.

•

Default is descending create time (newest first).

•

Use ascending to sort by create time (oldest first).

Displays all records in the system.

Caution: Operation could be lengthy depending on the size of the system.

Note: If -all or -max is not specified, the default is 1000 records.

Specifies maximum number of records to retrieve.

Note: If -all or -max is not specified, the default is 1000 records.

Adds the time sequence to speed up the alert retrieval.

Teradata Server Management Web Services User Guide 229

Chapter 10: Command Line Interface Utilities alertutil

alertutil Display Options

Option

-verbose

-nohdr

-formNameValue

-perform

-byalias

-csv

-xml

-format filename

-raw

-bycollective

Description

Displays all alert data.

Suppresses display of format header.

Displays in AttributeName=Value format.

Displays statistics such as elapsed time and number of records.

Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.

Saves the information in CSV (comma separated value) format to be viewed in a spreadsheet.

Displays alert information in xml format.

Displays alert information according to the format file filename.

alertutil recognizes the following macros in the format file:

{TimeStamp}, {Sequence}, {Severity}, {Status}, {ManagedElementAlias}, {Description}, {Site

ID}, {SystemID}, {CollectiveID}, {CabinetID}, {ChassisID}, {ManagedElement},

{ObjectClass}, {ID}, {TimeReceived}, {Domain}, {MessageID}, {ReporterType}, {SubType},

{Details}, {RequestID}, {Data}, {RepeatCount}, {RepeatStartTime}, {SubSystem},

{Autosolvable}, {KnowledgeID}, {TrackingID}, {TVI_Disposition}, {Synopsis},

{Maintenance}, {Notify}, {Impact}, {Scope}

Surround brackets with single quotes; represent a true single quote with two single quotes.

For example, {‘This is a sample’} is represented as ‘{‘‘‘This is a sample.’’’}’ in the format file.

Displays alert information retrieved from server management without translation to a more readable format.

Displays alert information grouped by one collective at a time. You cannot use -bycollective if you designate specific components.

alertutil Filter Options

Option

-status={Active | Autosolved | Cleared |

Expired}[,...]

-subSystem={Storage | Power | Node | OS |

Database | Network | ServerMgmt | Client |

Other}[,...]

-TVI_Disposition={ Ignore_Maintenance |

Escalate_Requested | Ignored | Abayed | Escalated |

Ignore_Heartbeat | None}[,...]

Description

Selects alerts with associated statuses.

Selects alerts with associated subsystems.

Selects alerts associated with TVI dispositions.

-subType={ProbableCause | AlertGroup | Null}[,...] Selects alerts with the specified subType names.

-domain=domainName Selects alerts with the specified domain names.

230 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities alertutil

Option

-severity={Unknown | OK | Info | Warning |

Degraded | Critical | Fatal | x-y} [,...]

-msgID=msgID[,...]

-objectClass=objectClassName [,...]

-systemID=systemIDNumber[,...]

-collectiveID=collectiveIDNumber[,...]

-cabinetID=cabinetIDNumber[,...]

-chassisID=chassisIDNumber[,...]

alertutil SiteID Options

Option

-siteID=siteIDName[,...]

-unassignedsiteid

-yes

alertutil Monitor Options

Option

-modification

Description

Selects the first letter of one or more severity names or a range, x to y, between 0 and 6.

Selects alerts with matching MessageIDs.

Selects alerts associated with the object class names. To determine the class name, look at the first part of the component ID.

Example: If the component ID is

CMIC_5500J.SystemID=1,CollectiveID=400,CabinetID=1,ID=6, the class name is CMIC_5500J.

Selects records associated with the system ID numbers.

If you identify multiple system ID numbers, you cannot specify collective IDs, cabinet IDs, or chassis IDs.

Selects records associated with the collective ID numbers.

If you identify multiple collective ID numbers, you cannot specify cabinet IDs or chassis IDs.

Selects records associated with the cabinet ID numbers.

If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.

Selects events associated with the chassis ID numbers.

Description

Selects alerts with associated Site ID. This option is not needed for server management domains that only have one Site ID.

Selects alerts that do not have an associated Site ID.

Override prompt for clearing alerts in a multi-site environment.

Description

Displays alert modifications in addition to new alerts. Use this with the -monitor option to see status and TVI disposition changes.

The following options are not supported: -start, -end, -sec, -min, -hrs, -days, -active, -desc, -asc, seq, -detail, -perform, -nohdr, -csv, and -id.

Teradata Server Management Web Services User Guide 231

Chapter 10: Command Line Interface Utilities alertutil

alertutil Summary Options

Option

-synopsis

-scope

-maintenance={ On |

Off }

-notify={ On | Off }

-impact

Description

Displays summary alerts with matching synopsis.

Displays summary alerts with matching scopes.

Displays summary alerts with specified maintenance settings.

Displays summary alerts with specified notify settings.

Displays summary alerts with matching impacts.

alertutil Examples

•

To list all alerts in a system (without

-all

, the max is 1000 alerts):

alertutil -all

•

To list the first 1,000 alerts in domain for Site ID "PROD1" and components with no assigned Site ID:

alertutil -siteID=PROD1 -unassignedsiteid

•

To list all the active alerts from the Storage subsystem:

alertutil -status=Active -subsystem=Storage

•

To clear all alerts between the start and end dates and times:

alertutil -clear -start 8/29/2008 04:32:22 -end 8/30/2008 04:32:22

•

To clear all alerts between the start and end dates for Site ID “Prod1”:

alertutil -clear -siteID=PROD1 -start 8/29/2008 04:32:22 -end 8/

30/2008 04:32:22

•

To show details of the alert with the matching time stamp and sequence:

alertutil -detail -timeStamp 2009-02-20 08:03:26 -sequence 293849

•

To clear the alert with the matching alert ID and sequence:

alertutil -clear -id {175CC646-8CC3-11d3-84FD-00E029103BC7}

-sequence 293849

•

To list all database related alerts with the TVI disposition of Escalated:

alertutil -subSystem=Database -TVI=Escalated

232 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities alertutil

•

To list all database related alerts with the TVI disposition of Escalated and a severity between 3 and 6:

alertutil -subSystem=Database -TVI=Escalated -sev=3-6

•

To show all alert information for all alerts logged on 8/19/2009:

alertutil -start 8/29/2009 -days 1 -verbose

•

To show information about the alert with the matching alert ID:

alertutil -id {175CC646-8CC3-11d3-84FD-00E029103BC7}

•

To list any alerts for domain BYNET with a severity of Warning or Degraded:

alertutil -dom=bynet -sev=W,D

•

To list any alerts where system ID = 1, cabinet ID=300, and chassis ID=203 or ID=204:

alertutil -sys=1 -cab=300 -chas=203,204

•

To listen for new alerts where system ID = 1, cabinet ID=300, and chassis ID=203 or

ID=204:

alertutil -monitor -sys=1 -cab=300 -chas=203,204

•

To show alert summary information for the most recent 100 summary alerts:

alertutil -summary -max 100

•

To clear the specific summary alert with the matching ID, and add a message to the sitelog.

If the specified ID corresponds to a Root Cause or Situational Cause summary alert, then this option also clears all associated UpdateXXX alerts:

alertutil -clear -id {eb7d1252-60a1-4c8c-aea4-1ee284d9ecfe} summary -addtositelog "User specified message."

•

To list all alerts in the system, one collective at a time:

alertutil -all -bycollective

•

To list all alerts from system 1, collectives 3 through 5, one collective at a time:

alertutil -all -sys=1 -coll=3-5 -bycollective

Teradata Server Management Web Services User Guide 233

Chapter 10: Command Line Interface Utilities assetinfo

assetinfo

This command displays, or outputs to a file, asset information for a specific chassis or for all chassis contained in a system, collective, or cabinet.

Related Topics

•

assetinfo Syntax

•

assetinfo Options

assetinfo Syntax

assetinfo -h[elp] | [-s[iteid] siteid | -un[assignedsiteid]] | [-f [ile] outputFile -c[sv]]

components

assetinfo Options

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

-f [ile] outputFile

-c[sv]

components

Description

Displays help for this command.

Selects assets from the components with the specified Site ID.

Selects assets from components with no assigned Site ID.

Specifies the name of the file to which the chassis asset information will be output.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

Saves the information in CSV (comma-separated value) format to the specified outputFile. The information can then be viewed in a spreadsheet. If this option is not used, the information is saved to a text file.

Unique ID of the system, collective, cabinet, or chassis whose asset information you want to see or save to a file. The unique ID can be a Component ID, default alias, or user-defined alias. To view all the valid components, use the showcomponents command.

234 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities dumpmemory

dumpmemory

This command invokes a memory dump on one or more nodes, VM nodes, CMICs, VM

CMICs, or VMS chassis. Perform this action only when instructed to do so by Teradata technical support personnel. A dump partition must be set up before performing this action.

Command progress displays on the screen.

Caution:

This operation does not perform a graceful shutdown. There is a potential for data loss or corruption when performing this action.

Related Topics

•

dumpmemory Syntax

•

dumpmemory Options

dumpmemory Syntax

dumpmemory -h[elp] | [-s[iteid] siteid | -un[assignedsiteid]] | components

dumpmemory Options

The following table lists the options available for this command:

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

components

Description

Displays help for this command.

Dumps memory from the components with the specified Site ID.

Dumps memory from components with no assigned Site ID.

Unique Component ID, default alias, or user-defined alias of one or more nodes or SMPs.

Teradata Server Management Web Services User Guide 235

Chapter 10: Command Line Interface Utilities measurementinfo

measurementinfo

This command displays, or outputs to a file, measurement information for specific chassis or for all chassis contained in a system, collective, or cabinet.

Related Topics

•

measurementinfo Syntax

•

measurementinfo Options

measurementinfo Syntax

measurementinfo [-h[elp]] | [-s[iteid] siteid | -un[assignedsiteid]] | [-f[ile] outputFile -c[sv]]

components

measurementinfo Options

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

-f [ile] outputFile

-c[sv]

components

Description

Displays help for this command.

Displays measurement information for the components with the specified Site ID.

Displays measurement information for the components with no assigned Site ID.

Specifies the name of the file to output the chassis measurement information.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

Saves the information in CSV (comma separated value) format to the specified outputFile. The information can then be viewed in a spreadsheet. If this option is not used, the information is saved to a text file.

Unique ID of the system, collective, cabinet, or chassis whose measurement information you want to see or save to a file. The unique ID can be a Component ID, default alias, or userdefined alias.

236 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities reset

reset reset Syntax

reset -h[elp] | [-s[iteid] siteid | -un[assignedsiteid]] | <components>

reset Options

This command resets one or more components.

Related Topics

•

reset Syntax

•

reset Options

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

components

Description

Displays help for this command.

Resets only the components with the specified Site ID.

Resets only the components with no assigned Site ID.

Unique ID of the component or components you want to reset. The unique ID can be a

Component ID, default alias, or user-defined alias.

Teradata Server Management Web Services User Guide 237

Chapter 10: Command Line Interface Utilities setbatterydate

setbatterydate

This command sets the battery installation date for all batteries in the system, or for one or more batteries specified by the components option.

Related Topics

•

setbatterydate Syntax

•

setbatterydate Options

•

showbatteries

setbatterydate Syntax

setbatterydate -h[elp]

setbatterydate -d[ate] <installDate> [-s[iteid] siteid | -un[assignedsiteid]] <components>

setbatterydate -d[ate] <installDate> [-s[iteid] siteid | -un[assignedsiteid]] -a[ll]

setbatterydate Options

Option

-h [elp]

Description

Displays help for this command.

-d [ate] <MM/dd/yyyy> The date the battery was installed.

•

Entering one or more components after the installation date applies the date to the specified

components. The components option specifies the unique ID of the battery. The unique ID can be a Component ID, default alias, or user-defined alias.

•

Entering -all after the installation date applies the date to all batteries in the system.

-s [siteid]

-un [assignedsiteid]

Sets battery dates for the components with the specified Site ID.

Sets battery dates for the components with no assigned Site ID.

238 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities setfw

setfw setfw Syntax

setfw -h[elp] | [-s[iteid] siteid | -un[assignedsiteid]] -b[ypass]] <components>

setfw Options

This command downloads firmware for managed components that support this function (for example, CMIC and management boards).

Related Topics

•

setfw Syntax

•

setfw Options

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

-b[ypass]

components

Description

Displays help for this command.

Sets firmware for the components with the specified Site ID.

Sets firmware for the components with no assigned Site ID.

When flashing a UPS management board or adapter, the cabinet’s power subsystem is checked. If a problem is found, a warning message displays. To bypass the power check and flash the UPS management board or adapter anyway, run setfw again using the -b option.

Note: Teradata recommends you correct the condition before flashing the UPS management board or adapter.

Unique ID of the component or components you want to flash. The unique ID can be a

Component ID, default alias, or user-defined alias.

Note: Before flashing the firmware of an APC UPS, you must first flash the firmware of both APC

UPS adapter.

Teradata Server Management Web Services User Guide 239

Chapter 10: Command Line Interface Utilities setpower

setpower

This command powers one or more components on (the default) or off, for managed components that support this.

Related Topics

•

setpower Syntax

•

setpower Options

setpower Syntax

setpower [-h[elp]] | -on | -off | -1 | -0 [-b[ypass]] [-s[iteid] siteid | -un[assignedsiteid]]

<components>

setpower Options

Option

-h [elp]

-on or -1

-off or-0

-b[ypass]

-s [siteid]

-un [assignedsiteid]

components

Description

Displays help for this command.

Powers on the managed component.

Powers off the managed component.

When powering on a cabinet or a system, the cabinet’s power subsystem is checked. If a problem is found, a warning message displays. To bypass the power check and power on the cabinet or system, you must run the SetPower command again using the -b option.

Powers on or off components with the specified Site ID.

Powers on or off components with no assigned Site ID.

Unique ID of the component or components you want to power on or off. The unique ID can be a Component ID, default alias, or user-defined alias.

240 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities showbatteries

showbatteries

This command displays battery installation and battery replacement dates or outputs them to a file.

Related Topics

•

showbatteries Syntax

•

showbatteries Options

showbatteries Syntax

showbatteries [-h[elp]] | [-s[iteid] siteid | -un[assignedsiteid]] [-f [ile] outputFile [-c[sv]]]

showbatteries Options

Option

-h [elp]

-s [siteid]

-un [assignedsiteid]

-f [ile] outputFile

-c[sv]

Description

Displays help for this command.

Displays battery information for the components with the specified Site ID.

Displays battery information for the components with no assigned Site ID.

Specifies the name of the file to which the battery information will be output.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

Teradata Server Management Web Services User Guide 241

Chapter 10: Command Line Interface Utilities showcomponents

showcomponents

This command displays the managed components and their operational status. This command is entered in the following format:

Related Topics

•

showcomponents Syntax

•

showcomponents Options

showcomponents Syntax

showcomponents [-h[elp]] | -r[ecursive] -c[hildren] -n[ame] -i[d] -a[lias] [-s[iteid] siteid | un[assignedsiteid]] [-f[ile] outputFile] [components]

showcomponents Options

Option

-h [elp]

-r[ecursive]

-c[hildren]

-n[ame]

-i[d]

-a[alias]

Description

Displays help for this command.

Shows the operational status of all components contained under the component.

Shows the operational status of the component and only its immediate subcomponents.

Displays the components by the default name displayed in the Tree View.

Displays the components by their Component IDs; this is the default display option if neither -n, -i, or -a is specified.

Displays the components by their aliases; if a user-defined alias exists, it displays instead of the default alias.

-s [siteid] Displays only the components with the specified Site ID.

-un [assignedsiteid] Displays only the components with no assigned Site ID.

-f[ile] outputfile

components

Specifies the name of the file to which the component information will be output.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

Unique ID of the component or components. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, the system components are the default.

242 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities showfirmwareversion

showfirmwareversion

This command displays or outputs all firmware instances in the system. It includes the installed firmware version for each component, the supported firmware version for each component, and reports whether there is a mismatch between them:

•

OK: The firmware version installed is the currently supported version.

•

Mismatch: The firmware version installed is not the currently supported version.

•

Unknown: The firmware version information is missing or unavailable.

Related Topics

•

showfirmwareversion Syntax

•

showfirmwareversion Options

showfirmwareversion Syntax

showfirmwareversion [-h[elp]] | [-a[lias]] [-s[iteid] siteid | -un[assignedsiteid]] [-f[ile]

<outputFile> [-c[sv]]

showfirmwareversion Options

Option

-h[elp]

-a [lias]

-s [siteid]

-un [assignedsiteid]

-f[ile] outputFile

-c[sv]

Output

Displays detailed help for this command.

Displays or saves output using the component alias instead of the Component ID.

Displays firmware information for the components with the specified Site ID.

Displays firmware information for the components with no assigned Site ID.

Specifies the name of the file to which the firmware version information will be output.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

Teradata Server Management Web Services User Guide 243

Chapter 10: Command Line Interface Utilities showproperties

showproperties

This command displays component properties.

Related Topics

•

showproperties Syntax

•

showproperties Options

showproperties Syntax

showproperties [-h[elp]] | [-s[iteid] siteid | -un[assignedsiteid]] [-f [ile] outputfile]

<components>

showproperties Options

Option

-h [elp]

-s [siteid] Displays properties for the components with the specified Site ID.

-un [assignedsiteid] Displays properties for the components with no assigned Site ID.

-f[ile] outputfile

Description

Displays help for this command.

components

Specifies the name of the file to which the property information will be output.

If the full path is not specified, the file is stored in \Document and Settings\<username>

\sm_client_8_0\<host>\userdata in Windows. In Linux, the file is stored in <username>/

sm_client_8_0/<host>/userdata.

If this option is not used, the information is output to the screen.

The unique Component IDs, default aliases, or user-defined aliases of the components.

244 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities showsiteids

showsiteids

This command displays the Site IDs in the server management domain. The command alerts if there are chassis with unassigned Site IDs.

Related Topics

•

showsiteids Syntax

•

showsiteids Options

showsiteids Syntax

showsiteids [sc[ript] | [-h[elp]]

showsiteids Options

Option

-sc[ript]

-h [elp]

smhelp

Description

Output is displays in a script-friendly format.

Displays help for this command.

This command displays a list of the available CLI commands and a brief description of them.

You can display more information about each command, including command format, usage, and options, by typing smhelp command name.

Detailed help for each command can be displayed by typing the command name and the h[elp] argument. Any CLI command name can be used as input to the command.

smhelp Syntax

smhelp

smhelp [-h[elp]] | <command>

smhelp <command>

<command> -h[elp]

Teradata Server Management Web Services User Guide 245

Chapter 10: Command Line Interface Utilities upstest

upstest

This command tests the functionality of either the UPS’s internal components or the UPS

Input Selector.

Related Topics

•

upstest Syntax

•

upstest Options

upstest Syntax

upstest [-h[elp]] | -s[elf] | -i[nput] [-s[iteid] siteid | -un[assignedsiteid]] <components>

upstest Options

The following table lists the options available for this command. Only one option can be used at a time.

Option

-h [elp]

-s [elf]

-i [nput]

Description

Displays help for this command.

Runs the UPS Self-Test and outputs results to the screen. If no option is specified, the UPS Self-Test is run.

Runs the UPS Input Selector Test and outputs the results to the screen; the test forces a switch from the default power source to the alternate power source to verify that the switch-over capability is functional. When the test is complete, the system switches power back to the default power source.

The system does not switch to the alternate power source if it is not operating normally. The command runs only if all other power related components in the cabinet appear normal.

-s [siteid] Tests only components with the specified Site ID.

-un [assignedsiteid] Tests only components with no assigned Site ID.

components

Unique ID of the UPS you want to test. The unique ID can be a Component ID, default alias, or userdefined alias.

246 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewassethistory

viewassethistory

This command displays asset records retrieved from Server Management. It displays (or outputs to a file) asset information for chassis that have asset history. Invoking this command with a system, collective, or cabinet component retrieves asset history for all chassis contained in that system, collective, or cabinet that have asset history.

Related Topics

•

viewassethistory Syntax

•

viewassethistory Options

•

viewassethistory Time Options

•

viewmeasurementhistory Display Options

•

viewassethistory Filter Options

•

viewassethistory Examples

viewassethistory Syntax

viewassethistory -h[elp] | [components] [timeOptions] [displayOptions] [filterOptions]

viewassethistory Options

Option

-h[elp]

components

Description

Displays help for this command.

Unique ID of the component or components whose records you want to display. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, records for the system display.

Components can be at the system, collective, cabinet, or chassis level.

viewassethistory Time Options

Option

-start [mm/dd/yyyy] [hh:mm:ss]

-end [mm/dd/yyyy] [hh:mm:ss]

Description

Selects the start date or time. Default is current date or time 0.

Selects the end date or time. Default is current date or time 23:59:59.

Teradata Server Management Web Services User Guide 247

Chapter 10: Command Line Interface Utilities viewassethistory

Option

-sec |-min |-hrs |-days x

-desc |-asc

-all

-max x

Description

Selects events x seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.

For example:

-start 10/02/2008 -days 2

Displays 2 days of events, starting Oct 2 00:00:00 and ending 2 days later, on Oct 3

23:59:59.

-end 10/15/2008 -days 4

Displays 4 days of events, starting on 10/11/2008 00:00:00 and ending on 10/15/2008

23:59:59.

-days 4

Display events starting 4 days earlier up to current time.

Specifies sort order.

•

Default is descending create time (newest first).

•

Use ascending to sort by create time (oldest first).

Displays all records in the system.

Caution: Operation could be lengthy depending on the size of the system.

Note: If -all or -max is not specified, the default is 1000 records.

Specifies maximum number of records to retrieve.

Note: If -all or -max is not specified, the default is 1000 records.

viewassethistory Display Options

Option

-nohdr

-formNameValue

-perform

-byalias

-csv

-bycollective

Description

Suppresses display of format header.

Displays in AttributeName=Value format.

Displays statistics such as elapsed time and number of records.

Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.

Saves the information in CSV (comma separated value) format to be viewed in a spreadsheet.

Displays alert information grouped by one collective at a time. You cannot use -bycollective if you designate specific components.

248 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewassethistory

viewassethistory Filter Options

Option

-type=chassisType[,...]

-model=modelName[,...]

-assetnames=assetName[,...]

-propunit=propertyUnit[,...]

-propname=propertyName[,...]

-propvalue=propertyValue[,...]

-objectClass=objectClassName[,...]

-systemID=systemIDNumber[,...]

-collectiveID=collectiveIDNumber[,...]

-cabinetID=cabinetIDNumber[,...]

-chassisID=chassisIDNumber[,...]

-siteID=siteIDName[,...]

Description

Selects records with the specified chassis types.

Selects records with the specified model names.

Selects records with the specified asset names.

Selects records with matching property units.

Selects records with matching property names.

Selects records with matching property values.

Selects records associated with the object class names. To determine the class name, look at the first part of the component ID.

Example: If the component ID is

CMIC_5500J.SystemID=1,CollectiveID=400,CabinetID=1,ID=6, the class name is CMIC_5500J.

Selects records associated with the system ID numbers.

If you identify multiple system ID numbers, you cannot specify collective IDs, cabinet IDs, or chassis IDs.

Selects records associated with the collective ID numbers.

If you identify multiple collective ID numbers, you cannot specify cabinet IDs or chassis IDs.

Selects records associated with the cabinet ID numbers.

If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.

Selects events associated with the chassis ID numbers.

Selects events associated with a Site ID. This option is not needed for domains with only one Site ID.

Selects events that do not have an associated Site ID.

-unassignedsiteID

viewassethistory Examples

•

To list all asset records in the system:

viewassethistory -all

•

To list asset records for all records logged on 8/19/2009:

viewassethistory -start 8/19/2009 -days 1

•

To list asset records where property unit value is volts and chassis type is cmic:

viewassethistory -propUnit=volts -type=cmic

Teradata Server Management Web Services User Guide 249

Chapter 10: Command Line Interface Utilities viewassethistory

•

To list asset records where system ID is 1, cabinet ID is 300, and chassis ID type is either

203 or 204:

viewassethistory -sys=1 -cab=300 -chas=203,204

•

To list all asset records in the system, one collective at a time:

viewassethistory -all -bycollective

•

To list all asset records from system 1, collectives 3 through 5, one collective at a time:

viewassethistory -all -sys=1 -coll=3-5 -bycollective

•

To list all asset records where the Site ID is “PROD1” or is unassigned:

viewassethistory -siteid=PROD1 -unassignedsiteid

250 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewevents

viewevents

This command captures a particular time frame of events, retrieves them from the

Consolidated Event Log, and displays them to the screen. To redirect the command output to a text file, type the following after the command: “> myout.txt”. The output file can then be viewed, searched, or printed using a text editor. System problem events can be captured and then forwarded to Customer Services for further analysis.

Related Topics

•

viewevents Syntax

•

viewevents Options

•

viewevents Time Options

•

viewevents Display Options

•

viewevents Filter Options

•

viewevents Monitor Options

•

viewevents Examples

viewevents Syntax

viewevents -h[elp] | [components] [timeOptions] [displayOptions] [filterOptions]

viewevents -monitor [components] [monitorOptions] [filterOptions]

viewevents -id {eventGUID} [-sequence sequencenumber]

viewevents Options

Option

-h[elp]

-id

{eventGUID} components

Description

Displays help for this command.

Displays event details for the event specified by {eventGUID}; using the timesequence option speeds up event retrieval.

Unique ID that identifies an event.

Unique ID of the component or components whose events you want to display. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, events for the system display.

Teradata Server Management Web Services User Guide 251

Chapter 10: Command Line Interface Utilities viewevents

viewevents Time Options

Option Description

-start [mm/dd/yyyy] [hh:mm:ss] Selects start date or time. Default is current date or time 0.

-end [mm/dd/yyyy] [hh:mm:ss]

-sec|-min|-hrs|-days x

-desc|-asc

Selects end date or time. Default is current date or time 23:59:59.

Selects events x seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.

For example:

-start 10/02/2008 -days 2

Displays 2 days of events, starting Oct 2 00:00:00 and ending 2 days later, on Oct 3

23:59:59.

-end 10/15/2008 -days 4

Displays 4 days of events, starting on 10/11/2008 00:00:00 and ending on 10/15/2008

23:59:59.

-days 4

Displays events starting 4 days earlier up to current time.

Specifies sort order.

•

Default is descending time (newest first).

•

Ascending time is oldest first.

-all

-max x

-sequence <sequencenumber>

Displays all events in the system.

Caution: Operation could be lengthy depending on the size of the system.

Note: If -all or -max is not specified, the default is 1000 events.

Specifies maximum number of events to retrieve.

Note: If -all or -max is not specified, the default is 1000 events.

Adding the time sequence number speeds up event retrieval

viewevents Display Options

Option

-detail

-nohdr

-formNameValue

-perform

-byalias

-csv

-xml

Description

Displays detailed event data.

Suppresses display of format header.

Displays in AttributeName=Value format.

Displays statistics such as elapsed time and number of records.

Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.

Saves the information in CSV (comma separated value) format to be viewed in a spreadsheet.

Displays alert information in xml format.

252 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewevents

Option

-format filename

-bycollective

Description

Displays event information according to the format file filename.

viewevents recognizes the following macros in the format file:

{eventGUID}, {TimeStamp}, {TimeReceived}, {Sequence}, {ObjectPath}, {Severity},

{ReporterType}, {SubType}, {Source}, {MessageId}, {Description}, {Details}, {BinaryData},

{Domain}, {ManagedElementAlias}, {SystemID}, {CollectiveID}, {CabinetID}, {ChassisID}

Surround brackets with single quotes; represent a true single quote with two single quotes.

For example, {‘This is a sample’} is represented as ‘{‘‘‘This is a sample.’’’}’ in the format file.

Displays event information grouped by one collective at a time. You cannot use -bycollective if you designate specific components.

viewevents Filter Options

Option Description

-reporterType={MPP_StatusEvent |

MPP_ConfigChangeEvent | MPP_CommandEvent |

MPP_SnmpTrap | MPP_BynetDPEvent |

MPP_ApplicationEvent | MPP_Alert |

MPP_WinLog | MPP_UNIXLog | MPP_DeviceLog |

MPP_SiteActivity} [,.]

-subType=subTypeName[,...]

-domain=domainName

-severity={Unknown | OK | Info | Warning |

Degraded | Critical | Fatal | x-y} [,.]

Selects event reporter types.

Selects events with the specified subType names.

Selects events associated with domain names.

Selects the first letter of one or more severity names or a range, x to y, between 0 and 6.

Selects one or more events with matching MessageIDs.

-msgID=msgID[,.]

-objectClass=objectClassName [,.]

-systemID=systemIDName [,.]

-collectiveID=collectiveIDName [,.]

-cabinetID=cabinetIDName [,.]

-chassisID=chassisIDName

Selects one or more events associated with objectClassNames.

The classname is determined by looking at the first part of the component ID.

Selects one or more events associated with systemIDNames. *

Selects one or more events associated with collectiveIDs. *

Selects one or more events associated with cabinetIDNames. *

Selects events associated with chassisIDNames. *

-siteID=siteIDName[,...] Selects events associated with a Site ID. This option is not needed for domains with only one Site ID.

Selects events without an associated Site ID.

-unassignedsiteID

* Note: If a system, collective, cabinet, or chassis has more than one component, you cannot specify any further granularity.

For example, ViewEvents -sys=1 -coll=200 -cab=1,2,3 is valid, ViewEvents -sys=1 -coll=200, 300 is valid, but ViewEvents -

sys=1 -coll=200,300 -cab=1 is not valid.

Teradata Server Management Web Services User Guide 253

Chapter 10: Command Line Interface Utilities viewevents

viewevents Monitor Options

Option

-monitor

Description

Monitors the database for new events and displays them. The following options are not supported: -start, -end, -sec, -min, -hrs, -days, -active, -desc, -asc, -seq, -detail, -perform, and -id.

To exit the command, enter ctrl+C.

Refresh rate in seconds; use with -monitor. The default is 10 seconds; the minimum is 5 seconds.

-refreshRate x

viewevents Examples

•

To list all events in a system:

viewevents

•

To show event details for all events logged on 8/19/2009:

viewevents -start 8/19/2009 -days 1 -detail

•

To show event details for a specific event with a matching event ID:

viewevents -id {175CC646-8CC3-11d3-84FD-00E029103BC7}

•

To list events with a reporter type of MPP_WinLog, a severity of Warning or Degraded, and domain of Node:

viewevents -rep=MPP_WinLog -dom=node -sev=W,D

•

To list events where systetmID=1 or systemID=2, cabinetID=300, and chassisID=203 or chassisID=204:

viewevents -sys=1 -cab=300 -chas=203,204

•

To listen for new events:

viewevents -monitor

•

To list all events in the system, one collective at a time:

viewevents -all -bycollective

•

To list all events from system 1, collectives 3 through 5, one collective at a time:

viewevents -all -sys=1 -coll=3-5 -bycollective

•

To list all events where the Site ID is “PROD1” or is unassigned:

viewevents -siteid=PROD1 -unassignedsiteid

254 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewmeasurementhistory

viewmeasurementhistory

This command displays measurement records retrieved from server management. It displays

(or outputs to a file) measurement information for chassis that have measurement history.

Invoking this command with a system, collective, or cabinet component retrieves measurement history for all chassis contained in that system, collective, or cabinet that have measurement history.

Related Topics

•

viewmeasurementhistory Syntax

•

viewmeasurementhistory Options

•

viewmeasurementhistory Time Options

•

viewmeasurementhistory Display Options

•

viewmeasurementhistory Filter Options

•

viewmeasurementhistory Examples

viewmeasurementhistory Syntax

viewmeasurementhistory -h[elp] | [components] [timeOptions] [displayOptions]

[filterOptions]

viewmeasurementhistory Options

Option

-h[elp]

components

Description

Displays help for this command.

Unique ID of the component or components whose history records you want to display. The unique ID can be a Component ID, default alias, or user-defined alias. If no Component IDs or aliases are specified, records for the system display.

Components can be at the system, collective, cabinet, or chassis level.

viewmeasurementhistory Time Options

Option

-start [mm/dd/yyyy] [hh:mm:ss]

-end [mm/dd/yyyy] [hh:mm:ss]

Description

Selects start date or time. Default is current date or time 0.

Selects end date or time. Default is current date or time 23:59:59.

Teradata Server Management Web Services User Guide 255

Chapter 10: Command Line Interface Utilities viewmeasurementhistory

Option

-sec |-min |-hrs |-days x

-desc |-asc

-all

-max x

Description

Selects events x seconds, minutes, hours, or days since the start time or before the end time; if -start or -end is not specified, the default is since current time.

For example:

-start 10/02/2008 -days 2

Displays 2 days of events, starting Oct 2 00:00:00 and ending 2 days later, on Oct 3

23:59:59.

-end 10/15/2008 -days 4

Displays 4 days of events, starting on 10/11/2008 00:00:00 and ending on 10/15/

2008 23:59:59.

-days 4

Displays events starting 4 days earlier up to current time.

Specifies sort order.

•

Default is descending create time (newest first).

•

Use ascending to sort by create time (oldest first).

Displays all events in the system.

Caution: Operation could be lengthy depending on the size of the system.

Note: If -all or -max is not specified, the default is 1000 records.

Specifies maximum number of events to retrieve.

Note: If -all or -max is not specified, the default is 1000 records.

viewmeasurementhistory Display Options

Option

-nohdr

-formNameValue

-perform

-byalias

-csv

-bycollective

Description

Suppresses display of format header.

Displays in AttributeName=Value format.

Displays statistics such as elapsed time and number of records.

Displays output using the component alias instead of the ObjectPath. If a user-defined alias has been configured, it displays.

Saves the information in CSV (comma separated value) format to be viewed in a spreadsheet.

Displays measurement information grouped by one collective at a time. You cannot use bycollective if you designate specific components.

viewmeasurementhistory Filter Options

Option

-type=chassisType[,...]

Description

Selects records with the specified chassis types.

256 Teradata Server Management Web Services User Guide

Chapter 10: Command Line Interface Utilities viewmeasurementhistory

Option

-model=modelName[,...]

-propunit=propertyUnit[,...]

-propname=propertyName[,...]

-propvalue=propertyValue[,...]

-objectClass=objectClassName[,...]

-systemID=systemIDNumber[,...]

-collectiveID=collectiveIDNumber[,...]

-cabinetID=cabinetIDNumber[,...]

-chassisID=chassisIDNumber[,...]

-siteID=siteIDName[,...]

Description

Selects records with the specified model names.

Selects records with matching property units.

Selects records with matching property names.

Selects records with matching property values.

Selects records associated with the object class names. To determine the class name, look at the first part of the component ID.

Example: If the component ID is

CMIC_5500J.SystemID=1,CollectiveID=400,CabinetID=1,ID=6, the class name is CMIC_5500J.

Selects records associated with the system ID numbers.

If you identify multiple system ID numbers, you cannot specify collective

IDs, cabinet IDs, or chassis IDs.

Selects records associated with the collective ID numbers.

If you identify multiple collective ID numbers, you cannot specify cabinet

IDs or chassis IDs.

Selects records associated with the cabinet ID numbers.

If you identify multiple cabinet ID numbers, you cannot specify chassis IDs.

Selects events associated with the chassis ID numbers.

Selects events associated with a Site ID. This option is not needed for domains with only one Site ID.

Selects events that do not have an associated Site ID.

-unassignedsiteID

viewmeasurementhistory Examples

•

To list all measurement records in the system:

viewmeasurementhistory -all

•

To list measurement records for all records logged on 8/19/2009:

viewmeasurementhistory -start 8/19/2009 -days 1

•

To list measurement records where property unit value is volts and chassis type is cmic:

viewmeasurementhistory -propUnit=volts -type=cmic

•

To list measurement records where system ID is 1, cabinet ID is 300, and chassis ID type is either 203 or 204:

viewmeasurementhistory -sys=1 -cab=300 -chas=203,204

Teradata Server Management Web Services User Guide 257

Chapter 10: Command Line Interface Utilities viewmeasurementhistory

•

To list all measurement records in the system, one collective at a time:

viewmeasurementhistory -all -bycollective

•

To list all measurement records from system 1, collectives 3 through 5, one collective at a time:

viewmeasurementhistory -all -sys=1 -coll=3-5 -bycollective

•

To list all measurement records where the Site ID is “PROD1” or is unassigned:

viewassethistory -siteid=PROD1 -unassignedsiteid

258 Teradata Server Management Web Services User Guide

Index

accessing

commands based on groups 40

adding

entries to address book 173

address book

adding entries 173

backing up and restoring 177

connecting to components 170

displaying 172

editing entries 176

organizing and managing entries 174 saving connections 174

working with 171

alert escalation test

Alert Viewer

locating component 85

options 80

pausing and restarting 86

rearranging columns 85 saving contents 85

viewing details 87

alert viewer

about 52

Alert Viewer Options dialog box 80

alerts

clearing on Alert Viewer 90

clearing summary alert bundle 75

definition 51

displaying in CLI 228

displaying on Summary Viewer 71

displaying on Viewer 78

grouping 86

in Alert Viewer 82

in Summary Alert Viewer 72

key alerts 81

locating component 85

notification 53

Teradata Server Management Web Services User Guide

responding to 54

searching for 85

setting display options 81

setting summary viewer display options 71

severity 51

severity indicators 52

view options 80

viewing details 87

viewing details from Summary Alert Viewer 76

AlertUtil command 55, 228

aliases

autogenerating 33 configuring 33

for component names 30

All Cabinets command 92

Asset Database 103, 113

asset history

displaying 106

View Asset History window 107

asset information

Asset Information View window 104

baseline 110

displaying 103

displaying in CLI 234

tracking 103

Asset Information command 103

Asset Information View window 104

AssetInfo command 234

assets

viewing in CLI 247

attaching a device to a VM 222

authentication

on SSH server 156

AWS

migrating to SMWeb 22

backing up

baselines

batteries

changing installation dates 199

setting installation date 238

259

Index

showing dates in CLI 241

browsers

to run SMWeb 22

cabinet

Cabinet Window commands 26

names 30 numbering 30

powering off 207

powering on 208

status 46

Cabinet Window menu 91

Cabinet Windows

setting display options 93, 95

chassis

Chassis Layout View command 99

names 30 numbering 30

powering off 207

powering on 208

checking

clearing

Client Connections Window 148, 160

closing 160

Connect tab 151

display options 167, 169

displaying 160

options 168

saving connections to address book 174

closing

260

Cabinet Windows 98

terminal window connections 165

CMIC

connecting to 141

health check 57

status 56

CMIC Measurement Database 113, 120

collapsing

Tree View 28

Collective Management View command 26

Collective Management window 56

collectives

changing in Alert Viewer 85

names 30 numbering 30

columns

changing in Event Viewer 65

Command Line Interface

access 227

setting up 225

using 226

commands

forcing after Power Check failure 206

selecting multiple components 42, 43

SMClient 38

viewing results 41

component IDs 30

components

changing display name 32

checking operational state 46

configuring aliases 33

connecting 148

connecting from address book 170

connecting in Tree View 142

connecting to 141

FRU Replace Procedure window 191