7 REFERENCE

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

7.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).

3. Check the connections with a TIM Board (fcdTimTest.sh).

7.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 two models of disks
currently used by FIERA systems.

Seagate ST34371N-0484

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

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

Seagate ST34520N-1444

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

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

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.

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

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: 04/03/99-13:44

7.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: 30/11/98-11:53

7.1.3 fcdTimTest.sh

NAME

fcdTimTest.sh - Test FIERA TIM/DSP Board Connections

SYNOPSIS

fcdTimTest.sh

DESCRIPTION

Utility to check the connection between the TIM and the
DSP board on the FIERA SLCU.
The script checks the version of the existing DSP Interface
Board (LSI or Jens Benner), running the appropriate DSP
code accordingly.

FILES

fcdtimTest SLCU program
fcdTim.app DSP program (LSI version)
fcdTimb.app DSP program (JBE version)
tis DSP server

CAUTIONS

This script has to be run by the "fcdrun" user (to have
the correct TIM access rights)

EXAMPLES

Run the utility
> fcdTimTest.sh