Installing a binary distribution

In this document we explain what you need to do to install or upgrade a working MillScript system from a binary distribution.

First, obtain a binary distribution from the sourceforge file release page. Now you can proceed with either installing for the first time, or upgrading an existing installation:

Installing for the first time

The downloaded archive unpacks into a folder called "millscript" in the current directory. For the purporses of this guide, we'll assume you've unpacked the archive in /usr/local, which will create a new directory /usr/local/millscript. The MillScript system depends on an environment variable called millscript, which should point to the directory created when you unpacked the distribution. e.g.
export millscript=/usr/local/millscript

You must now ensure that the correct file permissions are set for the various executables provided by the system. This can be done automatically by executing a PERL script. e.g.

perl $millscript/bin/fixpermissions

The fixpermissions script will display a message indicating which version of MillScript you have just installed, e.g.

System version: 9.8.0

At some point you'll need to understand MillScript. There is a MillScript Language Summary and a tutorial How to Make Web Sites with the Toolset. Read and try to follow the examples provided in these guides. These are graded to provide a useful grounding the intended use of the Toolset.

Upgrading existing installation

Upgrading is designed to be easy as the system is designed to support multiple concurrent versions. Note that upgrading makes the version you are unpacking the default.

Again, assuming you have previously installed MillScript in /usr/local/millscript, you should unpack the new distribution in /usr/local which will write the new files into /usr/local/millscript.

Because you have previously installed MillScript, you should already have the millscript environment variable set. Hence we can proceed to ensuring the file permissions are set correctly by running the fixpermissions script again. e.g.

perl $millscript/bin/fixpermissions

You should see a message indicating the new version you have installed, which has also been made the default.