envmng/ReadMe.txt

# $RCSfile: ReadMe.txt,v $
# $Revision: 1.4 $
# $Name:  $
# $Date: 2009/01/13 17:30:14 $
# $Author: agibert $





Welcome to EnvMng (Unix shell Environment Manager) !



This release of EnvMng supports the following OSes:
        - AIX 5.3,
        - HP UX 11.0.

EnvMng is licensed under the GNU GPL Licenses.
For more information, please read the corresponding source file headers.
The license details can be found in the GNU-GPL.txt and GNU-FDL.txt files.



envmng installation
-------------------------------------------------------------------------------
- rename    ~/.profile                      into ~/.profile.old
- rename    ~/.dtprofile                    into ~/.profile.old
- rename    ~/.login                        into ~/.login.old
- copy      <EnvMngDir>/etc/skel/.profile   to   ~/.profile
- copy      <EnvMngDir>/etc/skel/.dtprofile to   ~/.dtprofile
- soft link ~/.bash_profile                 to   <EnvMngDir>/etc/envmng_rc

Eg. <EnvMngDir> can be /usr/local



envmng usage
-------------------------------------------------------------------------------
Usage: envmng   [COMMAND] [OPTION]
  -b,  --bash    [<Id>]    [norc]       switch to bash and set id to <Id>
  -k,  --ksh     [<Id>]    [norc]       switch to ksh  and set id to <Id>
  -S,  --setid    <Id>     [norc]       set id to <Id>
  -R,  --reset    <EnvList>             reset envlist to <EnvList>
  -a,  --add      <Env>    [head|tail]  add <Env> in envlist head or tail
  -d,  --del      <Env>                 del <Env> from envlist
  -p,  --profile [<Env>]                do envlist or <Env> profile
  -r,  --rc      [<Env>]                do envlist or <Env> rc
  -s,  --status                         print status
  -l,  --list                           list Id(s), EnvList(s) and Env(s)
  -li, --listid                         list Id(s) and EnvList(s)
  -le, --listenv                        list Env(s)
  -h,  --help                           print this help
  -V,  --version                        print version



envmng usage example
-------------------------------------------------------------------------------
- print curent env status:           "envmng -s"
- list ids, envlists and envs:	     "envmng -l"
- switch to dtarget-gnu  env:        "envmng -S dtarget-gnu"  or "env-dtarget"
- switch to d2target-gnu env:        "envmng -S d2target-gnu" or "env-d2target"
- switch to ksh:                     "envmng -k"              or "env-ksh"
- switch to bash in dtarget-gnu env: "envmng -b dtarget-gnu"



user env customization
-------------------------------------------------------------------------------
- copy <EnvMngDir>/etc/envmng.d/env_template to   ~/.envmng_user
- add user customization                     into ~/.envmng_user



.profile template example
-------------------------------------------------------------------------------
clear
. /usr/local/etc/envmng_profile d2target-gnu bash
#. /usr/local/etc/envmng_profile d2target ksh



.dtprofile template example
-------------------------------------------------------------------------------
. /usr/local/etc/envmng_dtprofile d2target-gnu bash
#. /usr/local/etc/envmng_dtprofile d2target-gnu ksh



EnvMng Id List (<EnvMngDir>/etc/envmng_id)
-------------------------------------------------------------------------------
# HP/UX Example
dtarget:	user:shell:imr:ora920a:tux80:mqm-64:dtarget:snav:pvcs:purify:hpux-64:hpux-system:gnu
dtarget-gnu:	user:gnu:shell:imr:ora920a:tux80:mqm-64:dtarget:snav:pvcs:purify:hpux-64:hpux-system
d2target:	user:shell:imr:ora817a:tux80:mqm-32:d2target:snav:pvcs:purify:hpux-32:hpux-system:gnu
d2target-gnu:	user:gnu:shell:imr:ora817a:tux80:mqm-32:d2target:snav:pvcs:purify:hpux-32:hpux-system

# AIX Example
migtt2:		user:shell:ora10:mqm-64:migtt2:java14:vac:aix-64:aix-system:gnu
migtt2-gnu:	user:gnu:shell:ora10:mqm-64:migtt2:java14:vac:aix-64:aix-system
migtt2-64:	user:shell:ora10:mqm-64:migtt2:java14:vac:aix-64:aix-system:gnu
migtt2-g64:	user:gnu:shell:ora10:mqm-64:migtt2:java14:vac:aix-64:aix-system
migtt2-32:	user:shell:ora10:mqm-32:migtt2:java14:vac:aix-32:aix-system:gnu
migtt2-g32:	user:gnu:shell:ora10:mqm-32:migtt2:java14:vac:aix-32:aix-system



Protected varibles (<EnvMngDir>/etc/envmng_protvar)
-------------------------------------------------------------------------------
DISPLAY
DT
ENVMNG_ID
ENVMNG_LIST
MAIL
LOGNAME
HOME
PS1
PS2
PS3
PS4
PWD
SHELL
SHLVL
TERM
TZ
USER
_



Protected aliases (<EnvMngDir>/etc/envmng_protalias)
-------------------------------------------------------------------------------
envmng



d2target-gnu Env Id default aliases
-------------------------------------------------------------------------------
alias env-bash='envmng --bash'
alias env-d2target='envmng -S d2target-gnu'
alias env-dtarget='envmng -S dtarget-gnu'
alias env-ksh='envmng --ksh'
alias envmng='. /home/dtarget/envmng/bin/envmng'
alias ll='ls -la'
alias ls='ls --color=auto'
alias snav='snavigator'
alias xem='xemacs'





Enjoy it!

Your EnvMng Team.

arnaud@rx3.net
http://www.rx3.org/dvp/?dvp=envmng