HP OpenVMS Systems
   
Ant 1.7 Field Test for OpenVMS

Readme File - Installation Guide and Release Notes

September 2008


Introduction
----------------------------------------------------------------

Apache Ant is a Java-based build tool, similar to make.

This kit is a port of Apache Ant 1.7 to the OpenVMS environment.  
This version of Apache Ant 1.7 has been modified from the original
Ant distribution found at http://ant.apache.org. The modifications
were required to allow for differences in behavior on OpenVMS.


Requirements
----------------------------------------------------------------

Software Requirements
---------------------

   - Java 1.5.0-3 or later
   - OpenVMS Alpha or Integrity server Version 8.2 or later
   - All level 1 ECO kits 
   - Latest pthread ECO kit
   - Latest CRTL ECO kit

Hardware Requirements
---------------------

   - Alpha or Itanium processor
   - Installation disk must be formatted as an ODS-5 disk
   - 1GB RAM (minimum) 
   - 600mhz processor (minimum) 


Web Download Instructions
----------------------------------------------------------------


  1.  Save the Ant 1.7 for OpenVMS self-extracting archive 
      (HP-VMS-ANT-T0107--1.PCSI_SFX_AXPEXE or HP-VMS-ANT-T0107--1.PCSI_SFX_I64EXE) 
      to a temporary location by choosing the option to save the 
      program to your disk.

  2.  If you are downloading the file to a Windows machine, move the 
      downloaded file to your OpenVMS machine using either using a shared 
      network drive or FTP. 

 
Installation Instructions
----------------------------------------------------------------
 

  1.  Expand the Ant for OpenVMS compressed EXE file 
      by entering one of the following commands, depending on 
      the platform on which you are installing the kit:

        $ RUN HP-VMS-ANT-T0107--1.PCSI_SFX_I64EXE ! for OpenVMS Integrity server
        $ RUN HP-VMS-ANT-T0107--1.PCSI_SFX_AXPEXE ! for OpenVMS Alpha

      Each EXE file contains the files HP-VMS-ANT-T0107--1.PCSI$COMPRESSED
      and HP-VMS-ANT-T0107--1.PCSI$COMPRESSED_ESW (the signed manifest file).   

  2.  Start PCSI, the utility that installs ANT 1.7 Field Test for OpenVMS
      by entering the following command.  (PCSI installs the
      PCSI$COMPRESSED file directly; you do not need to expand it.)

        $ PRODUCT INSTALL ANT

  3.  Follow the on-screen installation instructions. 

      To proceed with a default installation, press Enter/Return in 
      response to any other installation questions.

      Ant will be installed into PCSI$DESTINATION:[ANT_17]


Usage
----------------------------------------------------------------

  1.  The logical name ANT$HOME must be defined to use Ant 1.7 Field 
      Test for OpenVMS. The directories used in the following examples
      assume that Ant has been installed in the default location, 
      SYS$COMMON:[000000]. 

        $ DEFINE ANT$HOME SYS$COMMON:[ANT_17]

  2.  The symbol "ANT" must be defined, for example:

        $ ANT :== @SYS$COMMON:[ANT_17.BIN]ANT.COM

      Then the command "ant" can be used, for example:

        $ ant "-version" ! must quote DCL params


Sample OpenVMS Installation 
----------------------------------------------------------------
The following is a sample installation of Ant 1.7 Field Test for OpenVMS.

$ run HP-VMS-ANT-T0107--1.PCSI_SFX_AXPEXE
UnZipSFX 5.40 of 28 November 1998, by Info-ZIP (Zip-Bugs@lists.wku.edu).
  inflating: HP-VMS-ANT-T0107--1.PCSI$COMPRESSED
  inflating: HP-VMS-ANT-T0107--1.PCSI$COMPRESSED_ESW
$ product install ant

Performing product kit validation ...
%PCSI-I-VALPASSED, validation of 
DSA0:[SYS0.][SYSMGR]HP-VMS-ANT-T0107--1.PCSI$COMPRESSED;1 succeeded

The following product has been selected:
    HP VMS ANT T1.7                        Layered Product

Do you want to continue? [YES]

Configuration phase starting ...

You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.

HP VMS ANT T1.7

* This product does not have any configuration options.

Execution phase starting ...

The following product will be installed to destination:
    HP VMS ANT T1.7                        DISK$I64SYS:[VMS$COMMON.]

Portion done: 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100%

The following product has been installed:
    HP VMS ANT T1.7                        Layered Product

HP VMS ANT T1.7

    Post installation tasks


     1.  The logical name ANT$HOME must be defined to use Ant 1.7 for
         OpenVMS.

        $ DEFINE ANT$HOME <ANT Installation Directory>

     2.  The symbol "ANT" must be defined, eg

         $ ANT :== @<ANT Installation Directory>.BIN]ANT.COM

     Then the command "ant" can be used, for example

         $ ant "-version" ! must quote DCL params
$

Sample Post installation steps (If installed into the default destination):
----------------------------------------------------------------------------

$ @sys$startup:java$150_setup fast ! setup Java
$ def ant$home sys$common:[ant_17]
$ ant:==@sys$common:[ant_17.bin]ant
$ ant "-version"
Apache Ant version 1.7.0 compiled on February 22 2008