Installation worksheet

This worksheet is an integral part of the installation process. Completing the worksheet can streamline the installation process.

The D3 configuration file is a UNIX file (/usr/lib/pick/pick0) that contains various parameters about the D3 system, information about the UNIX environment, and statements defining the actual hardware that is available to D3.

When D3 is installed, the configuration file is created using a set of default values. Some of these values might not be suitable for the specific system or site. The parameters should be reviewed to confirm that these values are appropriate. Not all of the values are displayed for user changes during the installation process.

The following are the initial default D3 configuration file values. These values are entered during the installation process in section D3 installation options.

A discussion of the D3 Menu system used during the installation process to change these values is located in the D3 Virtual Disk menu appendix. Record the values for your system where applicable in the worksheet:

Configuration Category	Description	Default Value
D3 configuration file name:	Name of the D3 virtual machine.	pick0
D3 (core) memory:	Amount of shared memory the D3 process allocates for itself while the virtual machine is running. The maximum amount is: 200 GB See Using D3 memory for more information regarding D3 and BASIC memory.	75% of (the available memory minus BASIC memory).
User:	Name of a valid UNIX user. The user statement contains pick by default. If this field is empty, the virtual machine is owned by root. If a non-root user is to be used, the user must be created before the virtual machine is booted. See Starting the D3 virtual machine and Creating a UNIX user account for D3.	pick
Scheduling priority process:	This parameter is a signed value that adjusts the priority of the D3 process relative to other regular UNIX processes. A negative value gives a higher priority. A positive value gives a lower priority. Acceptable values are -19 (highest priority) to +20 (lowest priority).	0
FlashBASIC memory:	Modifies the amount of memory (1 KB block) set aside to contain the shared FlashBASIC code most commonly used by the application. The minimum recommended size for this parameter is 1024 (1 MB). The maximum size for this parameter is 32768 (32 MB). Some FlashBASIC applications might require 10 to 15 MB. Usage is monitored using the TCL shpstat command. If this field is empty, the code produced by the FlashBASIC compiler will not be shared. This value can be changed in the Display/Modify D3 configuration menu. CAUTION: When Flashed object code is not shared in memory, every instance of that code is copied. This reduces the amount of main memory available to users, and can result in excessive use of swap space, thus impacting system performance.	Defaults to 8 MB, but can be set to a higher value.
Break character:	Hexadecimal value of the character used to indicate the D3 break sequence.	0x00 (the Break key)
Escape character:	Hexadecimal value of the character used to generate an escape sequence.	0x00 (the Esc key)
Lock boot ABS:	Locks the ABS into memory. Note that this option should always be ON.	ON
Idle flush period:	Specifies the rate, in seconds, at which the memory is flushed back to disk. The smaller the number, the more frequently the flush takes place and the higher the number of disk writes occur. A value range of 10 to 20 seconds is adequate for most systems.	10 (seconds)
Number of ports:	This parameter should be equal to the number of users for which the system is licensed, plus the expected number of parallel and/or serial printers. Allocating more ports than necessary simplifies upgrade procedures and future expansions when the number of licensed users must be increased. However, declaring more ports than are required increases the amount of time required to boot and shutdown the D3 virtual machine. Note: Changing the number of ports after D3 installation is complete requires a full file-save and restore of the system.	16
Number of phantoms:	Number of phantom ports that the system is licensed for. Generally, this is equal to the number of user licenses with a minimum of 5. You can configure more phantoms than you are licensed for. Note: Changing the number of phantoms after D3 installation is complete requires a full file-save and restore of the system.	10
Virtual machine key:	Hexadecimal number that is a unique identifier for this particular D3 virtual machine. Each virtual machine must have a unique identifier. If several D3 virtual machines are running on the system, this identifier must be different for each one.	0x10
Disk statements:	Disk statements are generated by the D3 installation process and can also be created by the user manually. Up to 64 disk statements can be specified in the configuration file. See also the D3 Virtual Disk menu appendix.	On a new installation D3 will attempt to allocate 75% of unpartitioned disk space to the D3 virtual machine (up to 2 terabytes). If there is more than one physical disk found on the system, D3 will use 75% of the unpartitioned space from the physical disk with the most unpartitioned disk space. Warning: The default disk, which D3 will automatically create if there is unpartitioned disk space, must be manually deleted from the configuration prior to loading ABS and datafiles. Otherwise, this default disk will be used in addition to any disk partitions manually added by the user. See D3 Virtual Disk menu for more details. Logical Volumes can also be used. See D3 Virtual Disk menu for more details.
Tape statements:	Created automatically according to the currently installed devices (floppy disks, SCT, 8mm, 4mm, half inch tape, and quarter inch tape) on the system. Up to 48 tape statements can be specified in the configuration file.	Determined at install time.