Perforce Version Copy Utility (VCP) Build Installation Instructions
THESE INSTRUCTIONS ARE FOR SOLARIS x86 and sparc
The build installation scripts and structure provide a means for creating
repeatable builds of the vcp binaries.
TODO: Extend scripts so they can also be used to install the VCP module
into an existing version of Perl, with or without PAR.
System Requirments
You must have the following software installed on your system in
order to install and build the vcp binary:
- GNU wget, expat, gcc, libgcc, libiconv
If you don't have wget on the solaris platform, the use anonymous
ftp to get it:
ftp ftp.sunfreeware.com
Username: anonymous
Password: <hit return>
cd pub/freeware/{intel|sparc}/{8|9} // Platform and OS version
bin
get wget-1.9.1-sol{8|9}-{intel|sparc}-local.gz // Platform and OS version
quit
gunzip wget*.gz
pkgadd -d wget*
Make sure /usr/local/bin is in your path:
PATH=/usr/local/bin:$PATH
export PATH
Retrieve and install the required packages as root using:
mkdir packages
cd packages
sh build-solaris.sh
Creating a clean build of vcp binary on a Solaris platform
% cd BUILD
% sh retrieve.sh # Retrieves about 17M bytes of files
% sh build-modules.sh
% # Copy the VCP release into the Tars directory
% # e.g.: cp ../../dist/VCP-0.9.tar.gz Tars
% sh build-vcp.sh
You do not have to build perl since you're installing it from
a prebuilt package. (Windows is similar in that it uses Active Perl
as the base perl upon which the rest is built)
At this point you will have a fresh Perl installed with only the
modules requires for PAR and VCP, VCP will be installed, and
the new binary and html files installed into the dist directory
File List:
Policy.sh - This file is configuration file for building Perl
build-modules.sh - This script builds, tests, and installs required modules
build-perl.sh - This script builds, tests, and installs Perl
build-vcp.sh - This script builds, tests, and installs VCP
gen-list.sh - This script generates the list of required modules for retrieval
retrieve.sh - This script retrieves the requires modules from CPAN
PodToHTML.Pod.HTML_Elements.pm.patch - Patch file for HTM_Elements.pm
vcp.bin.build_vcp_executable.pl.patch - Patch file for build_vcp_executable.pl
vcp.bin.vcp.patch - Patch file for vcp
Tars/modules.list - List of required modules
par-deps.list - Ordered list of required modules for PAR
vcp-deps.list - Ordered list of required modules for VCP
VCP-0.90.0.tar.gz - VCP 0.90 release
Directory Structure:
Tars/ - Contains the modules.list file and all retrieved module tar bundles
PerlModules/ - Installation directory for Perl module extensions
tmp/ - Temporary working directory
dist/ - Distribution location, will contain built binary and html pages
html/ -- Directory of VCP documentation
vcp-VER-kernelinfo.exe.gz -- Binary for specified platform
Creating a new module.lists file
% sh gen-lists.sh
This script will check for the latest releases for all of the required
modules and add in the reference URI into the modules.list file for retrieval.