Introduction
This document will walk you through the process for
installing Krypton onto a Windows workstation. The process
for installing to other operating systems will be very
similar, with the main difference being the way you set the
KRYPTON_HOME environment variable.
As nearly all of the Krypton Standard Library plugins are
implemented as Ant scripts, you'll probably want to setup
Ant as well. In fact, you only need to unpack an Ant
distribution somewhere on your workstation - you don't need
to set ANT_HOME because an environment is created by Krypton
for Ant every time Ant is invoked.
This also means that if you need to, you can use different
versions of Ant for different stages of your build. You can use a
clean distribution of Ant with no custom tasks installed, because
Krypton producers link custom tasks in and out as required. Again,
this means that if necessary you are able to run different versions
of the same Ant custom task in the same build.
Ant can be unpacked before or after you install Krypton
because it is not hooked in until you start to run builds
with Krypton. Krypton currently supports Ant versions 1.5.*
and 1.6.*.
Overview
Obtaining Krypton
Download your preferred binary distribution from the
distributions page. The most recent
Krypton distributions are always linked from the home page,
and the right side-bar as well.
Unpack
Unpack the Krypton distribution somewhere on your
workstation, say C:\Software\x17_sft_krypton_2_0_0_b1
Set Krypton Home
We need to define a new environment variable called
KRYPTON_HOME which is set to the path where we unpacked
the Krypton distribution, and we need to add
%KRYPTON_HOME%\bin to the system's search path.
If you've installed command-line tools such as Apache Ant
before, this process is likely to be very familiar.
- Right-click on My Computer, and select
Properties
- Click the Advanced Tab
- Click the Environment Variables button
- Under the System variables caption,
click the New... button.
- For Variable Name enter KRYPTON_HOME
- For Variable Value enter the path at
which you unpacked the Krypton distribution.
- Click OK to save the KRYPTON_HOME
variable
- Now locate the PATH environment variable in the
System variables list. Select it and
click the Edit button.
- At the end of the Variable Value field,
add %KRYPTON_HOME%\bin. Remember that
entries in the PATH must be separated by a semicolon.
- Click OK to commit the environment
variable changes, then click OK to
close the My Computer properties box.
Check Installation
To test your Krypton deployment, open a new command prompt
and enter the command to display Krypton's version:
> kr --version
your Krypton deployment has been successful:
| 
