Deltanji 7.1 Documentation
Installation and Upgrading

Run the Installation Script

Home > Installation and Upgrading > Installing Other Editions > Run the Installation Script

Run the routine ^%vcins to install and configure Deltanji for first use.

This script installs the appropriate drivers for your operating system and database server. It also initializes all files used by Deltanji. This includes location drivers, component drivers and client integrations.

Permissions

Where necessary the script creates a set of icons for each component driver that does not provide its own. In order to create these icons, write access is required to the directory where the Deltanji Program Files were installed.

If your Deltanji license includes the Production component driver and you want to install the Production Client Integration server-side then you will need to have the %Admin_Manage permission, and write permissions for %DB_CACHESYS or %DB_IRISSYS, and write permission for %DB_ENSLIB. Role %All or role %Manager plus %DB_DELTANJI and %DB_ENSLIB would have sufficient permissions.

Run the Installation Script

Run the command do ^%vcins to run the installation script. The prompts and messages may vary from the example below depending on your platform and version. In particular, the CSP web-access method is only offered on InterSystems platforms. You should normally choose the CSP one whenever it is offered.

In most cases the defaults offered are reasonable choices. If you are re-running this script then each prompt will default to whatever was previously entered.

1. Start a terminal session connected to the IRIS, GT.M or YottaDB instance on which you are installing Deltanji.

2. Switch to the DELTANJI namespace or directory.

3. Enter the command do ^%vcins and then choose the appropriate options for your system.

DELTANJI>do ^%vcins

Deltanji - Version 7.1
           Copyright 1992,2023 George James Software Ltd

           For support call +44-1932-252568
           or e-mail support@georgejames.com

Deltanji - What type of database server are you running?
             1  InterSystems IRIS, IRIS for Health, HealthShare, Caché, Ensemble
             2  GT.M, YottaDB
             3  M21
           Database server (1-3)? <1>
Deltanji - What type of Operating System are you running?
             1  Windows
             2  OpenVMS
             3  Linux, RHEL, AIX, etc.
           Operating System (1-3)? <3>
Deltanji - installing InterSystems IRIS drivers ...............
Deltanji - M Location driver - Installed
Deltanji - Packed Sequential File Location driver - Installed
Deltanji - InterSystems XML Sequential File Location driver - Installed
Deltanji - Library driver - Installed
Deltanji - Binary File Location driver
           Use OS copy command to/from temporary file in current directory ? <N>
Deltanji - Binary File Location driver - Installed
Deltanji - Text File Location driver
           Use OS copy command to/from temporary file in current directory ? <N>
Deltanji - Text File Location driver  - Installed
Deltanji - Initializing global roots ...
Deltanji - Setting new installation defaults
Deltanji - Enter the directory specification of the location where Deltanji has been
           installed </usr/deltanji/>
Deltanji - Validated license key file is /usr/deltanji/vcm.key
Deltanji - When a text or binary file is written by Deltanji should it be set
           to read-only (unless it is checked-out)? <N>
Deltanji - Enable CSP web-access to Deltanji?  <Y>
Deltanji - Enable serverLink web-access to Deltanji?  <N>
Deltanji - Installing component drivers ...
           Component driver: INT installed
           Component driver: G   installed
           Component driver: GZ  installed
           Component driver: BIN installed
           Component driver: T   installed
           Component driver: INC installed
           Component driver: CLS installed
           Component driver: MAC installed
           Component driver: CSR installed
           Component driver: CSP installed
           Component driver: PRI installed
           Component driver: HL7 installed
           Component driver: LUT installed
Deltanji - Installing menu and help data...
Deltanji - Loading core classes ... loaded
Deltanji - Installing Production Client Integration ...
           You can install the Production Client Integration client-side or server-side.
           If installed server-side it will be available for all users in all namespaces
           on this server.  If not installed server-side then it can be installed in each
           user's browser as a userscript.
           If you choose a server-side installation then this will modify the JSINCLUDES
           Parameter of EnsPortal.ProductionConfig.cls in the ENSLIB database to
           include /deltanji/production.user.js which contains the client integration code.
           In the event of an IRIS upgrade or re-install you will need to re-run this
           installation script to re-apply this modification.

           Install server-side Production Client Integration? <Y>
Compilation started on 03/23/2023 23:14:37
Compiling class EnsPortal.ProductionConfig
Compiling routine EnsPortal.ProductionConfig.1
Compilation finished successfully in 0.907s.

Deltanji - Install Deltanji classes, templates and add-ins ? <Y>
Deltanji - Preparing templates and add-ins
...
Load finished successfully.

Deltanji - Installing and compiling templates and add-ins
...
Load finished successfully.

Deltanji - Classes installed and compiled successfully
Deltanji - Installation complete

Deltanji - Use this URL to access the Deltanji Portal:
           http://goji/deltanji/Client.VCm.cls
           Username: ijones
DELTANJI>

4. Click on the link provided to launch the Deltanji Portal. You should also review your CSP Application and web server configuration settings.

Next Step

If you are performing a new Deltanji installation, configure a web server.

If you are performing a Deltanji upgrade, return to the upgrade instructions.