• Article Type: General
• Product: Aleph
• Product Version: 18.01

Description:
What is the "utml script" / "template mechanism"? How do you run it?

Resolution:
The template mechanism was introduced in Aleph v16.02. It is used when we need to modify major Aleph configuration parameters like the location of a-tree and u-tree, server ports, Oracle database names, etc. All these parameters are managed in one central location and propagated into all configuration files for Aleph, www_server, and Apache..

Stop Aleph, Apache and Oracle as user root
# cd /etc/init.d
# ./exlibris stop

2) As user aleph, for example in a18(1)
>> cd /exlibris/aleph/a18_1/install

3) Edit the file conf_tml.dat
_HTTPD_PORT =
<etc.>

4) Apply changes to all configuration files.
>> ./utml -bd /exlibris/aleph/u18_1
here you will see the list of Aleph parameters and prompt for confirmation
Change config files? y/n [n] y
Wait ...
/exlibris/aleph/a18_1/alephe/aleph_startup changed.
/exlibris/aleph/a18_1/alephe/apache/conf/httpd.conf changed.
<etc.>

Logout and login (or start a new session)...

Start Oracle (UTIL-O-1-1)
Start apache (UTIL-W-3-6)
Restart aleph (aleph_startup)

**NOTE: Any change done to any of the configuration files not using the utml script and not included in the relevant xxxxx.tml files will be overwritten by rerunning utml. In particular, be sure to check for changes to these aleph_start setenv's: usr_library, pw_library, z105_library, and www_base which have not been made to aleph_start.tml.**

For example: If aleph_start contains:
setenv WWW_HOST myaleph.edu
setenv PDS_HOST myprimo.edu
setenv HTTPD_PORT 80
setenv PDS_PORT 80
setenv www_base "ABC01"

And aleph_start.tml has the following parallel entries:
setenv WWW_HOST @_HOST_WWW
setenv PDS_HOST @_HOST_WWW
setenv HTTPD_PORT @_HTTPD_PORT
setenv PDS_PORT @_HTTPD_PDS_PORT
setenv www_base "USM01"

And /exlibris/aleph/a20_1/install/conf_tml.dat contains:
_AL_COPY = 1
_HOST_WWW = myalephtest.edu
_HOST_PDS = $_HOST_WWW ##HOST:PDS host
_HTTPD_PORT = 899$_AL_COPY ##WWW :httpd port
_HTTPD_PDS_PORT = $_HTTPD_PORT ##WWW :httpd pds port

If conf_tml.dat and aleph_start.tml aren't updated and the utml mechanism is run, the aleph_start values would automatically revert to:
setenv WWW_HOST myalephtest.edu
setenv PDS_HOST myalephtest.edu
setenv HTTPD_PORT 8991
setenv PDS_PORT 8991
setenv www_base "USM01"

(Keywords: faq)