README for ldoms.bash script version 1.3.1
Date: 17th June 2008

Usage: ./ldoms.bash [-h] [-t <timeout>] [-z <zfs pool name>]
[-n <full pathname to ldom_clone>]
Where:
-z <zfs pool name>
is the name of the ZFS pool where the ZFS file system
called ldom_clone is installed.
The ZFS file system ldom_clone will be cloned for the new LDOM;
If not given the script will try and find the ZFS pool.

-t <timeout>
optional argument but if given must be a timeout in secs between
1 and 60, this being the timeout on the main menu refresh
Without this argument the default is 10 secs

-n <full pathname to ldom_clone>
README for ldoms.bash script version 1.3.1
Date: 17th June 2008

This script is a demonstation of Logical Domains
Domains can be created, and deleted easily, by
cloning an existing LDOM

Usage: ./ldoms.bash [-h] [-t <timeout>] [-z <zfs pool name>]
[-n <full pathname to ldom_clone>]
Where:
-z <zfs pool name>
is the name of the ZFS pool where the ZFS file system
called ldom_clone is installed.
The ZFS file system ldom_clone will be cloned for the new LDOM;
If not given the script will try and find the ZFS pool.

-t <timeout>
optional argument but if given must be a timeout in secs between
1 and 60, this being the timeout on the main menu refresh
Without this argument the default is 10 secs

-n <full pathname to ldom_clone>
optional argument will cause the script to use ordinary filesystems,
if this option is used the full pathname to ldom_clone must be given
BE CAREFUL - this option will cause the ldom creation to take a long
period of time - in the order of 20 mins.

[-h] optional argument and will output this message

The tar file ldom.tar has four files in it

1) ldoms.bash - ldoms script
2) functions.bash - functions called by ldoms script
3) reserved_ldom - file containing names of all the ldoms treated as reserved
- so cannot accidentaly be deleted .
4) This README

To run the script run ./ldoms.bash

By default without any options specified, you need to have a zpool containing
a file system called ldom_clone in that file system should be a file called
os which is a bootable solaris image.

eg

/zpool/ldom_clone/os

You can specify which zpool to use with the -z <zpool name>

If you do not use zfs there is an option to the script to force it to use
standard filesystems, in this case use the -n <path to ldom_clone directory>

eg

./ldoms.bash -n /no_zfs_fs/ldom_clone

The file "reserved_ldom" is used to hold the names of various
logical domains that you do not want to be deleted.

The script has two variables that can be customised and are normally as below

ORIG_LDOM_NAME="ldom_clone"

This variable is used as the name for the logical domain (file system) to clone

OS_IMAGE="os"

This variable is the name of the os image file in the file system that
is cloned. This should be a bootable file system image.
In fact it can be any file and could simply be a file made with mkfile.
If it does not have an os image then any ldoms made using the script will
need to have Solaris installed into the ldom.