TOC PREV NEXT INDEX

Put your logo here!


6 REFERENCE

This chapter provides a short description in terms of manual pages of the FIERA CCD Controller utilities.

6.1 Maintenance utilities

In this section the manual pages for the following utilities are presented:
1. Backup the Instrument FIERA SPARC Hard Disk (fcdDump).
2. Check the archive version of a DSP binary code (fcdlWhat).
6.1.1 fcdDump
NAME
fcdDump - dump or restore a FIERA disk


SYNOPSIS
fcdDump -dump remote_host
fcdDump -restore [remote_host]


DESCRIPTION
This shell script allows a user to dump/restore a whole disk of a
Sparc running FIERA (SLCU). It is assumed that the scsi id of the disk
to dump/restore is 3. The script must be run as root and on a Sparc
running Solaris 2.x.
The parameter remote_host refers to host to which the tape device
is physically connected. This host may be either a Sun or an Hp
workstation. In case of a dump operation, remote_host must be
specified. In the case of a restore operation this parameter is
optional and, if not specified, defaults to the local host.
As the disks of SLCUs are usually of 4 Gb size, it is foreseen for the
dump operation the usage of a DDS2 (120m, 4 Gb native capacity)
cassette. It is strongly advised to use a DDS2 device to dump the
disk.
Remote dump/restore operation are performed as FCDDUMPUSER. So access
to the remote host as FCDDUMPUSER must be allowed. No restriction is
enforced on the choice of FCDDUMPUSER as long as this user has access
to the tape device. The environment variable FCDDUMPUSER must be set
by the user before running the script. If it is not set, the script
will use a default: "fcdrun".
The correspondence among devices and file systems is defined as
follows:

/dev/rdsk/c0t3d0s0 /
/dev/rdsk/c0t3d0s6 /usr
/dev/rdsk/c0t3d0s4 /var
/dev/rdsk/c0t3d0s7 /export/home
/dev/rdsk/c0t3d0s5 /opt
/dev/rdsk/c0t3d0s3 /usr/openwin

These are the file systems which will be dumped/restored. These are
also the only file systems needed in order to have an exact replica of
the original system.
Disks on which the tape are restored are formatted so that all data
previously contained are lost. The disks must be partitioned
beforehand. Hereafter are included the partition tables of the
models of some disks currently used by FIERA systems.

SOLARIS 2.4
-----------

Seagate ST34371N-0484

Total disk cylinders available: 5147 + 2 (reserved cylinders)

Part Tag Flag Cylinders Size
0 root wm 0 - 175 141.80MB
1 swap wu 176 - 498 260.23MB
2 backup wu 0 - 5146 4.05GB
3 usr wm 499 - 656 127.29MB
4 var wm 657 - 794 111.18MB
5 unassigned wm 795 - 1030 190.14MB
6 usr wm 1031 - 1515 390.75MB
7 home wm 1516 - 5115 2.83GB


Seagate ST34520N-1444

Total disk cylinders available: 9004 + 2 (reserved cylinders)

Part Tag Flag Cylinders Size
0 root wm 0 - 295 142.22MB
1 swap wu 296 - 833 258.49MB
2 backup wu 0 - 9003 4.22GB
3 usr wm 834 - 1104 130.21MB
4 var wm 1105 - 1354 120.12MB
5 unassigned wm 1355 - 1750 190.27MB
6 usr wm 1751 - 2583 400.23MB
7 home wm 2584 - 9003 3.01GB


SOLARIS 2.6
-----------

Seagate ST34520N-1444

Total disk cylinders available: 9004 + 2 (reserved cylinders)

Part Tag Flag Cylinders Size
0 root wm 0 - 295 142.22MB
1 usr wm 296 - 816 250.32MB
2 backup wu 0 - 9003 4.22GB
3 var wm 817 - 1025 100.42MB
4 swap wu 1026 - 1558 256.09MB
5 unassigned wm 1559 - 1975 200.36MB
6 usr wm 1976 - 2496 250.32MB
7 home wm 2497 - 9003 3.05GB

IBM-DNES-309170-SA30
Total disk cylinders available: 11195 + 2 (reserved cylinders)

Part Tag Flag Cylinders Size
0 root wm 0 - 204 160.16MB
1 usr wm 205 - 716 400.00MB
2 backup wu 0 - 11194 8.54GB
3 var wm 717 - 896 140.62MB
4 swap wu 897 - 1224 256.25MB
5 unassigned wm 1225 - 1557 260.16MB
6 usr wm 1558 - 2325 600.00MB
7 home wm 2326 - 11194 6.77GB


In case it should be necesary to partion a disk of another type, this
operation should be done taking into account the following:
1. Total disk size must be equal or greater than 4 Gb.
1. Partions number, name and flags must be the same as in the previous
table.
2. Partions size must be equal or greater. If disk size does not allow
it, swap could be decreased.

If in doubt, follow the partition table as suggested in the VLT
Solaris Installation Manual - VLT-MAN-ESO-17200-1646.
As a rule of thumb for the swap: its size should be double the size
of the installed RAM.

Instruction on how to partition a disk may be found in Solaris 2.x
documentation e.g. in the man pages relative to format(1M). Refer to
FIERA maintenance manual for details on how to partition a disk.
The environment variable FCDDUMPTAPE and FCDRESTORETAPE may be used to
specify the device on which to perform backups. A no-rewind device
must be specified for dump and a rewind device for restore.
If not defined the devices are:
on HPs:
/dev/rmt/0lbn for dump
/dev/rmt/0lb for restore
on Suns:
/dev/rmt/0mnb for dump
/dev/rmt/0mb for restore


ENVIRONMENT
FCDDUMPUSER: username used for remote tape operations; if not defined
it is set by default to "fcdrun"
FCDDUMPTAPE: variable used to override default dump tape
FCDRESTORETAPE: variable used to override default restore tape
FCDDUMPTMOUT: number of seconds to wait between each dump operation in
order to let socket in CLOSE_WAIT state to die orderly;
default is set to 300 seconds


RETURN VALUES
0 if success
1 if an error occurred


CAUTIONS
Scsi id of the disk dump/restored is assumed to be 3
The script must be run as root on a Sparc running Solaris 2.x




- - - - - -
Last change: 01/04/04-08:00


6.1.2 fcdlWhat
NAME
fcdlWhat - show the version of object modules used to
generate a C40 DSP file.


DESCRIPTION
fcdlWhat <filename1> <filename2> <filename3> ...

This utility reads the file(s) named <filename*> and searches for
occurrences of the string "@(#)".
It prints the rest of the string following the "@(#)" marker.

<filename*> IN name(s) of the file(s) to be checked


RETURN VALUES
SUCCESS if no error occured
FAILURE if file not opened


CAUTIONS
this tool works only with a binary COFF object file converted
into an ascii LOD file, 32 bit wide.


EXAMPLE
fcdlWhat dspsci1.app dspsci2.app




- - - - - -
Last change: 01/04/04-08:00






Quadralay Corporation
http://www.webworks.com
Voice: (512) 719-3399
Fax: (512) 719-3606
sales@webworks.com
TOC PREV NEXT INDEX