Caché Installation Guide - InterSystems Documentation
Caché Installation Guide - InterSystems Documentation
Caché Installation Guide - InterSystems Documentation
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Upgrading <strong>Caché</strong><br />
You may upgrade directly to this release of <strong>Caché</strong> from release 5.1 or above without converting<br />
existing databases.<br />
For upgrading from earlier versions, contact the <strong>InterSystems</strong> Worldwide Response Center (WRC).<br />
1.2 Upgrade Tasks<br />
The following upgrade tasks are necessary regardless of the platform on which you are upgrading and<br />
running <strong>Caché</strong>. Perform these tasks before you run the <strong>Caché</strong> installation procedures:<br />
1. Obtain an updated license key — the key structure changed in <strong>Caché</strong> 5.1; upgrades from <strong>Caché</strong><br />
5.0 or earlier require an updated key.<br />
2. Backup system — before upgrading, <strong>InterSystems</strong> recommends that you run a complete backup<br />
of your system. Use your customary full operating system backup procedures.<br />
3. Check system integrity — run a system integrity check on existing directories to ensure there is<br />
no corruption in any of the databases.<br />
4. Save custom routines and globals — to prevent your own routines and globals in the %SYS<br />
namespace from being affected by the upgrade installation, ensure that they have names that begin<br />
with “Z” , “z” , “%Z” , or “%z” . All .int and .obj routines (except for Z*, z*, %Z*, and %z*)<br />
are deleted from the %SYS namespace when upgrading.<br />
On an upgrade, the CACHELIB, CACHETEMP, DOCBOOK, and SAMPLES databases are completely<br />
replaced.<br />
Any .mac or .inc routines are not affected during the upgrade.<br />
5. Save user files — additional files and directories are also deleted or replaced during an upgrade.<br />
It is safest to have all your user files in the \Devuser directory or any subdirectories named \User<br />
under the <strong>Caché</strong> installation directory.<br />
6. Remove PIJ file (OpenVMS clusters only) — If you are upgrading a member of a <strong>Caché</strong> OpenVMS<br />
cluster system, cleanly shut down all members of the <strong>Caché</strong> cluster and remove the CACHE.PIJ<br />
file. If you do not remove this file, the installation is not upgraded and error messages, such as<br />
the following, are written in the cconsole.log for startup:<br />
Cache (2100036c) Tue Aug 1 14:28:59 2007<br />
Activating Namespaces<br />
Cache (21000404) Tue Aug 1 14:28:59 2007 Cluster image journal<br />
is incompatible with this version<br />
Cache (21000404) Tue Aug 1 14:28:59 2007 Unable to join the cluster<br />
Cache (21000404) Tue Aug 1 14:29:00 2007<br />
ENQdaemon exited due to VMS error code (decimal) 0<br />
4 <strong>Caché</strong> <strong>Installation</strong> <strong>Guide</strong>