Configuring VAX DSM - Revision history

Jpw: Created page with "This procedure assumes DSM is installed, and you are configuring it in an account that has not yet been used with DSM. The user account will need `SYSPRV` and
2025-01-14T16:08:10Z

Created page with "This procedure assumes DSM is installed, and you are configuring it in an account that has not yet been used with DSM. The user account will need <code>SYSPRV</code> and <code..."

New page
This procedure assumes DSM is installed, and you are configuring it in an account that has not yet been used with DSM. The user account will need <code>SYSPRV</code> and <code>TMPMBX</code> process privileges.
=Initializing User Account for DSM=

# Type <code>SET PROC/PRIV=(SYSPRV,TMPMBX)</code>
# Create a <code>DSM</code> subdirectory in your home directory (i.e., if your account name is <code>MYACCT</code> and your home directory is <code>DSA1:[MYACCT]</code>, type <code>CRE/DIR DSA1:[MYACCT.DSM]</code>
# Run <code>@SYS$MANAGER:DSM$INIT</code>
## Enter your username at the <code>Enter the account name to use with DSM ></code> prompt
## Press <code>ENTER</code> at the <code>Do you want to continue [Y OR N] ? <Y></code> prompt
## Press <code>ENTER</code> at the <code>Are there any additional Cluster members not currently booted that you would like to add to this list [Y OR N] ? <N></code> prompt
## Press <code>ENTER</code> at the <code>Create similar directories on other disk devices [Y OR N] ? <N></code> prompt
## Press <code>ENTER</code> at the <code>Press RETURN to continue listing ...</code> prompts until you reach the <code>Do you want to edit this command procedure [Y OR N] ? <N></code> prompt
## Press <code>ENTER</code> at the <code>Do you want to edit this command procedure [Y OR N] ? <N></code> prompt
## Press <code>Y</code> and <code>ENTER</code> at the <code>Do you want to run this command procedure now [Y OR N] ? ></code> prompt
## Press <code>ENTER</code> at the <code>Account initialized - press return to continue</code> prompt

=Creating a DSM Volume Set=

# Type <code>@SYS$MANAGER:DSM$CONFIGURE</code>
# Press <code>ENTER</code> at the <code>Do you want to create a new DSM database volume Set [Y OR N] ? <Y></code> prompt
# Enter a 3-character identifier at the <code>Enter the 3-character name for the volume set ></code> prompt (best to choose an identifier that makes sense for the application(s) to be hosted in this DSM configuration)
# Press <code>ENTER</code> at the <code>Create a DSM Volume in which file ?</code> prompt
# Enter a block count at the <code>Enter desired size of this volume in 1 KB DSM blocks ></code> prompt (I typically start with 120000 blocks)
# Press <code>ENTER</code> at the <code>Initialize as a SYSTEM or APPLICATION volume set [S or A] <s></code> prompt to create an <code>SYSTEM</code> volume set (<code>APPLICATION</code> volume sets are outside the scope of this article)
# Enter the maximum number of globals you'll use in the volume set at the <code>Enter the maximum number of globals allowable on this volume set <90></code>
# Enter <code>Y</code> at the <code>Allow expanded string lengths on this volume set [Y OR N] ? <N></code> prompt
# Choose a volume label at the <code>What would you like the new label of this volume to be ? (up to 20 characters) ></code> prompt (again, it is best practice to choose a volume label that makes sense for the application(s))
# DSM will initialize the volume set at this point, which may take a few minutes, depending on the I/O performance of your VAX

=Defining a DSM Configuration=
This will happen automatically as soon as the volume set is configured.
# You can choose either <code>Y</code> or <code>N</code> at the <code>Would you like extended help [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Enter the configuration identifier <1></code> prompt
# Press <code>ENTER</code> at the <code>1 is not currently defined, define it now [Y OR N] ? <Y></code> prompt
# For disk buffers, I typically choose a small number to reduce memory footprint (say, 300), but you can go higher if memory capacity permits for increased performance
# I typically do NOT use nonpaged memory for these buffers, but again, for a performance-sensitive environment, I would recommend using nonpaged memory to avoid thrashing the swap volume
# Enter the desired number of maximum users at the <code>Enter the maximum number of DSM users <128></code> prompt (for a development system, I typically go with 10, but some applications may require more users to run at all)
# I typically answer <code>N</code> at the <code>Enable configuration access control [Y OR N] ? > </code> prompt for a dev system, but it is strongly recommended that you enable it for production usage, which is outside the scope of this article
# I typically choose <code>N</code> at the <code>Include support for Routine/Global Performance Histograms [Y OR N] ? <N></code>
# Press <code>ENTER</code> at the <code>Number of database sets in this configuration <1></code> prompt
# Press <code>ENTER</code> at the <code>Name of database set #1 ...</code> prompt (this prompt will also show the 3-character identifier chosen in step 3 of ''Creating a DSM Volume Set'')
# Press <code>ENTER</code> at the <code>NNN not defined. Define it now [Y OR N] ? <Y></code> prompt (where <code>NNN</code> represents the 3-character identifier of the volume set)
# Press <code>ENTER</code> at the <code>Is this a VMS DSM, Transaction or DSM-11 database set [V, T or D] <V></code> prompt
# Press <code>ENTER</code> at the <code>Mount NNN for READ-ONLY access [Y OR N] ? <N></code> prompt
# Press <code>Y</code> and <code>ENTER</code> at the <code>Mount NNN for clusterwide access [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Name of the volume set <NNN></code> prompt
# Press <code>ENTER</code> at the <code>Enter the number of volumes in volume set NNN <1></code> prompt
# Press <code>ENTER</code> at the <code>File name of NNN volume 1</code> prompt
# Press <code>ENTER</code> at the <code>BIJ Journal file name</code> prompt
# Press <code>Y</code> and <code>ENTER</code> at the <code>Are you sure you want to include this file [Y OR N] ?</code> prompt (we will create the before-image journal in a future step)
# Press <code>Y</code> and <code>ENTER</code> at the <code>Enable After-Image Journaling for this database set [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Number of AIJ journal files <1></code> prompt
# Press <code>ENTER</code> at the <code>File name of AIJ file #1</code> prompt
# Press <code>Y</code> and <code>ENTER</code> at the <code>Are you sure you want to include this file [Y OR N] ? <N></code> prompt (we will create the after-image journal in a future step)
# Press <code>ENTER</code> at the <code>Message text when closing this AIJ file ></code> prompt
# Press <code>Y</code> and <code>ENTER</code> at the <code>Print console message when database set is nearly full [Y OR N] ? <N> </code> prompt
# Press <code>ENTER</code> at the <code>Send message at what percentage full <90></code> prompt
# Press <code>ENTER</code> at the <code>Is this configuration a database set master for SMX [Y OR N] ? <Y></code> prompt
# Press <code>ENTER</code> at the <code>Modify default After-Image Journaling characteristics [Y OR N] ? <N> </code> prompt
# Enter a 3-character name at the <code>Enter a unique 3 character DDP node name ></code> prompt (I use the same name as the volume set identifier, typically)
# Press <code>ENTER</code> at the <code>Start DDP servers during configuration startup [Y OR N] ? <Y></code> prompt
# Press <code>ENTER</code> at the <code>Enter the number of DDP servers to start ? <3></code>
# Press <code>ENTER</code> at the <code>Send DDP status messages to the operator's console [Y OR N] ? <Y></code> prompt
# Press <code>ENTER</code> at the <code>Enter DDP GROUPS to enable <0></code>, <code> Enter the REQUEST RETRY MAXIMUM <4></code>, <code>Enter the REQUEST RETRY INTERVAL <3></code>, <code>Enter the REQUEST CREDIT MAXIMUM <20></code>, and <code>Press <RETURN> to continue:</code> prompts
# Press <code>ENTER</code> at the <code>Enter the TRANSMIT BUFFER DELAY increment <0></code>, <code>Enter the DDP MULTICAST ADVERTISING INTERVAL <6></code>, and <code>Include CIRCUIT CONNECTION SECURITY [Y OR N] ? <N></code> prompts
# Enter <code>0</code> at the <code>Enter the number of DDP links in this configuration ></code> prompt (configuring non-dummy DDP links is outside the scope of this article)
# Press <code>ENTER</code> at the <code>Modify GLOBAL characteristics [Y OR N] ? <N> </code> prompt
# Press <code>ENTER</code> at the <code>Include support for mapped routines [Y OR N] ? <N> </code> prompt
# Press <code>ENTER</code> at the <code>Modify DSM default command line qualifiers [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Modify Global Translation Tables [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Modify $H date for this configuration [Y OR N] ? <N></code> prompt
# Press <code>ENTER</code> at the <code>Show configuration memory requirements [Y OR N] ? <N></code> prompt
# Enter <code>N</code> at the <code>Startup configuration 1 [Y OR N] ? ></code> prompt (we still need to create before-image and after-image journals before starting up the configuration)

=Defining After-Image Journals=

# At the DCL prompt, type <code>DSM/MANAGER</code>
# Type <code>D ^JRNINIT</code>
# At the <code>Initialize DSM After-Image Journal file for which volume set ></code> prompt, enter the 3-character volume set identifier you chose in step 3 of ''Creating a DSM Volume Set''
# Press <code>ENTER</code> at the <code>File name of DSM Volume 1</code> prompt
# Press <code>ENTER</code> at the <code>Enter the journal file name</code> prompt
# Enter <code>2000</code> or more at the <code>Enter the maximum size of this file in 512 byte blocks ></code> prompt
# Press <code>Y</code> and <code>ENTER</code> at the <code>Are you sure you want to continue [Y OR N] ? <N></code> prompt
DSM will now initialize the after-image journal file, which may take a few moments.

=Defining Before-Image Journals=

# Type <code>D ^BIJINIT</code> at the DSM prompt
# At the <code>Initialize DSM Before-Image Journal file for which volume set ></code> prompt, enter the 3-character volume set identifier you chose in step 3 of ''Creating a DSM Volume Set''
# Press <code>ENTER</code> at the <code>File name of DSM Volume 1 for NNN</code> prompt
# Press <code>ENTER</code> at the <code>Name of BEFORE-IMAGE journal file for NNN</code> prompt
# Press <code>ENTER</code> at the <code>Enter the SIZE (in DSM 1024-byte blocks) of the file <8000></code> prompt
DSM will now initialize the before-image journal file, which may take a few moments.

=Starting the Configuration=
# At the DSM prompt, type <code>D ^STU</code>
# Press <code>ENTER</code> at the <code>Enter the configuration identifier <1></code> prompt
# Press <code>ENTER</code> at the <code>Enable user logins on startup [Y OR N] ? <Y> </code> prompt