Notes

  • This software is still under development - use at your own risk.
  • This application requires Java 1.5 or higher.
  • Currently it only supports windows targets, but if there is interest it can be easily extended to Linux

Installation

(These instructions assume you have JDK 1.5 installed and in your path).

This install comes with a sample toolset for convenience. Because you won't have a tools repository set up yet, the tools won't be found in the repository so they'll be downloaded from the url specified for the tools in the toolset definition. Note, that this means about 16MB will be downloaded from the internet. After being downloaded they'll be stored with the installed tools and you can use this as the basis for your repository by copying it to your internal web server.

  • Unzip the tools installer download into an appropriate directory (TOOLS_INSTALL_DIR).
  • Open a command prompt in TOOLS_INSTALL_DIR
  • Now run installToolset.bat -d .\sample\tools -r file:.\sample\remote-repo -t sample

    You should see the following output, although there will be some delays as the archives are downloaded.

    ECHO is off.
    =====================================================================
    Standard Toolset installation
    =====================================================================
    
    Installer Initialised
     Tools home : .\sample\tools
    
    
     Installing toolset : sample
      Installing tool   : ANT
       Created wrapper  : ant.bat
      Installed tool    : ANT
      Installing tool   : CATALINA
       Created wrapper  : tomcat-start.bat
       Created wrapper  : tomcat-stop.bat
       Created shortcut : tomcat-start.bat
       Created shortcut : tomcat-stop.bat
      Installed tool    : CATALINA
      Created setup-env : setup-env-sample.bat
     Installed toolset  : sample
    
    Done.

    Note:

    • The archives are stored locally in sample\tools\local-repo
    • The toolset is installed in sample\tools\sample
    • The wrapper and setup environment scripts are in sample\tools\sample
    • Shortcuts are created in sample\tools\shortcuts
    • ANT and Tomcat are in sample\tools\sample\apache-ant-1.6.2 and sample\tools\sample\jakarta-tomcat-5.5.9 respectively

Next steps

An easy way to make the installer available to a team is to put the JRE 1.5 and the installer on a network drive. This way everyone can easily run it without installing anything - and thus get the tools they need installed.

  x:\applications\
              + jre-1.5\
              + tools-installer\

You may want to

  • set up your own internal tools repository - start by copying the contents of local-repo created above - put this in a tools-repo directory on your web server so the url becomes http://servername/tools-repo
  • create toolsets for your team based around projects or functions (such as utilities, common, programming etc).
  • create modification bundles for you toolset that configure the tools for your environment - for example adds applications to tomcat webapps, change the jboss log4j.xml etc.