Multiple Releases
From DLXS Documentation
(→Two DLXSROOT values and two databases) |
|||
| (4 intermediate revisions not shown.) | |||
| Line 1: | Line 1: | ||
| + | [[DLXS Wiki|Main Page]] > [[Installing DLXS]] > Multiple Releases | ||
| + | |||
==Introduction== | ==Introduction== | ||
| Line 13: | Line 15: | ||
<ol> | <ol> | ||
<li>Install the new release under a new <tt>DLXSROOT</tt> directory. Give the installer program (<tt>Installer.pl</tt>) this directory when you install. </li> | <li>Install the new release under a new <tt>DLXSROOT</tt> directory. Give the installer program (<tt>Installer.pl</tt>) this directory when you install. </li> | ||
| - | <li>Create another MySQL database for the new install with a different name, e.g. dlxs_v6 as we covered in [[Installing and Upgrading the Database]]). Answer the installer prompt for dabase name with the database name for the new installation. | + | <li>Create another MySQL database for the new install with a different name, e.g. dlxs_v6 as we covered in [[Installing and Upgrading the Database]]). Answer the installer prompt for dabase name with the database name for the new installation.</li> |
<li>Configure another virtual host under your web server and point its <tt>DLXSROOT</tt> | <li>Configure another virtual host under your web server and point its <tt>DLXSROOT</tt> | ||
to the directory containing the new release. Recall your [[Example Apache virtual host configuration|virtual host configuration]]. Given releases 12 and 13 your URLs might be: | to the directory containing the new release. Recall your [[Example Apache virtual host configuration|virtual host configuration]]. Given releases 12 and 13 your URLs might be: | ||
| Line 19: | Line 21: | ||
<tt>diglib13.somewhere.edu/cgi/t/text/text-idx</tt></blockquote> | <tt>diglib13.somewhere.edu/cgi/t/text/text-idx</tt></blockquote> | ||
| - | + | 4. Set the <tt>DLXSDATAROOT</tt> environment variable as described below for each virtual host. </li></ol> | |
| - | 4. Set the <tt>DLXSDATAROOT</tt> environment variable as described below for each virtual host</li> </ol | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| + | |||
| + | <b>CAVEAT: </b>The session ID is stored in a cookie. Search History and Bookbag are stored in the session so crossing between different releases will drop the Search History and Bookbag holdings because the session ID is a handle to a record in the database and different releases have different databses. Similarly, portfolios are stored in the database. A portfolio created in one release will not be accessible if the user crosses to a different release. | ||
| + | |||
==Pointing two different DLXS releases at the same data== | ==Pointing two different DLXS releases at the same data== | ||
| Line 37: | Line 38: | ||
<p>Another scenario might be to have your data in a single location entirely outside any install trees and use <tt>DLXSDATAROOT</tt> in every virtual host to point at that single location.</p> | <p>Another scenario might be to have your data in a single location entirely outside any install trees and use <tt>DLXSDATAROOT</tt> in every virtual host to point at that single location.</p> | ||
| + | |||
| + | |||
| + | [[#top|Top]] | ||
Current revision
Main Page > Installing DLXS > Multiple Releases
Contents |
[edit] Introduction
You might want to have two different releases of DLXS Middleware running at the same time. For example, to keep a past release running in production while installing, configuring and migrating your local UI or code changes to a new release.
Given these two installations, you may or may not want to have both releases pointing to the same image files and indexed XML data.
[edit] Installing and configuring two DLXS releases
[edit] Two DLXSROOT values and two databases
Suppose you already have a pervious DLXS release and database installed.
- Install the new release under a new DLXSROOT directory. Give the installer program (Installer.pl) this directory when you install.
- Create another MySQL database for the new install with a different name, e.g. dlxs_v6 as we covered in Installing and Upgrading the Database). Answer the installer prompt for dabase name with the database name for the new installation.
- Configure another virtual host under your web server and point its DLXSROOT
to the directory containing the new release. Recall your virtual host configuration. Given releases 12 and 13 your URLs might be:
diglib12.somewhere.edu/cgi/t/text/text-idx
4. Set the DLXSDATAROOT environment variable as described below for each virtual host.
and
diglib13.somewhere.edu/cgi/t/text/text-idx
CAVEAT: The session ID is stored in a cookie. Search History and Bookbag are stored in the session so crossing between different releases will drop the Search History and Bookbag holdings because the session ID is a handle to a record in the database and different releases have different databses. Similarly, portfolios are stored in the database. A portfolio created in one release will not be accessible if the user crosses to a different release.
[edit] Pointing two different DLXS releases at the same data
Data (SGML/XML, image files) and XPAT indexes occupy a lot of disk space. DLXS middleware recognizes the DLXSDATAROOT environment variable. A given release can point to the data/index/image directories (under obj, idx and img) outside of its own install tree.
If the virtual host for a given DLXS release defines DLXSDATAROOT, that value is used as the path prefix for the obj, idx and img directories. If DLXSDATAROOT is not defined, the DLXSROOT value is used for the path prefix.
For example, in the virtual host for release 13, you could set DLXSDATAROOT to /usr/local/dlxs12 to have release 13 read data from the release 12 install tree.
Another scenario might be to have your data in a single location entirely outside any install trees and use DLXSDATAROOT in every virtual host to point at that single location.
