Install Program Files


Note: The Deltanji Program Files must be installed on both the database server that will host your Deltanji repository and the web server that will host the Deltanji Portal. If the database server and the web server are two different machines, then Deltanji Program Files need to be installed on both machines.

Note: When transferring the zip file containing the Deltanji Program Files between computers make sure it is handled as a binary file (eg if using FTP ensure bin mode is used rather than ascii mode).

See below for Operating System specific notes that may help you with this procedure.

The software is normally supplied in a zip file. To install it:

1. Copy the zip file onto the target server

2. Unzip the file into a temporary directory

3. Move the unzipped files into your chosen installation directory.

4. Next, install Deltanji code.

Windows


Suggested Installation Directory

We suggest the following directory for your Deltanji installation:

C:\Deltanji\

Although it is possible to install Deltanji within C:\Program Files, the default permissions within that folder may complicate the procedure.

UNIX/Linux


As detailed above, it is preferable to transfer the zip file to the target server before unzipping it in situ in a temporary directory, e.g.

$ unzip -a deltanji.zip

Provided your unzip utility is competent this procedure ensures that text files distributed in the zip with Windows style line endings are converted to have UNIX/Linux style ones.

If unzip isn't installed, you may be able to use Java's jar utility thus:

jar -xvf deltanji.zip

If this doesn't work it is possible that jar is available but just not on your path. Locate it and then either add it to your path, e.g. export PATH=$PATH:/usr/java6/bin or run it using the full path.

If this is not possible, and the zip is instead unpacked on Windows, make sure that the subsequent transfer of files to the UNIX/Linux environment does the correct thing with text files (e.g. .css, .js, .htm), converting their linebreaks from Windows-style to UNIX/Linux-style.

Suggested Installation Directory

We suggest the following directories for your Deltanji installation:

/usr/deltanji/

OpenVMS


As detailed above, it is preferable to transfer the zip file to the target server before unzipping it in situ in a temporary directory, e.g.

$ UNZIP DELTANJI.ZIP /BINARY=AUTO /TEXT=AUTO

The Info-Zip version of UNZIP.EXE is available from http://www.info-zip.org/UnZip.html

If this is not possible, and the zip is instead unpacked on Windows, make sure that the subsequent transfer of files to the OpenVMS environment does the correct thing with text files (e.g. .css, .js, .htm).

Unzipping the kit on OpenVMS typically creates the text files with Variable record format. On Caché it is necessary for these to be converted to Stream format. To achieve this Deltanji includes a file called VAR_TO_STREAM.COM which is a DCL procedure that scans a directory and its subdirectories, converting files having Variable record format. The conversion uses the FDL specification in VCM_STREAM.FDL. To invoke it, switch to the directory containing these two files, and then invoke the procedure as shown below. For example, if the COM and FDL files unzipped to DISK$MAIN301:[DELTANJI] the commands are:

$ SET DEF DISK$MAIN301:[DELTANJI]
$ @VAR_TO_STREAM DISK$MAIN301:[DELTANJI...]*.*

Each converted file will be reported. The unconverted files will remain with predecessor version numbers.

Suggested Installation Directory

We suggest the following directories for your Deltanji installation:

disk:[DELTANJI]

Next Step


Next, install Deltanji code.