BMC VM Linux Management and Archiving Code

137 lines (136 with data), 7.1 kB

#VMLMAT PARM FILE
# # #
# comments must have the first char a pound sign 
# This is a valid comment  
# # #
# use a minus sign to signal a variable defined in a specific line
# Format is: minus_sign single_whitespace variable_name single_whitespace variable_value
# # #
# Use only proper comments or variables in this file with no blank lines
# # #
# You must install this parmfile and the copy server scripts in /var/clone
# Because these paths like wwwpath and smbpath refer to the same server therefore the webserver and copy server
# are specified as the same server. 
# wwwpath variable is the location of the web pages. This must remain fixed after installation and operation
# and is of the /dir/dir/ format beginning with slash and ending with same.
- wwwpath /srv/www/htdocs/
# # #
# smbpath variable is the the path of where the zauthfile is located for 
# smbclient ftp get (auth.php user validation). Should have two slashes.
- smbpath //lnxs390.bmc.com/zauth
# # #
# arcpath variable is the the path of where the archive respository is located 
# and is of the /dir/dir/ format beginning with slash and ending with same.
# Note that /var/clone/bks390 is hardcoded as /mnt/archive and would need to be updated if 
# this utility is to be run. 
- arcpath /mnt/archive/
# # #
# case of hostname. You should set this only at inital install and never change it after that. Normally hostnames 
# are lowercase. By the way, in this system the usernames for directories will always be forced to uppercase so it 
# will not conflict with existing directories in the webserver. Specify only lower or upper as a value. Mixed case 
# hostnames are not allowed. 
- case lower
# # #
# domain variable is the windows active directory or NT domain that smbclient in auth.php will authenticate against. 
- domain adprod
# # #
# bvm variable is the hostname for the build server that build your standard images 
- bvm lnxbld
# # #
# bvmip variable is the ipaddr of this build server
- bvmip 172.30.31.18
# # #
# cvm is the control vm guest name
- cvm lnxv390
# # #
# samail is the email address for the system administrator
- samail john_doe@yourCompany.com
# # #
# notify is the decision to have co-owners of hostnames notified if the status of the machine is changed.
# example a user is bringing up/down backup/restoring the machine or changing ownerships.
# either yes or no (only yes will notify)
- notify yes
# # #
# sender is the email address for the root of your webserver
- sender root@lnxs390.bmc.com
# # #
# mdlink is the address of the target minidisk the CVM has linked to the copy server. 
# This device will be brought online/offline to the copy server. This value was specified in the 
# rexx script BUILD.EXEC that runs on the CVM.
- mdlink 209
# # #
# devname is the mdlink linux device that will be processed for the backup/restore.
# It is important to calculate the relative /dev/dasdx value according to addresses used. 
# if the copy server's /etc/zipl.conf has dasd=201-20F then for a 209 address it would be /dev/dasdi
# and for a 20A address it would be /dev/dasdj 
- devname /dev/dasdi
# # #
# rpart specifies if the installation wants their client VM Linux machines to use a linux partition
# on their first volume used for the Linux / mountpoint. This affects the device name in /etc/fstab
# of the standard images and the client VM machines for the Linux / mountpoint. For example: /dev/dasda 
# or /dev/dasda1
# Choose 1 if partitioned or 0 (zero if not partitioned). 
- rpart 1 
# Note the code uses this logic for backups when dealing with the very first volume assumed
# to be the Linux / mountpoint:
# We have to hard code the volyx value since we have not read the fstab yet.
# Therefore, we will use the values from parmfile rpart and first entry of atab
# with the device prefix of /dev/dasd
# To setup mdf (minidisk from) address, we will use the parmfile mdlink and the first entry of ntab to
# correspond with the the first atab entry. 
# # #
# fsmake is the type of make file system you want for your linux clone.
# choose something like mke2fs or mkfs.ext3 etc
- fsmake mke2fs
# # #
# diskfmt is the decision to allow the script to dasdfmt and make partition before each restore.
# this is useful if you change volume size and/or you want linux to format/partition the volume.
# if the volumes are already formatted/partitioned and doesn't change size 
# then specifying no which will speed up the restore process. Warning must be sure that new VM are 
# already formatted and partitioned before changing from yes.
# specify either yes or no (only yes will allow)
- diskfmt yes
# # #
# mailgen is the number of daily generations to keep of root's mailbox for audit/diagnostic purposes.
# used by /var/clone/clraudit called from crontab
# choose a number that conserves space but allows the admin a chance to find a problem.
- mailgen 8
# # #
# stdcol is the number of columms for the index.php list of standard image links.
# choose a number that works best for your main menu and reduces scrolling requirements.
# Must be a number 1 or greater. The number zero will cause an error in index.php.
- stdcol 2
# # #
# mvol specifies if multivolume support is allowed.
# If mvol is yes then the user accepts that only like client VM configurations are interchangeable with backups.
# A 3 volume system can only be restored to 3 volume systems of the same device names. Example:
# A backup of /dev/dasda1, /dev/dasdd1, and /dev/dasdf1 can only be restored to a system with 
# this same configuration.
# If parmfile mvol is no then only single volume support is given and all VM configurations could therefore be the 
# same and interchangeable. Example: all systems have a single volume as device /dev/dasda1
- mvol no
# # #
# The following is used in multi-volume support but also applies to single volume systems as well.
# atab is the drive letter "y" of the formatted and partitioned device name /dev/dasdy1.
# This requires your standard images to have /etc/zipl.conf  
# specify a dasd=xx1-xxf range of device numbers. Should be 15 contiguous hexadecimal addresses defined.
# default 15 drive letters of /dev/dasdy1. Example: "a" is /dev/dasda1, the first drive letter.
- atab a,b,c,d,e,f,g,h,i,j,k,l,m,n,o
# # #
# ntab is the xxy minidisk address where xxy is hexadecimal and y is given below.
# default 15 minidisk numbers that get mapped to drive letters
- ntab 1,2,3,4,5,6,7,8,9,a,b,c,d,e,f
# # #
# reip is the switch that tells vmlmat that you want the sysadmin to have the privilege
# to re-ip a machine by submitting a restore request from a standard image but only 
# perform the change function inorder to re-ip the virtual machine. No restore will be done.
# this switch must say yes and the reipid must specify an authorized userid to perform this
# function.
# default no
- reip no
- reipid dummy
# qwait is the number of minutes to wait that all vmlmat requests are done by before determining 
# that the queue is stalled and the current request needs to be marked done and allow processing of 
# the queue to continue.
- qwait 15
# # #