Sun Enterprise 5500 Server
 
Sun Ultra 80 Workstation
 
Sun Fire E25K Server
 
Sun Enterprise 250 Server
 
Sun Enterprise 420R Server
 
Sun Enterprise 3500 Server
 
Sun Fire 3800 Server
 
Sun Fire 280R Server
 
Sun Netra 120 Server
 
Sun Fire V480 Server
 
Sun Fire V490 Server
 
Sun Ultra 2 Workstation
 
Sun Blade 1000 Workstation
 
Sun Enterprise 10000 Server
 
Sun Fire 15K Server
 
Sun Netra T1400 Server
 
Sun Fire 6800 Server
 
Sun Fire V880 Server
 
Sun Fire E6900 Server
 
Sun Fire V1280 Server
 
Sun Enterprise 6500 Server
 
Sun Fire E2900 Server
 
Sun Fire 4800 Server
 
Sun Fire V890 Server
 
Sun Enterprise 4500 Server
 
Sun Ultra 30 Workstation
 
Sun Fire E4900 Server
 
Sun Ultra 60 Workstation
 
Sun Enterprise 220R Server
 
Sun Enterprise 450 Server
 

PLA-Support>Sun Systems>Sun_Other>Sun Generic Product>SN-OTH: Gen_Prod
 
.Old GCS Categories>Sun Microsystems>Desktops>Workstations
 
.Old GCS Categories>Sun Microsystems>Servers>NEBS-Certified Servers
 
.Old GCS Categories>Sun Microsystems>Servers>Midrange Servers
 
.Old GCS Categories>Sun Microsystems>Servers>Entry-Level Servers
 
.Old GCS Categories>Sun Microsystems>Boards>Memory Module
 
.Old GCS Categories>Sun Microsystems>Servers>High-End Servers
 

Applies to:

Goal

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

Download cediag

• Click here for 32-bit & 64-bit available via <Patch:14370362>

Fix

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:14370362>  (32-bit and 64-bit OS's)

Back to Index

5. How do I install cediag 

1. Create a directory for the packages. (e.g. /var/tmp/cediag)

2. Download cediag via <Patch:14370362>

3. Unpack the file and then execute

4. Be sure to read the README file.

5. Install the packages using

6. When prompted to automate cediag execution in cron and output to /var/adm/messages file, answer "Y".

7. Update your PATH. e.g.

8. Update your MANPATH. e.g.

9. View the man pages. e.g.

10. Execute cediag interactively, the first time, to acknowledge licence agreement.

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,

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:

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

This solution has no attachment