Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    UTML Script / Template Mechanism -- How to Run It

    • 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)

    Additional Information

    faq,


    • Article last edited: 10/8/2013