$TOPDIR
that contains all LeasePak builds. If the site needs to keep ore than the active build on the application host, then extraneous builds can be moved to other disks. In order for a build to remain "on line", it must be present in $BLDDIR
, at least via a symbolic link. See Directory Trees.
$NSTDIR
. There should be only one $CSTDIR
per site. The code within $CSTDIR
is organized by build ID, thus $CSTDIR
can store the EUCOs for many releases. See Directory Trees.
nst_dbora
, this variable contains the file name /etc/netsol_dbms_instances
. The file contains an assignment to ORA_INSTANCES
, which is a list of Oracle instances that are to be managed by nst_dbora
.
$udata
directory.
/etc/init.d
on Solaris and Linux, /etc/sbin
on HP-UX. Typically the DBMS nst_dbora and nst_dbsyb start-up files, and the nst_qm_{ID}99x Queue Manager start-up files are located here.
SETUP
at the prompt: 'Short identifier for this instance (2 to 4 characters) [**]'. Often referreed to as simply the ID
. Used in naming a variety of things, such as queue manager instances, and other locations where it may be necessary to distinguish among instances of LeasePak on the same server.
SETUP
program, in response to the interview question Max bad logins before lockout (0=disabled) [0]. This represents the tolerance given by leasepakd
for consecutive failed login attempts for any given user account.
cfg_gen
, change_env
, configure_rels
, db_setup_job
, eop_suite II
, linkpoint
, set_access
, setup_new_env
, setup_rels_dirs
, and upgrade_env
. It owns the whole Queue Manager installation and is the only LeasePak role that can start and stop the queues. See roles for more information.
/etc/group
before LeasePak is installed. All OS users who are to use LeasePak must have the GID of this group as the user's default login group listed in /etc/passwd
. Because it is the default login group for these users, it should not list the users in the /etc/group
file.
$NSTDIR
and heads the local instance of the Queue Manager. See Directory Trees.
start_queues.com
command file.
SETUP
. See discussion at About Job Limits. the value is stored in the form of an assignment to the variable QLIM.
flag position | Service to be installed |
1 | Queue Manager init service |
2 | Not used |
3 | Oracle init service |
4 | Sybae init service |
5 | leasepakd internet service |
6 | mpowerd internet service |
seed
and level7
datasets that are compatible with the schema the build contains, and incorporate all changes to the LeasePak schema, or data layout, from previous builds, in that release.
$ENVDIR/eop
.
leasepakd
to not allow the user to connect and directly access the LLDB environment, because of failed log-in attempts. See $LEASEPAKD_LOCKOUT
.
init
and services started by init
. If a service has a file in /var/lock/subsys/
, then this indicates to init
that the service is running, so that init
will not start a duplicate instance of the service; if there is no file for the service in /var/lock/subsys/
, then init
will start the service. The starting and stopping of services is determined by the system's runlevel; certain services are required in certain runlevels, and others are not allowed. When init
transitions the system runlevel, it must end services that are running in the original runlevel and are not required in the new; likewise it must start services that are required in the new level that weren't running in the original.
$QMDIR
.
An item of footwear, often stylish, often rugged, that is characterized by having straps on either side of the leg opening of the shoe, to facilitate getting one's foot into it. It is in reference to these that the popular phrase "lifting oneself up by one's own bootstraps" was coined. In computer systems, when a computer is first started, it has to find its instructions for operation somewhere. These instructions are usually useful only to a particular type of computer, and are present with the computer hardware, waiting to be read and executed by the computer when it first runs.
These instructions typically tell the computer how to find the more elaborate instructions that comprise the operating system, and thus came to be called 'bootstrap instructions', whereby the computer was able to lift itself up by its own efforts to a higher level of usefulness. And thus, 'to boot' a computer is to turn on or reset the computer, such that it again accesses those bootstrap instructions, and on loading the operating system, lifts itself up to become a useful tool. 'boot' has been extended to quite a number of ancillary terms in computer parlance, with the meaning, "initial instructions" or "initial capabilities".
The build ID is different for every iteration of the build system. Each time time the build system completes a cycle, the build sequence is incremented. The sequence increments once per cycle when that cycle produces a sequenced object. The sequenced objects are the LeasePak link libraries, and the LeasePak drivers themselves. By keying the sequence number to the production of an object, we are guaranteed that no two instances of the same objects will have the same sequence.
The build ID is made up of the release in #.##. format (for example 7.70), plus "." plus the 4-digit build-sequence.
init
services, such as the Queue Manager start-up files. See svcctrl. See the Linux man page for chkconfig
and service
.
cleanse_s7
, and also by cron
.
sh
style shells and the csh
style, the basic order of commands is the same: {command} [param] [param] [...]
, that is, the name of the command and a list arguments, or parameters, for the command to work with. There are control structures available in most shells, which conditionally execute commands arranged in blocks, based on the current state of the program's environment.
$QMDIR/library/Config
. This file contains the primary settings for tailoring the Queue Manager to the site's needs.
crontab
, which defines jobs to be run at specific times or inetervals. In LeasePak it is used to automatically run the Queue Manager cleanup
program several times a day.
cron
.
.msirc
extension are designed to be compatible with both sh
and the csh
, the NetSol scripting libraries are written and executed as sh
programs. There is a slightly more sophisticated version of csh
, called tcsh
.
$udata
directory.
$SRVADM
. This role is empowered to allocate disk resources to LLDBs, and to add users to the DBMS.
sysdba
; in Sybase it is called sa
. Both roles are sometimes called DBAs.
lease /util 112
.
db_add_login
, the ability to access the given environment's LLDB, by assigning him or her to the DBMS group (role) msi
or msir
. If the user is to be a report user, then msir
should be used.
db_add_user
.
db_add_user
command. The group for update users is msi
, for read-only users it is msir
.
$SYB_AUTODBO
If $SYB_AUTODBO is set to N, then db_create
will ask the operator to enter the name of an existing Sybase user to be assigned the role of DBO. If $SYB_AUTODBO is set to Y, then db_create will create a new Sybase user with the same name as the LLDB (and prompt for a password) to be the DBO. See Environments & Databases. This behavior in Sybase then emulates the situation in Oracle. It is strongly recommended that $SYB_AUTODBO
be set to Y.
db_create
which table space is intended to be the source of the space needed by the LLDB. It is recommended that the system administrator adopt a naming convention for Oracle tablespaces that makes the database to which a dedicated tablespace belongs unequivically clear. See Naming Conventions.
start_queues.com
file, and any output device can specify that its output be formatted for a defined form.
/home
, it is the user's working directory upon logging onto the host. LeasePak uses this as the default location for many reports and other files read and written by LeasePak.
This term is used in at least three contexts in LeasePak.
Host may refer to a hardware computer server, such as the DBMS Host or the application host or a combined host, or a split host. More generically, any computer server system can be called a 'host', and is usually qualified with the nature of the capabilities that the host provides, such as 'DBMS', or 'application', or 'internet', etc.
Host may also refer to a LeasePak environment configured to accept visitor environment connections. See Environments & Databases.
Host may also refer to the capabilities connected to a proxy user in an implementation of the Shared User module; users using the proxy are said to be hosted users.
host_v77a_rt.*
. During the installation of LeasePak, SETUP asks the administrator for various locations and preferences; these then guide the installation process, and also determine all of the OS environment values for the users of LeasePak. The answers to this "interview" are stored in $CFGDIR/relscfg.msirc
. Then another process (cfg_gen
) combines these answers with skeletal structures from NetSol, and produces 3 shell start-up files, named "HOST_v99x_rt.*" where "HOST" is replaced by the hostname of the server or cluster where LeasePak is being installed, and plus the LeasePak release version, and "*" is replaced by "msirc", and "com", and "lpkd". These 3 files are then available to users who successfully log into the application host via a shell login (the "*.msirc" file), via a client LeasePak session from a network PC (the "*.lpkd" file), or via jobs running on the batch queues (the "*.com" file). See also host.
HOST_v99x_rt.*
.
init
is the primary process of a Unix/Linux system. It is responsible for the inception and termination of all user and system processes. In particular it insures that services are running or not running at appropriate times.
A service provided by a computer system to other computer systems to which the server may be connected via networking. A service implies a location (a port on the server, a communications protocol, such as TCP/IP so that systems needing a service can communicate their needs to the server, an application notation that provides the meaning to the protocol. A client requests the published service it needs from the server, establishing communication with it, and sending it its request. The server responds with the requested data. A single transaction may encompass a very small or very large number of such exchanges.
LeasePak advertises two particluar internet services, leasepakd
and mpowerd
. Both of these result in ongoing conversations between the client and the server.
cleanup
must be run nearly hourly, typically through cron
leasepakd
is an internet service that provides qualified users with connections to an instance of LeasePak.
setup_new_env
), and a working LLDB (db_create
, loaded (see db_restore
with level7 data, and a lease booked, and an EOP run.
rsc
, is a LeasePak security record. It contains flags for allowed menu optons, ranges of values to be validated against, the RSC password for the Shared User
module, etc. A user is not a LeasePak user unless he or she has a LeasePak Security Record
LeasePak Supervisor -- Although the site can assign this role to $NSTADMIN, $NSTADMIN cannot change its own environment (or the environment of $NSTDBA) by using change_env
, so NetSol recommends creating a separate user, such as lpadmin, as the LeasePak Supervisor. This user performs software administration tasks such as adding new LeasePak users into the Security [U0706] update, submitting batch files, running End of Period, and using programs in lease /util, as well as general system configuration through refU0712 and the tracking module updates.
See LeaasePak Supervisor for details on this important role.
lease /util
nnn, where nnn is the 3-digit utility number.
lplicense.dat
, located in the $TOPDIR/exe/syb
or $TOPDIR/exe/ora
directory.
etc
directory.
leasepakd
is asssigned to wait for connection requests. Set in SETUP
, in response to the question TCP port assignment for leasepakd inet daemon [####].
leasepakd
(see).
HP-UX
, Solaris
, and Linux
are the operating systems that can support LeasePak.
oracle
.
/etc/group
. They are part of the server security structure. Each group has a group name and a GID. All LeasePak users must have $NSTGROUP
as their primary login group.
A word or phrase known only to persons authorized to access certain data or resources; the keepers of this data or resource require that the person prove their authority by providing the password. LeasePak uses passwords to arbitrate access to almost every function it provides. The database and the database system are protected by multiple passwords arbitrating access to multiple resources. The hosts on which LeasePak resides are also protected by multiple passwords to access multiple resources.
See client string password, Unix string password, SQL server string password, RSC string password, translated password.
SETUP
question Primary DBMS in this release.
/etc/passwd
file. This is the primary login group. Membership in secondary groups is not denoted in /etc/passwd
, but is instead denoted in the file /etc/group
. While the primary login group must be in /etc/group
, the users who have this group as their primary login group, should not be listed in /etc/group
, as their membership is established by /etc/passwd
. Secondary group membership only should be placed in /etc/group
.
DEVINIT
in the $QMDIR/library
directory. This represents the hardware the queeu Manager expects to find, allowing it to remain true to its DCL roots. The disk and null entries are generic, but each print queue must have its device in DEVINIT
.
$QMDIR/library
, that stores the queue job limit in the assignment of $QLIM=$QMJOBSPERQ
. $QMJOBSPERQ
is set when the administrator runs SETUP
in response to the prompt, "Number of simultaneous jobs to allow for per queue[10]".
jspctl
start_qmgr.com
, start_queues.com
, and stop_qmgr.com
.
init
when the system enters runlevel 1 (single user mode).
init
when the system enters runlevel 3 (multi-user mode).
The term role is used in a number of different contexts in LeasePak.
Generally, in this System Administration Guide, role is referring to a LeasePak role, unless otherwise specified.
A script is a type of program, written in a textual programming language, such as sh or awk or perl, etc. These are considered to be text files, even though they may be executable. They are not compiled into binary programs like C or BASIC or COBOL might be, but remain as text. The basic structure of a script is that each line is potentially something that could be typed at a command prompt; the cumulative effect of those command lines is the effect of the script.
The individual command lines in the script are executed in sequence, unless special constructs (if
,while
, etc) direct the flow to some other command line.
security authority
.
$SRVADM
role. In order for a less privileged user to have this authority, perform the procedure at Granting Security Authority.
/etc/services
or /etc/init.d
.
$CFGDIR
, in a file named relscfg.msirc
.
leasepakd
, or mpowerd
running on it. When leasepakd
discovers that it is running on the shared port, it treats incoming connection requests as hosted users, and thus spawning drivers running under the proxy user's UID.
sh
: the traditional, original program from Bell Labs, and the modern, updated version called the POSIX shell. This is the form most oten seen nowadays. All of NetSol's scripts distributed with LeasePak, except for the cross-shell-compatible msirc shell start-up files are actually written in the POSIX shell.
A shell is a command-line interpreter that provides a means of controlling the under-lying operating system. There are two methods for doing this: the first, interactively entered commands, typed by an operator, whose action is monitored by the operator, all in real time; the second, scripts, or batches of pre-prepared commands, are entered into text files, and then the shell could execute the commands sequentially at full speed, and the operators could review accumulated output from these batches and determine if the intended results were obtained.
In Unix and Linux, there are a number of shell utilities that have been written, some succrssful, and others perhaps less so. These include: sh, ksh, bash, csh, tcsh
. Wikipedia lista 11 different shell programs in its article on operating system shell programs: Bourne shell (sh), POSIX shell, bash, csh, tcsh, Hamilton C shell, Scsh, ksh, pdksh, zsh, ash
for Linux and Unix. None of these, besides sh, ksh, bash, csh, and tcsh
, have been tested by NetSol.
nst_qm_{ID}99x
script. It starts the system spooler jspctl
.
nst_qm_{ID}99x
script. It starts the qmgr
processes, one per queue, to manage them.
nst_qm_{ID}99x
script. It stops the system spooler jspctl
, which in turn tells the individual qmgr
processes to terminate.
service
and chkconfig
commands in Linux. See the program header for more information at $ubin/svcctrl
;
jspctl
is the Queue Manager's controlling program. It directs the work of the individual queues.
FTP
, NFS
, etc. Some are not allocated. Among the many allocated ports, there are a number that are not in use, even though allocated. LeasePak and mPower allocate ports based on the release number, for example, 6400 for v64a
, and 6500 for v65a
. If these assignments are causing conflict with other packages, then the administrator will have to redirect the conflicting software, or give different numbers for LeasePak in SETUP
.
/etc/passwd
file.
/etc/passwd
, a DBMS user table, LeasePak's RSC table. Each user is given a unique UID within /etc/passwd
.
vi
(called vim on Linux) is a sophisticated full-screen text editor. While it can be quite complicated, its basic command set is very simple and easy to learn. It is designed to work with almost any kind of character terminal. It is particularly sensitive to the value of $TERM.