Page 1¶

Product Information¶

Product name	Product number
Backup Manager for ND-500/5000	211226B

Description of product¶

Backup Manager is a program system for backup and restoring on ND-500 and ND-5000 computers. Backup Manager consists of four modules:

BM-Definition - To predefine sets for backup and restore.
BM-Operator - To run predefined sets, do occasional copying and service functions.
BM-Scheduler - To schedule backup sets and ordinary SINTRAN batch-jobs in a COSMOS network.
BM-FileRestore - To restore single files from image (device) backups stored in volume format on tape or disk.

Reason(s) for new product or version¶

Handling of backup devices connected to the DOMINO/SCSI Mass Storage System.
Automatic and integrated handling of mirroring on DOMINO/SCSI disks.
Improved functionality concerning SIBAS database backup: Automatic "on-the-fly" backup (incremental or based on mirroring), and database verification as part of the backup procedure.
Possible to do copy and compare when copying SINTRAN main directory.
Error corrections and some functionality improvements.

Table of Contents¶

Section	Page
Prerequisites	2
Dependencies	4
Documentation	5
Installation procedure	5
Errors corrected since version B02	9
Errors known but not corrected	10
Limitations	10
Information and hints	12

ND-895055.1A EN

Page 2¶

Product Information¶

Date: 90.05.22
Norsk Data
Page 2 of 12

Product name
Backup Manager for ND-500/5000

Product number
211226B

1 Prerequisites¶

In order to use this product, the following is required.

1.1 Hardware prerequisites¶

CPU type (any of the following):

500
5000

Floating format: Any

1.2 Software prerequisites¶

The following software must be available on the system before the product is installed:

Operating system:¶

Name	Version/Revision
SINTRAN III VSX for ND-500/5000	210576L

Other software:¶

Product name	Product number
ND LINKER	211224B01
Backup System for SINTRAN III	210337105

Backup System is used during installation, and the DMA-SERVER is used when doing image-copying to/from devices connected to the ND-100 bus.

NOTE! Two modification patches to the DMA-SERVER-C01 must be run for handling DOMINO/SCSI-disks and the 155MB Archive streamer. These patches are run automatically during installation of Backup Manager BO4. (See file BM-DMAPTC:MODE).

ND-895055.1A EN

Page 3¶

Product Information¶

Date	Page
90.05.22	Page 3 of 12

Norsk Data
Product Information

Product name	Product number
Backup Manager for ND-500/5000	211226B

1.3 Other prerequisites¶

Minimum Permanent Mass Storage:

User	Space (pages)	Number of files
SYSTEM	230
ND-OPERATIONS	34	2
BACKUP-MANAGER	2900	25

	Minimum	Maximum
Number of segments (ND-100)	1	1
Number of RT descriptions	1	1

Requirements regarding batch processors: 0

BM-Scheduler requires that batch processes exist to be able to start jobs for periodic execution.

ND-895055.1A EN

Page 4¶

Product Information¶

Date	Norsk Data	Page
90.05.22		4 of 12

Product name	Product number
Backup Manager for ND-500/5000	211226B

2 Dependencies¶

In addition, the following dependencies exist between this and other products. The hardware and software listed here, may for example be necessary to make full use of the product.

2.1 Hardware dependencies¶

Product name	Product number
DOMINO/SCSI System

Nature of dependency

Automatic handling of mirrors require that DOMINO/SCSI hardware for MF-bus is installed.

2.2 Software dependencies¶

Product name	Product number
Disk Restore	211187B
DOMINO/SCSI Software Package	211478A
SIBAS

Nature of dependency

Disk Restore version B is required to restore a system disk when SINTRAN III is not running.

DOMINO/SCSI Software Package is required to make use of, for instance, integrated mirror handling.

The following SIBAS versions may be linked in order to let BM be able to perform integrated database backups:
```
SIBAS/R-B (211212B)
SIBAS/R-A (211212A)
SIBAS-F (2103040)
```
- SIBAS/R-B is the SIBAS version required by the installation program (see the sections 4.1 and 4.4).

ND-895055.1A EN

Page 5¶

Product Information¶

Date	90.05.22	Norsk Data	Page 5 of 12
Product name	Backup Manager for ND-500/5000	Product number	211226B

3 Documentation¶

Included with the product:

Title	Number
Backup Manager User Guide	860276.2 EN

Optional:

Title	Number
DOMINO SCSI Operator Guide	814009.1 EN

4 Installation Procedure¶

4.1 Automatic Installation¶

Before you start installing Backup Manager, check that the prerequisites listed in Chapter 1 are fulfilled.

Note that it is possible to install Backup Manager without an interface to SIBAS. This is selected during the installation procedure.

If an interface from Backup Manager to SIBAS is wanted, the following 3 possibilities exist:

SIBAS/R-B interface (new domain format-automatic inst. proc.)
SIBAS/R-A interface (old domain format-manual inst. procedure)
SIBAS-F interface (old domain format-manual inst. procedure)

In any case, Backup Manager should be installed the standard way by use of the installation program. For the two latter possibilities (old domain format) the standard installation should be performed with NO SIBAS interface. Thereafter the BM-Operator domain should be reinstalled in the old domain format with link to the correct SIBAS version as described in section 4.4. The 2 floppies 211226B04-XX-05D and 211226B04-XX-06D are exclusively delivered for this purpose and are therefore not requested by the installation program. For the manual reinstallation of the BM-Operator domain in old domain format in order to interface SIBAS/R-A or SIBAS-F see section 4.4.

Log in on user area: SYSTEM.

ND-895055.1A EN

Page 6¶

Product Information¶

Date	Norsk Data	Page 6 of 12
Date 90.05.22

Product name	Product number
Backup Manager for ND-500/5000	211226B

If Backup Manager A02 is previously installed, then stop the BM-Scheduler server program by using the SUPERVISE/STOP-SERVER command in BM-Scheduler.

Insert the diskette 211226B-XX-01D in the floppy drive.

Enter the floppy directory as usual by typing:

@ENTER-DIRECTORY 211226B<rev>-XX-01D <device name> <device number>

Start the installation program by typing:

@[211226B<rev>-XX-01D:FLOPPY-USER>]IN-BCKMAN-XX-B<rev>:PROG

Backup Manager will then be installed.

Note that only the following floppies will be copied:

211226B<rev>-XX-01D  (floppy no. 1)
211226B<rev>-XX-02D  (floppy no. 2)
211226B<rev>-XX-03D  (floppy no. 3)
211226B<rev>-XX-04D  (floppy no. 4)
211226B<rev>-EN-01D  (floppy no. 7)

The two extra floppies are for loading BM-OPERATOR in old domain format in order to interface older SIBAS versions than SIBAS/R-B (see above).

If you already had an earlier B-revision installed (B01/B02/B03) the old file (which is not deleted by the installation program in order to keep the old SET and JOB definitions):
```
(NO-OPERATION)BM-JOBDB-B<rev>:DATA
```
and the new file
```
(NO-OPERATION)BM-JOBDB-B04:DATA
```
will result in a name conflict. The file specification (as used by BM)
```
(NO-OPERATION)BM-JOBDB-B:DATA
```
must therefore be made unique when the installation program is finished by deleting or renaming one of the two files.

If upgrading from A02 to B04 the old SET and JOB definitions MAY NOT BE USED and the file (ND-OPERATION)BM-JOBDB-A02:DATA should be deleted.

ND-895055.1A EN

Page 7¶

Product Information¶

Date	Norsk Data	Page
90.05.22	Product Information	7 of 12

Product name	Product number
Backup Manager for ND-500/5000	211226B

4.2 Updates to the system operation files¶

If you are not installing on a ND tpServer:

Remember to update the (SYSTEM)HENT-MODE (or corresponding) file with the following command:

@MODE (BACKUP-MANAGER)BM-SERVER-B<rev>:MODE,...,
@MODE (BACKUP-MANAGER)BM-DUMP-B<rev>:MODE,...,

Remember also to update the (SYSTEM)LOAD-MODE (or corresponding) file with the following command to start the BM-Scheduler server:
```
@MODE (BACKUP-MANAGER)BM-START-B<rev>:MODE,...,
```

The load-file for the DMA-server segment (BACKUP-LOAD-I:MODE), should be updated with the patch-file
```
@MODE (BACKUP-MANAGER)BM-DMAPTC:MODE,...,
```

4.3 Defining new backup/restore jobs¶

Due to changes in the internal format of the Backup Manager database from the A to B version (BM-JOBDB-A:DATA -> BM-JOBDB-B:DATA), you are strongly advised to redefine all of your previously defined (A-version) sets when using BM-Definition version B.

When installing Backup Manager B, a new version of the BM-JOBDB:DATA file is copied to user ND-OPERATION. This file includes a set of examples which can be modified to your needs. (This gives you the opportunity to implement the new features offered by the B-version.)

If you already have an earlier B-revision installed (B01/B02/B03) and you want to keep the old SET and JOB definitions, the file (ND-OPERATION)BM-JOBDB-B:DATA should be renamed before the installation is started and copied to the file : (ND-OPERATIONS)BM-JOBDB-B04:DATA afterwards.

4.4 Non-automatic installation¶

Backup Manager may only be installed by use of the automatic installation procedure.

If a link against SIBAS-F or SIBAS/R-A is wanted the following installation procedure is to be followed:
```
ND-895055.1A EN
```

Page 8¶

Product Information¶

Date	Norsk Data	Page
90.05.22		8 of 12

Product name	Product number
Backup Manager for ND-500/5000	211226B

Log in as user SYSTEM

Install Backup Manager with no link against SIBAS (see sec. 4.i)

Delete the standard-domain BM-OPERATOR:

@ND
N500: DELETE-STANDARD-DOMAIN BM-OPERATOR
N500: EXIT

Log in as user BACKUP-MANAGER

Insert floppy no 5 (211226B04-XX-05D) in FLOPPY-DISC-1 unit 0 and enter it:
```
@ENTER-DIR,,FLOPPY-DISC-1,0
```

Copy the file BM-OLD-IN-B04-1:MODE from the floppy:

@COPY-FILE "BM-OLD-IN-B04-1:MODE" (21:FL-US)BM-OLD-IN-B04-1:MODE

Run the :MODE file with output to file (may take some minutes):
```
@MODE BM-OLD-IN-B04-1:MODE "BM-OLD-IN-B04-1:OUT"
```

Check the output-file to ensure everything went OK

Remove the floppy, insert floppy no 6 (211226B04-XX-06D) in FLOPPY-DISC-1 unit 0 and enter it:
```
@ENTER-DIR,,FLOPPY-DISC-1,0
```

Run the second :MODE file with output to file (may take some minutes):
```
@MODE BM-OLD-IN-B04-2:MODE "BM-OLD-IN-B04-2:OUT"
```

Check the output-file to ensure everything went OK

Remove the floppy

Run one of the following two :MODE-jobs:

If SIBAS-F interface is wanted:

@MODE BM-DFSIB-OLD-B04:MODE "BM-DFSIB-OLD-B04:OUT"

If SIBAS/R-A interface is wanted:

@MODE BM-DRSIB-OLD-B04:MODE "BM-DRSIB-OLD-B04:OUT"

ND-895055.1A EN

Page 9¶

Product Information¶

Date	Norsk Data	Page
90.05.22	Product Information	9 of 12

Product name	Product number
Backup Manager for ND-500/5000	211226B

Check the output-file to ensure everything went OK

Define BM-OPERATOR as a standard domain:

As user SYSTEM:

@ND-500
N500: DEF-ST-DOM BM-OPERATOR (BA-MAN)BM-OPERAT-B04
N500: EXIT
@

5 Errors corrected since version B02¶

All errors reported for the B02 version have been corrected.

This includes:
- SIS report 1: Error on an image copy from a device with 16 characters long device name.
- SIS report 5: The error message ‘wrong password, disconnected’ may appear on error device when initiating a copy operation (image or large contiguous file).
- SIS report 6: Error when performing TOTAL DATABASE backup using control: ‘mi’ and more than one R-log is denied, when copying R-logs to Domino SCSI device.
- SIS report 7: Error when starting BM-Operator when User-Environment has been stopped.
- SIS report 8: Compare error at page 1, during compare of the system-disc
- SIS report 9: Compare error on a page within an ‘IMAGE-NO-COMPARE-FILE’.
- SIS report 10: Wrong errors reported from Directory Control when unable to reserve system/directory (Rs/Rd).
- SIS report 11: Files not automatically closed when control: ‘RdFc’ is specified.
- SIS report 13: The mirror is not reconnected if a SIBAS backup is aborted during copying of last logfile.
- SIS report 14: Db-control = ‘Fc’/’Sc’ does not work on a database running without logfile.
- SIS report 15: Error when copying a indexed file >= 65536 pages from disk to volume.
- SIS report 17: Rubbish characters in system name in connection database logfile copying.
- SIS report 18: Allowing Norwegian characters in (remote) system name.

ND-895055.1A EN

Page 10¶

Product Information¶

Date 90.05.22	Norsk Data	Page 10 of 12
Product name	Product number
Backup Manager for ND-500/5000	211226B

SIS report 19: 'Operation in progress' reported from DMAServer.
BM-SCHEDULER did not manage to use input/output files on a user's non-default directory.
Password was written in error message if file is already open when it is tried copied from a remote computer.
Backup Manager could not be started from batch no >= 10.
Device name was cleared during database image copy when log files and database was copied to the same device.
"Unable to set Sibas process in correct state".
User name was not displayed when editing queue in BM-Scheduler.
"Data overflow" when starting BM-FileRestore.
"Not mass storage file" when starting a SET from a :MODE-job with output to terminal.
File restore of indexed files larger than 4096 pages failed.
Allowing 'norwegian characters' as part of machine name.
Small and large characters allowed in the BM parameter file.
The installation program did not check the precence of correct UE-ERRMSG-file. This is now delivered along with the product.
BM-SCHEDULER did allow alpha-numerical characters only in the password.
Standard mail was not sent if 'message to operator' mas set to ‘N'.
Menu choice RESTART-USER did not work. Corrected for local machine.
To restart a user on remote machine this must be done from SINTRAN.
Restore of contiguous files happened to fail (‘internal 59' or 'outside device limits).

6 Errors known but not corrected¶

When Backup Manager creates a temporary mirror to perform an image copy of a directory on a DOMINO/SCSI disk, the error message 'NO MORE TO COPY' will be written on the error device when the backup procedure is finished. THIS MESSAGE CAN BE IGNORED!.

Restore of spooling files from volume does not work properly. They have to be created manually.

7 Limitations¶

Indexed files larger than 65000 pages cannot be copied by Backup Manager. (Contiguous files can be copied when logged in as user SYSTEM!)

When performing image copying in batch mode (for example, via BM-Scheduler) you cannot copy the directory where the input and output batch files for this job is located. (Normally the directory where user area SYSTEM and ND-OPERATIONS is located.)

You cannot copy TO a DOMINO/SCSI tape-device from a remote computer.

ND-895055.1A EN

Page 11¶

Product Information¶

Date	Norsk Data	Page 11 of 12
90.05.22

Product name¶

Backup Manager for ND-500/5000

Product number¶

211226B

It is NOT possible to do image copying of disks connected to the ND-100 bus to a DOMINO/SCSI tape device. (They must be copied to a ND-100 connected device.)

ND-895055.1A EN

Page 12¶

Product Information¶

Date	Norsk Data	Page 12 of 12
Product name	Product number

Product name
Backup Manager for ND-500/5000

Product number
211226B

8 Information and hints¶

When doing image backup, it is possible to skip compare of selected CONTIGUOUS files (for example, Segfiles and Swapfiles). These file names must be registered in the (ND-OPERATIONS)BM-PARAMETER file! The maximum number of contiguous files that may be specified to be excluded from the compare operation is 12.

Example:
```
IMAGE-NO-COMPARE-FILE = (SYSTEM)SWAP-FILE-0:SWAP
IMAGE-NO-COMPARE-FILE = (SYSTEM)SEGFILE0:DATA
```

To maximize performance:

NEVER specify the 'Computer name' field when copying files between local devices.

When copying to/from/between remote computers, try to specify as much selection information (directory, user area, file name, etc.) as possible to speed up file searching.

To recognize backup devices connected to the ND-100 bus, Backup Manager must have access to the peripheral files for the devices. The peripheral files are created via the SINTRAN III command: QSET-PERIPHERAL-FILE. The relationship between peripheral file names, device numbers and device names is:

Peripheral file name	Device number used in peripheral file	Device name used in BM
Streamer-1	2226B	Streamer-1
Streamer-2	2227B	Streamer-2
Mag-Tape-0	40B	Mag-Tape-1
Mag-Tape-4	32B	Mag-Tape-2
Mag-Tape-8	1232B	Mag-Tape-3
Mag-Tape-12	1225B	Mag-Tape-4

Devices connected to the DOMINO/SCSI adapter are defined via the program DP-SERVICE. (See the manual, DOMINO SCSI Operator Guide, ND-814009 for further information.)

No peripheral files are necessary in SINTRAN III for these devices. They can be given any name.

ND-895055.1A EN