Building a better world with people, process, & technology

PRPCbuntu© How To

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: [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:
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


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 -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 -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

Whitepapers & Presentations

Contact us for access

We are proficient in BPM delivery with hands on platform expertise in Pegasystems PRPC platform!