Starting the D3 virtual machine

Before starting the D3 virtual machine, verify that the tape statements in the D3 configuration file are correct.

See the Tapes and D3 Configuration File Tape Statements topics in the D3 System Administration Guide for additional information.

Warning: If you are upgrading with data files in place, you should not follow the instructions here. Complete the instructions in Starting the D3 virtual machine in the Upgrading with data files in place section.

If the tape statements are not correct, use the UNIX vi editor to modify or add the tape device statements in the D3 configuration file /usr/lib/pick/pick0.

The D3 configuration file's user statement specifies the UNIX user account (and thus the privileges) for D3 users.

If the user statement is not present, the user and privileges for root are assumed and creating a new UNIX user is not required.

If the user statement specifies another user, this UNIX user must be created prior to booting D3.

For additional information, see Creating a UNIX user account for D3.

Procedure

At the shell prompt, enter:

d3 -0

A similar screen displays:

10.2. M zz   DD MMM YYYY   hh:mm:ss
Virtual machine....pick0:LINUX      Line0......./dev/console
Key................10               Memory (K)          9216
Pibs...............64               Phantom Processes...10
Shared BASIC size  1024K
ABS locked
Boot in single user mode
Disk 0: /dev/hda1                         200704 Blocks
Tape 0: /dev/fd0H1440               Record size  500  Type 0 
Tape 1: /dev/fd0H720                Record size  500  Type 0
Tape 2: /dev/nst0                   Record size 16384 Type 6
Tape 3: /usr/lib/pick/ab            Record size  500  Type 7
Tape 4: /usr/lib/pick/dt            Record size  500  Type 7
Options: F)ile only, A)BS only, X) eXecute. Q)uit = _

Type A for ABS only.

The list of tape devices in the configuration file displays. The tape device numbers may vary, depending on the particular system configuration.

Restore ABS to disk /dev/hda1 from:
Floppy 1.44M        /dev/fd0H1440                 : 0
Floppy 1.44M        /dev/fd0H720                  : 1
SCT                 /dev/nst0                     : 2
pseudo              /usr/lib/pick/ab              : 3
pseudo              /usr/lib/pick/dt              : 4
Tape number (q = quit): 3

The ABS must now be loaded.

Enter the number that corresponds to the /usr/lib/pick/ab device.
In the above example, 3 is entered.

The following prompt displays:
```
Mount ABS volume #1 and type 'c' to continue (q=quit) _
```
Type c.
The ABS frame numbers display while the load is in progress. When the ABS load is complete, the following prompt displays:
```
nnnn ABS frames loaded.
Options: F)ile only, A)BS only, X) eXecute. Q)uit = _
```
The D3 data files must now be loaded. The system prompt displays:
```
Options: F)ile only, A)BS only, X) eXecute. Q)uit = _
```

Type F.

A file restore will overwrite the current system files with data from your
restore media. If there are current errors on the restore media, the system may
be left in an unusable state. Tape verification helps ensure that the restore
media is free of errors.

Are you sure that the restore media has been verified? Confirm (y/n)

Type y when you are certain there are no errors on your restore media.
```
All data on disk will be erased. Confirm (y/n)
```

Type y.

This text displays when the system is ready:

Locking ABS...Flush process started

Building overflow block list ...

Diagnostics .. successfully completed

Activating processes ...

The list of tape devices in the configuration file displays. The tape device numbers may vary, depending on the particular system configuration.

Tape  Status         DD MMM YYYY   hh:mm:ss
#     Type          Density      Owner   Device Name
0  | Floppy      | 3 1/2" 1.44M |     | /dev/fd0H1440
1  | Floppy      | 3 1/2" 720K  |     | /dev/fd0H720
2  | SCT         |              |     | /dev/nst0
3  | compressed  | 500K         |     |/usr/lib/pick/ab
4  | compressed  | 500K         |     | /usr/lib/pick/dt
-------------------------------------------------------------
Enter a unit number from the above list: 4

Enter the device number that corresponds to the /usr/lib/pick/dt device.
For example, if 4 is entered, the following prompt displays:
```
Do you wish to disable file reallocation (y/<n>)?
```
Press ENTER.
```
Load volume #1 and press <Enter>
```
Press ENTER.
The system restores the accounts and files, and then displays:
```
Restore from incremental save tape (y/n)? _
```

Enter n.

Restore from transaction log tape (y/n)? _

Enter n.

The system generates indexes for the base files and performs a system coldstart. A similar screen displays:

generating indexes for account > dictname > filename
generating indexes for account > dictname > filename
generating indexes for account > dictname > filename
     :
19:57:28 03 OCT 2012
Starting Background Processes....
[507] Scheduler started.
[1137] The spooler is initialized.
[1139] The spooler is started.
:
:
Verifying ABS from file 'DM,ABS,'
ABS file 'DM,ABS,' verifies!
syschk started on port 513

The syschk process which monitors the system is started by default. If the system's swap space is determined to be too small, the swap space should be increased and a similar message may display:

"syschk: Current swap of 512 Mb is too small.
        A minimum of 1024 Mb is recommended"

See Minimum recommendations and requirements.

Once the coldstart is complete, this prompt displays:

 Enter your user id: _

Log on to the D3 system entering the user-ID dm and master dictionary dm:
```
Enter your user id: dm
master dictionary: dm
:_
```
As shown above, the colon (:) is a D3 prompt that indicates the user is at the Terminal Control Language, or TCL prompt.

D3 is installed and running on the system.