Installing Solo Edition

This page documents a procedure that is generally suitable for installing the Solo edition of Deltanji into an environment running Caché 2009.1 or later, or equivalent instances of Ensemble or HealthShare. References to Caché hereafter apply equally to Ensemble or HealthShare.

Note that this procedure is not suitable for Caché instances that are already managed by Deltanji or by its predecessor product, VC/m.

1. Deltanji ships as a zipfile. Unzip it on the Caché host where you want to install Deltanji. Unzipping produces a single directory named Deltanji containing all the software.

2. Move the unzipped Deltanji directory to where you want the software to be located long-term. For example on a Windows host you might choose to place it at C:\Deltanji. We recommend you avoid putting it under C:\Program Files\ as this can cause permission issues during the installation.

3. Open a Terminal session in the local Caché instance where you want to install Deltanji. If Caché security is active, log in as a user such as SuperUser that has maximum privileges (i.e. holds the %All role).

4. You are now going to import and compile a class called Deltanji.Installer containing a classmethod that you will later run to create a database for the Deltanji repository and metadata. The Deltanji.Installer class can be loaded into any existing namespace. We suggest you use the USER namespace if it is available.

Using D ^%CD or similar, switch to the USER namespace.

Load and compile the class from the file Deltanji.Installer.xml in the directory where your unpacked Deltanji kit is located, e.g. D $SYSTEM.OBJ.Load("C:\Deltanji\Deltanji.Installer.xml","c")

5. Invoke the RunInstall method of the class you just loaded, passing as a parameter the path to your Deltanji kit, e.g. D ##class(Deltanji.Installer).RunInstall("C:\Deltanji\")

6. Review the output for any error messages, and consult us if you are unsure whether the installation succeeded.

7. The final message should give you a URL that you can launch the Deltanji web interface with. Use Chrome, Firefox, Internet Explorer 9 or later, or Safari to do this.

At the Caché authentication page, enter the same credentials as you logged in to Terminal with. If your Caché security level is minimal you might not have had to provide credentials to Terminal. In that case use the SuperUser or Admin account. The default password for these on a minimal-security Caché install is SYS.

8. Using the button on the main panel of the Deltanji web UI, complete the setup.

9. Optionally, tidy up by deleting the Deltanji.Installer class from the USER namespace.