Upgrading to a New Version of Deltanji



Preparations


Review the applicable release notes using one or more of the links above. In particular, look for any release-specific pre-upgrade or post-upgrade steps that you will need to incorporate into the procedure given below.

If you are using IIS to host the Deltanji browser interface and you have configured Content Expiration there to improve performance by making the web server tell the users' web browsers to cache static files locally for a speciified minimum period (e.g. 1 day), disable this configuration far enough in advance of installing the Deltanji upgrade so as to ensure that users' browsers will always fetch static files fresh from the web server. Once the upgrade has completed you can reinstate the original setting if desired. If you do not take these steps your users must clear their browser temporary file cache before starting to use Deltanji again after the upgrade. Otherwise they may encounter mismatches between client-side and server-side code.

Installing the Upgrade


These instructions assume your original installation used the namespace name DELTANJI and (in the case of multi-server configurations) DELTANJI-LOCAL. On older sites the names are likely to be VCM and VCM-LOCAL. Adapt the instructions accordingly.

  1. Advise users to stop using Deltanji.
  2. If the release notes you reviewed above specified any version-specific pre-upgrade steps, do them now.
  3. Make sure you have a recent backup of your Deltanji software and repository. This consists of:
    • The database where your ^%vc* globals are located.
    • Your %vc* routines (for Caché and Ensemble systems these are generally in the same database; for GT.M they are held in individual .m files).
    • Your current Deltanji software kit, located in the directory pointed to by the global node ^%vcvc("programFiles").
    • The directory published by the web server that hosts your Deltanji browser interface (may be the same directory as above, or may be located on a different server).
    • The database(s) storing your code repository or repositories. Sites typically have only one, and it is commonly the same database as contains the ^%vc* globals (and on Caché etc. the %vc* routines). Look under Setup\Physical Addresses for any rows that provide L-format storage.
  4. Use these instructions to update the ^%vcvc("programFiles") directory.
  5. Use these instructions to update the %vc* routines. Make sure you opt to overwrite existing routines and recompile them.
  6. Use these instructions to apply the upgrade to the database.
  7. If you use a separate web server to host the Deltanji browser interface, copy the files from the ^%vcvc("programFiles") subtree onto the web server, updating the existing files. If the web server is on a different operating system from the Deltanji server make sure that the file transfer mechanism you use will perform text file line-ending conversions (e.g. from LF to CRLF). Or avoid such issues by transferring the upgrade zip kit to the web server and unpacking it there.
  8. If you use Beyond Compare, stop the Beyond Compare server by running D Stop^%vc830, then restart it by running D StartUp^%vc830.
  9. If you use the Deltanji task server on InterSystems ECP-connected nodes, perform the following sub-steps to propagate the updated %vc* routines. If you are unsure whether this applies to you, perform the sub-steps anyway:
    • Open a terminal session on your central Deltanji node, in the DELTANJI namespace.
    • Run the following command: D sync^%vczn1(-1)
  10. If your central Deltanji node is a primary failover member of an InterSystems mirroring configuration, connect to the DELTANJI namespace in a terminal session on the backup member. Run the command D Cache5^%vcins() and default the prompt (Y).
  11. If you are using an InterSystems platform and any of the namespaces where you have integrated Deltanji with InterSystems editors (i.e. Atelier, Studio and Portal) are on nodes other than the node hosting the central Deltanji database, perform these sub-steps:
    • Make sure the nodes' local copies of %vc* routines have been updated (only necessary as a separate step on nodes that do not use task server, because task server nodes will have had their %vc* routines updated above).
    • Verify whether the nodes see the same Deltanji files as were updated above. This is likely to be the case if ^%vcvc("programFiles") in a Deltanji-controlled namespace on the node points to the same network-shared filesystem location as it does when viewed from the DELTANJI namespace on the central Deltanji node. If connected nodes see their own local copy of the Deltanji files then you must update this local copy with the set from the new release before proceeding to the next step.
    • Then in the DELTANJI-LOCAL namespace (or the DELTANJI one if there is no DELTANJI-LOCAL) run the command D Cache5^%vcins() and default the prompt (Y).
    • If any of these nodes is a primary failover member of an InterSystems mirroring configuration, connect to the backup member and re-run Cache5^%vcins() in the same namespace there.
  12. If the release notes you reviewed above specified any version-specific post-upgrade steps, do them now. If any of those steps have to be performed through your web browser you may first need to clear its cache (see below).

Deltanji is now upgraded and ready for use. Depending on your exact web server and web browser configurations it may be necessary for users to clear their browser temporary file cache before using the Deltanji interface for the first time after the upgrade.