Sun Microsystems, Inc.  Sun System Handbook - ISO 3.4 June 2011 Internal/Partner Edition
   Home | Current Systems | Former STK Products | EOL Systems | Components | General Info | Search | Feedback

Asset ID: 1-71-1003867.1
Update Date:2011-03-14
Keywords:

Solution Type  Technical Instruction Sure

Solution  1003867.1 :   Memory DIMM Replacement Management Tool - cediag FAQ  


Related Items
  • Sun Enterprise 4500 Server
  •  
  • Sun Fire E6900 Server
  •  
  • Sun Fire V480 Server
  •  
  • Sun Enterprise 5500 Server
  •  
  • Sun Fire E25K Server
  •  
  • Sun Enterprise 450 Server
  •  
  • Sun Fire 280R Server
  •  
  • Sun Fire 6800 Server
  •  
  • Sun Enterprise 3500 Server
  •  
  • Sun Fire 3800 Server
  •  
  • Sun Ultra 2 Workstation
  •  
  • Sun Ultra 30 Workstation
  •  
  • Sun Ultra 80 Workstation
  •  
  • Sun Netra T1400 Server
  •  
  • Sun Fire V890 Server
  •  
  • Sun Enterprise 6500 Server
  •  
  • Sun Fire E4900 Server
  •  
  • Sun Enterprise 220R Server
  •  
  • Sun Netra 120 Server
  •  
  • Sun Fire V880 Server
  •  
  • Sun Fire 4800 Server
  •  
  • Sun Enterprise 250 Server
  •  
  • Sun Fire V1280 Server
  •  
  • Sun Fire E2900 Server
  •  
  • Sun Fire 15K Server
  •  
  • Sun Ultra 60 Workstation
  •  
  • Sun Fire V490 Server
  •  
  • Sun Blade 1000 Workstation
  •  
  • Sun Enterprise 10000 Server
  •  
  • Sun Enterprise 420R Server
  •  
Related Categories
  • GCS>Sun Microsystems>Boards>Memory Module
  •  
  • GCS>Sun Microsystems>Servers>Entry-Level Servers
  •  
  • GCS>Sun Microsystems>Servers>High-End Servers
  •  
  • GCS>Sun Microsystems>Servers>Midrange Servers
  •  
  • GCS>Sun Microsystems>Desktops>Workstations
  •  
  • GCS>Sun Microsystems>Servers>NEBS-Certified Servers
  •  

PreviouslyPublishedAs
205430


Applies to:

Sun Ultra 2 Workstation
Sun Blade 1000 Workstation
Sun Ultra 30 Workstation
Sun Ultra 80 Workstation
All Platforms

Goal

Description
This link redirects to the cediag download page in the Sun Download Center.

Download cediag

  • Click here for 32-bit OS available via <Patch:10314646>
  • Click here for 64-bit OS available via <Patch:10314680>

Solution

FAQ's and Troubleshooting Steps

Frequently Asked Questions

1. What is cediag 

cediag is a memory error analysis tool, comprised of shell scripts and a few binary executables.

Back to Index

2. Why was cediag developed  

cediag was developed to aid the diagnosis of correctable memory errors, keeping to the Sun Ehanced Memory DIMM Replacement Policy.  For more information regarding this policy, please refer to Document 1010905.1.

Back to Index

3. What architecture/machines does cediag run on 

cediag currently runs on Solaris[TM] SPARC(R) architectures only.

Back to Index

4. How do I get cediag 

cediag is distributed on My Oracle Support on the Patches & Updates tab.

Direct links to the patch containing the cediag packages is:
  • <Patch:10314646>  (32-bit OS)
  • <Patch:10314680>  (64-bit OS)

Back to Index

5. How do I install cediag 

    1. Create a directory for the packages. (e.g. /var/tmp/cediag)
    2. Download the correct version of cediag via <Patch:10314646> (32-bit OS) or <Patch:10314680> (64-bit OS).
    3. Unpack the file and then execute zcat cediag.tar.Z | tar -xf -
    4. Be sure to read the README file.
    5. Install the packages using pkgadd -d .
    6. When prompted to automate cediag execution in cron and output to /var/adm/messages file, answer "Y".
    Do you wish to schedule cediag in cron? [y,n,?,q] y
    7. Update your PATH. e.g. PATH=$PATH:/opt/SUNWcest/bin
    8. Update your MANPATH. e.g. MANPATH=$MANPATH:/opt/SUNWcest/man
    9. View the man pages. e.g. man cediag
    10. Execute cediag interactively, the first time, to acknowledge licence agreement.
    e.g., /opt/SUNWcest/bin/cediag

This will extract the contents of the archive into two directories called SUNWcest and SUNWcestx located in the current directory.

Be sure to read the README file.

As root,

# pkgadd -d . SUNWcest SUNWcestx

Back to Index

6. Where are cediag's man pages 

cediag's man pages are located in <-cediag_install_dir->/man. To view the man pages, use the following commands:

man -M <-cediag_install_dir->/man cediag
man -M <-cediag_install_dir->/man cestat
man -M <-cediag_install_dir->/man zerocecnt

Back to Index

7. Do I have to delete and re-install the SUNWcest and SUNWcestx packages in order to update cediag to the latest version 

Yes, use the command: "pkgrm SUNWcestx SUNWcest" as root and remove the currently installed cediag package before attempting to install a new version.

Back to Index

8. Can I set up cediag to run daily 

Yes. In fact, the installation of cediag will automatically create a root crontab entry to run cediag nightly at midnight if you answer "y" when asked "Do you wish to schedule cediag in cron "

Back to Index

9. What scripts/commands does cediag run 

On some versions of Solaris[TM], cediag uses cestat to probe the kernel for memory statistics. In all cases, cediag scans the messages files on the system to analyze memory errors.

More information can be found in the cediag and cestat man pages.

Back to Index



For the latest information on the Oracle Enhanced Memory DIMM Replacement Policy, see:
This document is current as of January 13, 2010: Document 1010905.1 Oracle Enhanced Memory DIMM Replacement Policy

Internal Comments
For Sun internal use only

Cediag Tool Support
To get support for cediag or the SPARC Memory DIMM Replacement Policy
collaborate with the next level of technical support for the hardware
platform group that is involved.


Cediag Tool - Non-Root User Installation Instructions

cediag(1M) can be run by a non-root user in both "live" mode (where cediag(1M)
is analyzing the very system on which it is running) and in "offline" mode
(where it is analyzing either an explorer or a set of /var/adm/messages files).

When run by a non-root user in "live" mode, cediag(1M) cannot take advantage
of cestat(1M) to significantly improve its performance. cediag(1M) prints a
warning message to this effect.

$ ./cediag

cediag: please install 'SUNWcest' package to allow access to 'cestat' data
cediag: Revision: 1.94 @ 2007/07/26 22:55:08 UTC
cediag: Analysed System: SunOS 5.9 with KUP 117171-05 (MPR enabled)
cediag: findings: 0 UE(s) found - there is no rule#3 match
cediag: findings: 0 DIMMs with a failure pattern matching rule#4
cediag: findings: 0 DIMMs with a failure pattern matching rule#5


The following is one example of how to install cediag(1M) as a non-root user.
It is assumed that the user has already downloaded the cediag.tar.Z file.
$ ls

cediag.tar.Z
$ pwd
/var/tmp/cediag
$ zcat cediag.tar.Z | tar xf -
$ mkdir SUNWcest/reloc/opt/SUNWcest/bin/sparcv9
$ cp SUNWcestx/reloc/opt/SUNWcest/bin/sparcv9/cestat SUNWcest/reloc/opt/SUNWcest/bin/sparcv9
$ cd SUNWcest/reloc/opt/SUNWcest/bin
$ ln cestat zerocecnt
$ cd sparcv9
$ ln cestat zerocecnt
$ cd ../sparcv7
$ ln cestat zerocecnt
$ PATH=$PATH:/var/tmp/cediag/SUNWcest/reloc/opt/SUNWcest/bin
$ MANPATH=$PATH:/var/tmp/cediag/SUNWcest/reloc/opt/SUNWcest/man
$ type cediag
cediag is /var/tmp/cediag/SUNWcest/reloc/opt/SUNWcest/bin/cediag
$ cediag
cediag: please install a [M]emory [P]age [R]etirement Kernel Update Patch
cediag: SunOS 5.8 requires 108528-24 (or higher) installed for MPR support
cediag: Revision: 1.94 @ 2007/07/26 22:55:08 UTC
cediag: #### CE Summary since last detected reboot ###########################
cediag: findings: 0 UE(s) found - there is no rule#3 match
cediag: findings: 0 DIMMs with a failure pattern matching rule#4
cediag: findings: 0 DIMMs with a failure pattern matching rule#6
$

OR, for a root user maintaining one of the CCC tool shares, they
might do something like this:
# ls

README SUNWcest SUNWcestx cediag.tar.Z
# pwd
/var/tmp/cediag
# mkdir ../cediag_share
# pkgadd -d . -R /var/tmp/cediag_share

The following packages are available:
1 SUNWcest DIMM Management and Correctable Error DIMM Statistics
(sparc) 1.3.2,REV=0.0.0
2 SUNWcestx DIMM Management and Correctable Error DIMM Statistics (64 bit)
(sparc) 1.3.2,REV=0.0.0

Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]:

Processing package instance from

DIMM Management and Correctable Error DIMM Statistics
(sparc) 1.3.2,REV=0.0.0

Copyright 2007 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
Using as the package base directory.

It is strongly recommended that cediag(1M) be run on a daily basis. This
installation will place an entry in the root user crontab file which will run
cediag at midnight every night.

Do you wish to schedule cediag in cron? [y,n,?,q] y


## Processing package information.
## Processing system information.
## Verifying package dependencies.
WARNING:
The package "Core Architecture, (Root)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Architecture, (Kvm)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris, (Root)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris, (Usr)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris Devices" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris Libraries" is a
prerequisite package and should be installed.

Do you want to continue with the installation of [y,n,?] y
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.

The following files are already installed on the system and are being
used by another package:
* /var/tmp/cediag_share/var

* - conflict with a file which does not belong to any package.

Do you want to install these conflicting files [y,n,?,q] y
## Checking for setuid/setgid programs.

This package contains scripts which will be executed with super-user
permission during the process of installing this package.

Do you want to continue with the installation of [y,n,?] y

Installing DIMM Management and Correctable Error DIMM Statistics as

## Installing part 1 of 1.
/var/tmp/cediag_share/opt/SUNWcest/bin/cediag
/var/tmp/cediag_share/opt/SUNWcest/bin/cestat
/var/tmp/cediag_share//opt/SUNWcest/bin/perl
/var/tmp/cediag_share/opt/SUNWcest/bin/sparcv7/cestat
/var/tmp/cediag_share/opt/SUNWcest/man/sman1m/cediag.1m
/var/tmp/cediag_share/opt/SUNWcest/man/sman1m/cestat.1m
/var/tmp/cediag_share/opt/SUNWcest/man/sman1m/zerocecnt.1m
[ verifying class ]
/var/tmp/cediag_share/opt/SUNWcest/bin/sparcv7/zerocecnt
/var/tmp/cediag_share/opt/SUNWcest/bin/zerocecnt
## Executing postinstall script.

REMINDER: Be sure to run cediag(1M) manually after installation as it
cannot be run by automated tools such as cron(1M) and explorer until
the license for cediag(1M) has been accepted.


Installation of was successful.

Processing package instance from

DIMM Management and Correctable Error DIMM Statistics (64 bit)
(sparc) 1.3.2,REV=0.0.0
Copyright 2007 Sun Microsystems, Inc. All rights reserved.
Use is subject to license terms.
Using as the package base directory.
## Processing package information.
## Processing system information.
3 package pathnames are already properly installed.
## Verifying package dependencies.
WARNING:
The package "Core Architecture, (Root)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Architecture, (Kvm)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris, (Root)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris, (Usr)" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris Devices" is a
prerequisite package and should be installed.
WARNING:
The package "Core Solaris Libraries" is a
prerequisite package and should be installed.

Do you want to continue with the installation of [y,n,?] y
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.

Installing DIMM Management and Correctable Error DIMM Statistics (64 bit) as

## Installing part 1 of 1.
/var/tmp/cediag_share/opt/SUNWcest/bin/sparcv9/cestat
[ verifying class ]
/var/tmp/cediag_share/opt/SUNWcest/bin/sparcv9/zerocecnt

Installation of was successful.

The following packages are available:
1 SUNWcest DIMM Management and Correctable Error DIMM Statistics
(sparc) 1.3.2,REV=0.0.0
2 SUNWcestx DIMM Management and Correctable Error DIMM Statistics (64 bit)
(sparc) 1.3.2,REV=0.0.0

Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q


# cd /var/tmp/cediag_share/opt/SUNWcest/bin
# PATH=$PATH:`pwd`
# cd ../man
# MANPATH=$MANPATH:`pwd`
# type cediag
cediag is /var/tmp/cediag_share/opt/SUNWcest/bin/cediag


# /var/tmp/cediag_share/opt/SUNWcest/bin/cediag
ENTITLEMENT for SOFTWARE AND SERVICES
Do you accept the licence terms? If so, enter "accept" : accept
cediag: licence: licence accepted by user

Memory, DIMM, Replacement, Management, Tool, cediag
Previously Published As
82264


Attachments
This solution has no attachment
  Copyright © 2011 Sun Microsystems, Inc.  All rights reserved.
 Feedback