Starting the D3 virtual machine

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

About this task

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

You will see a screen similar to:

 Options: F)ile only, A)BS only, X) eXecute. Q)uit = _

Type A for ABS only.

You will see a list of tape devices in the configuration file. The tape device numbers might vary depending on the particular system configuration.

 Restore ABS to disk /dev/rpick from:
 pseudo              /usr/lib/pick/ab              : 0
 pseudo              /usr/lib/pick/dt              : 1
 SCT                 /dev/rmt0.1                   : 2
 SCT low density     /dev/rmt0.5                   : 3
 Tape number (q = quit): 0

The ABS must now be loaded.

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

You will see the following prompt:
```
 Mount ABS volume #1 and type 'c' to continue (q=quit) _
```
Type c.
You will see the ABS frame numbers while the load is in progress. When the ABS load is complete, you will see the following prompt:
```
 nnnn ABS frames loaded.
 Options: F)ile only, A)BS only, X) eXecute. Q)uit = _
```
The D3 data files must now be loaded. You will see the system prompt:
```
 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.

You will see this text when the system is ready:

 Locking ABS...Flush process started
 
 Building overflow block list ...
 
 Diagnostics .. successfully completed
 
 Activating processes ...

You will see the list of tape devices in the configuration file. The tape device numbers might vary depending on the particular system configuration.

 Tape  Status              DD MMM YYYY   hh:mm:ss
 #      Type        Density  Owner   Device Name
 -------------------------------------------------------------
 0  | compressed    |       |     | /usr/lib/pick/ab
 1  | compressed    |       |     | /usr/lib/pick/dt
 2  | Quarter Inch  |       |     | /dev/rmt0.1
 3  | Quarter Inch  |       |     | /dev/rmt0.5
 -------------------------------------------------------------
 Enter a unit number from the above list: 1

Enter the device number that corresponds to the /usr/lib/pick/dt device.
For example, if 1 is entered, you will see the following prompt:
```
 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 you will see:
```
 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. You will see a screen similar to:

 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 that 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. You might see a message similar to:

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

See Minimum recommendations and requirements.

After the coldstart is complete, you will see the following prompt:

 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 previously, 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.