Basic Configuration
The script is available with a full help utility. Prior to executing the script, the user should have the PRPC software baundle extracted to a directory on their filesystem. While the script can get the latest Ubuntu distribution and the oracle lite / developer distribution for Ubuntu, we strongly recommend downloading these separately in advance of the install as well and making them available on the local filesystem of the machine where the script will be run. Once the pre-requisite software has been downloaded to create the bundle, simply execute the script with the -h option and a full listing of all available options will be printed to stdout.
Usage: mkUbuntuPRPCInstall.sh [OPTION]
-d Filename for the target ISO image for Ubuntu install with PRPC
and Oracle 10G Express Edition.
-D Database name for PRPC installation - must previously exist -
defaults to XE
-f Specify format of vm image if -v is specified. Please refer to the
documentation on qemu-img for information on formats. Values may be
one of the following: raw, qcow2, vmdk
-h Print command help information
-H Hostname to be set on the target system
-i Interactive mode - confirm all settings (requires readline)
-m Path to the media or directory containing the PRPC distribution
This may be either a directory or an ISO image.
-o Location of the oracle debian package to use for the installation
-O Oracle system user password
-p Target directory into which the debian package created for the
PRPC install will be written
-P Password for the database authentication for PRPC
-S System level password for the prpcadmin user
-T DB tablespace name for PRPC installation - will be created if it
doesn't exist
-u Location of the Ubuntu ISO image to use as the baseline for
creating PRPCbuntu
-U User name for database authentication for PRPC
-v Filename for the target VM image into which PRPCbuntu will install
-V The version of PRPC to bundle - do not use the '-' character
-x Only create PRPC package - skip creation of the Ubuntu ISO
This script file creates a Ubuntu distribution with automated installation
and configuration of a fully functional PRPC environment leveraging an
Oracle 10g XE RDBMS as the backend database and the native Tomcat install
in a stock Ubunutu distribution as the J2EE application server. In addition,
the partners repository will also be activated and the Sun JDK will be
installed as part of the system configuration
Creation of a PRPC VM can be completed in 5 easy steps after ensuring
the PRPC software distribution is accessible from the shell environment:
1. Execute this script - accept most default settings except the location
of the Ubuntu ISO and the PRPC distribution. The Ubuntu ISO location is
where it will be saved - PRPC is where the PRPC directory exists on
your system
2. Install PRPCbuntu to a clean VM using the prpcbuntu.iso image as the
CD / DVD to boot / install the system - it should be located in:
~/tmp/prpcubu/prpcbuntu.iso
4. Accept all defaults going through the install
5. When complete, reboot with the same prpcbuntu.iso mapped as the CD drive
6. Log in as prpcadmin/changeme and execute the following command:
# sudo /etc/init.d/prpc-firstrun start
Examples
To create only the PRPC debian installer in the current user’s home directory
from a dvd mounted to /mnt/dvd, skipping the Ubunut ISO creation:
# sudo mkUbuntuPRPCInstall.sh -x -p ~ -m /mnt/dvd
To create a full ISO image using a local software repository containing Ubuntu and Oracle, automatically create a VM image in raw format of the full Ubuntu runtime configured to run PRPC with passwords and users for the OS access, DB connections, and tomcat administration preconfigured:
# sudo mkUbuntuPRPCInstall.sh -d ~/prpcbuntu61sp1.iso -D prpc61sp1 -V 61sp1 -m /mySoftware/PRPCunzipped -u /mySoftware/ubuntu-10.04.1-server-i386.iso -o /mySoftware/oracle-xe_10.2.0.1-1.0_i386.deb -U prpcadmin -P prpcadmpasswd -T prpc61sp1 -p ~ -f raw -v prpc61sp1VM.raw