Mumpster
http://mumpster.org/

HOWTO: GT.M/OpenVMS Production Instance - 2: User Account
http://mumpster.org/viewtopic.php?f=13&t=1626
Page 1 of 1

Author:  jollis [ Sun Aug 21, 2011 7:47 pm ]
Post subject:  HOWTO: GT.M/OpenVMS Production Instance - 2: User Account

HOWTO: GT.M Production Instance on OpenVMS/Alpha
Part 2: Instance User and Directories

In this step, we will create the user account for the instance user, and create the necessary directories where GT.M will store its data, routines, object files, journals, and local patches.

Multiple users could be created to support multiple instances, but we will focus only on creating one user and the necessary directories. The same procedure applies for creating further instance users.

In the DCL examples that follow, please consult the table of bracketed parameters from Part 1 of this tutorial for definitions of <instance-user>, etc.

We will begin by running the OpenVMS User Authorization Facility (UAF) and adding the user, as shown below:

Code:
$ SET DEF SYS$SYSTEM
$ RUN AUTHORIZE
UAF> ADD <instance-user>/PASSWORD=temp/OWNER="<instance-user-name>"/DEV=<home-device>/DIR=[<instance-user>]/UIC=[<group-number>,<user-number>]/FLAG=NODISUSER
%UAF-I-PWDLESSMIN, new password is shorter than minimum password length
%UAF-I-ADDMSG, user record successfully added
%UAF-I-RDBADDMSGU, identifier <instance-user> value [<group-number>,<user-number>] added to rights database
UAF> EXIT
%UAF-I-DONEMSG, system authorization file modified
%UAF-I-RDBDONEMSG, rights database modified


Now we will create the necessary directory structure, as shown below:

Code:
$ CREATE/DIRECTORY <home-device>:[<instance-user>]
$ CREATE/DIRECTORY <home-device>:[<instance-user>.r]
$ CREATE/DIRECTORY <home-device>:[<instance-user>.p]
$ CREATE/DIRECTORY <journal-device>:[<instance-user>]
$ CREATE/DIRECTORY <journal-device>:[<instance-user>.j]
$ CREATE/DIRECTORY <data-device>:[<instance-user>]
$ CREATE/DIRECTORY <data-device>:[<instance-user>.g]
$ CREATE/DIRECTORY <image-device>:[<instance-user>]
$ CREATE/DIRECTORY <image-device>:[<instance-user>.o]
$ CREATE/DIRECTORY <image-device>:[<instance-user>.o.50000]


Now, set the ownership on the directories:

Code:
$ SET DIRECTORY/OWNER=DEV <home-device>:[<instance-user>]
$ SET DIRECTORY/OWNER=DEV <home-device>:[<instance-user>.r]
$ SET DIRECTORY/OWNER=DEV <home-device>:[<instance-user>.p]
$ SET DIRECTORY/OWNER=DEV <journal-device>:[<instance-user>]
$ SET DIRECTORY/OWNER=DEV <journal-device>:[<instance-user>.j]
$ SET DIRECTORY/OWNER=DEV <data-device>:[<instance-user>]
$ SET DIRECTORY/OWNER=DEV <data-device>:[<instance-user>.g]
$ SET DIRECTORY/OWNER=DEV <image-device>:[<instance-user>]


Now, we will set permissions on the newly-created directories, so that only SYSTEM will be able to write or delete object files in <image-device>:[<instance-user>.o]50000.DIR, as shown below:

Code:
$ SET SECURITY /PROTECTION=(S:RWED,O:RE,G:RE,W:"") <image-device>:[<instance-user>.o]50000.DIR
$ SET SECURITY /PROTECTION=(S:RWED,O:RE,G:RE,W:"") <image-device>:[<instance-user>]O.DIR   


You will next need to create <home-device>:[instance-user>]LOGIN.COM, including the lines of DCL code shown below; these lines will define the correct values for GTM$GBLDIR (which determines where the GT.M global directory is located) and GTM$ROUTINES (which determines the locations GT.M will search for routines and object files) are set.

Code:
$ IF (P1 .NES. "") .AND. (F$EXTRACT(0,1,P1) .NES. "/") THEN P1 := /'P1
$ DEFINE 'P1' GTM$GBLDIR   <data-device>:[<instance-user>.g]MUMPS.GLD
$ DEFINE 'P1' GTM$ROUTINES    "<home-device>:[<instance-user>.p],<image-device>:[<instance-user>.o.50000]/SRC=<home-device>:[<instance-user>.r],GTM$DIST:"
$ EXIT


Next, add the following lines to SYS$MANAGER:SYSTARTUP_VMS.COM. This will ensure that the newly-created volumes are available:

Code:
$ MOUNT/SYSTEM <home-device GTMHOME
$ MOUNT/SYSTEM <journal-device> GTMJNL
$ MOUNT/SYSTEM <data-device> GTMDATA
$ MOUNT/SYSTEM <image-device> GTMIMG


That's all for this installment! Stay tuned for the next episode, where we will use GDE and MUPIP to build the instance data files.

Page 1 of 1 All times are UTC - 8 hours [ DST ]
Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group
http://www.phpbb.com/