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
 

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
 

Applies to:

Goal

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 

• <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

$ ./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

$ 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
$

# 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

This solution has no attachment