Sun Logo


Configuration and Service Tracker, version 3.5

817-0706-02



Table of Contents

Preface Preface-1

How This Book is Organized Preface-1

Using UNIX Commands Preface-2

Accessing Sun Documentation Online Preface-2

Accessible CST Documentation Preface-2

Sun Welcomes Your Comments Preface-3

Product Description

Introduction

CST Features

Tracking and Recording Events

Tracking Configuration

Collecting Hardware FRU Information

Viewing Events and Configuration Information

Benefits of CST for System Administration

CST Architecture

CST Server

CST Agent

CST Repository

CST User Interface

CST Applet

CST Interface to Sun Management Center

CST Console in Sun Management Center Environment

Application Tracking Modules

Supported Systems

CST on Multi-Domain Systems

CST on Sun Enterprise 10000

CST on Sun Fire Platforms

Sun Fire 15K and 12K

Sun Fire 3800, 4800, 4810, 6800

CST on Clusters

Cluster Platform Hierarchy

CST on Volume Manager Systems

Tracking Sun Java System Software Applications

Custom Event Application Programming Interface (API)

Data Feed to Sun

SRS Net Connect

Secure email

Installing CST

Introduction

Installation Package Disk Space Requirements

Supported Install Options

During OS Upgrades

CST Server Installation

CST Server Requirements

To Prepare for CST Server Installation

To Install CST Server for the First Time

To Upgrade CST Server

CST Agent Installation

To Prepare for CST Agent Installation

To Prepare for Agent Installation in Live Upgrade or Multi-boot Environment

To Install CST Agent for the First Time

To Attach an Agent to the CST Server

To Upgrade CST Agent

Steps

To Reinstall CST Agent After OS Upgrade

Steps

To Install CST Agent Component on a Multi-domain Server

Installing CST on a Sun Cluster

To Attach a Multi-domain Agent to CST Server

cstattach on the Domains

cstattach on Sun Firetrademark 15K System Controller

cstattach on an E10K System Service Processor (SSP)

To Verify Installation

Steps to Verify Installation

CST Software in the Sun Management Center Environment

To Prepare for CST Installation in Sun Management Center Environment

To Install CST in Sun Management Center Environment

To Upgrade CST in Sun Management Center Environment

CST Software Uninstall

To Uninstall CST 3.5 Software

Decommissioning CST

Getting Started

Introduction

Login Authentication

Starting the CST Applet

To Start the CST Applet

Logging Out

Starting CST in Sun Management Center

To Start the Sun Management Center Console

Creating Objects in Sun Management Center

To Create a Single Object in Sun Management Center

To Create a Composite Node in Sun Management Center

Starting the CST Console in Sun Management Center

To Start the CST Console in Sun Management Center

CST Features and Functions

Console Views

Screen Sections Overview

Summary Section

Site Information

To Specify Site Info

Customer Contact Info

Sun Contact Info

Registration Info

To Specify Customer Contact Information

Cause Code Assignment

To Globally Assign a Cause Code

Custom Info

To Define Custom Fields

Steps

To Record Custom Information

Steps

Status Display Panel

Enterprise Hierarchy Panel

History Folder

To View Different Events

To Assign an Event Cause Code

To Globally Assign a Cause Code

To Add Comments to an Event

To Create a Service Event

To Look Up Configuration Changes

Configurations Folder

Application Folder

To View Application Information

Statistics Folder

System Statistics

Application Statistics

Notification Folder

To Add a New Email to Event-list Mapping

To Delete an Email from Event-list Mapping

To Modify an Email to Event-list Mapping

Print Folder

To Specify a History Report

To Specify a Configuration Report

To Print or Email a Report

CST Administration

User and Group Management

CST Access Control List (ACL)

To Create a cstadm or cstops Group

To Become a cstadm or cstops User

Access Control in the Sun Management Center Framework

To Set CST Access Levels

Site Registration

To Prepare for Registration

To Fulfill Registration Prerequisites

To Submit Registration

To Complete Registration

Network Protocols

To Set Network Transport Between Agent and Server

To Set Network Transport Between Server and Client

Tuning CST Trigger Intervals

To Tune CST Event Detectors

CST Detach

CST Tracking During OS Upgrades

Managing Hierarchy

To Move Agent Data to a Different Hierarchy

Service and Cause Code Updates

CST Utilities

cstattach

Name

Description

Support Platforms

Checklist

Usage

Examples

Example 1

Example 2

Example 3

Example 4

cstattagt

Name

Description

Support Platforms

Checklist

Usage

Example 1

Example 2

cstfind

Name

Synopsis

Description

Options

Examples

Example 1

Example 2

Example 3

Example 4

Exit Status

findevent

Name

Description

Supported Platforms

Usage

EVENT_TYPE (Default is "any")

PERIOD

WEEKDAY

TIMESTART and TIMEEND

FORMAT

HIERARCHY

RULEFILE

Option

Usage Examples

cstlshost

Name

Synopsis

Description

Options

-f field name

-i inputfile

-o outputfile

Examples

Example 1

Example 2

Example 3

Exit Status

setcause

Name

Synopsis

Supported CST Releases

Features

Usage 1

Usage 2

PERIOD

RULEFILE

Set Cause Code Procedure (Usage 1)

Set Cause Code Procedure (Usage 2)

app_event

Name

Synopsis

Availability

Description

Operands

event-type

comment

Exit Status

Examples

Files

addsunfire

Name

Description

Supported Sun Fire Platforms

Inputs

Format

Usage Examples

Example 1

Exit Status

cstdecomm

Name

Synopsis

Description

Parameters

-t mm/dd/yyyy hh:mm:ss

-h hierarchy

Support Platforms

Examples

Nodes with Hierarchy

Nodes with no Hierarchy

Notes

Multi-domain/Node Systems

Examples of Usage

Troubleshooting CST

Error Messages

CST Launch Error in Sun Management Center Environment

Wrong Component (Agent vs Server) Selected During Install

CST Package Install Fails - Repository is a Sub-folder in /var/opt/SUNWcst

Error in Compiling Statistics

Site Registration Fails With Customer ID and Key

Cannot View FRUI Data on SF15K SC

Missing FRU Data for Mid-frame Sun Fire System Controllers

CST Platform Data Missing on Sun Fire 15K Main SC

CST Interface Reference

Index