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

    How to Apply a New Aleph Server License

    • Article Type: General
    • Product: Aleph
    • Product Version: 20,21,22,23
    • Relevant for Installation Type: Dedicated-Direct; Direct; Local;

    Desired Outcome/Goal:

    To apply a new Aleph license from Ex Libris to the server.

    Procedure:

    1. Login to UNIX server as "aleph" user and enter the following commands.

    2. aet
    To change to the ./alephe/tab directory.

    3. cp -p license license.save.<ddmmyyy>
    To save a backup copy of the current license where <ddmmyyyy> is the current date

    4. vi license
    To be able to edit the file.

    5. Copy and paste the full text of the new license to overwrite the old license.

    6. :wq
    To save the file.

    [If installing x-server license too, follow the next four steps; otherwise, skip to step 11.]

    7. cp -p license.www_x license.www_x.save
    To save a backup copy of the current license.www_x file.

    8. vi license.www_x

    9. Copy and paste the full text of the new license.www_x file to overwrite the old version.

    10. :wq

    11. dlib xxx01
    To access the xxx01 library.

    12. util y/11
    To "Display License Status" of both the "Main License file" and the "X-Server License file", to confirm the file has been applied and all lines are as expected.

    Restart Aleph to update license across servers:

    13. aer
    To access ./alephe/root directory.

    14. csh -f aleph_shutdown > & aleph_shutdown_<date>.log &
    To begin the Aleph shutdown process and create a log file for it.

    15. tail -f aleph_shutdown_<date>.log
    To view the end of the log file. This may take a couple of minutes, but will display "Done" when completed.

    16. csh -f aleph_startup > & aleph_startup_<date>.log &
    To begin the restart process, and create a log file for it.

    17. tail -f aleph_startup_<date>.log
    To view the end of the log file. This may take a couple of minutes, but will display "Done" when completed.

    Additional Information

    The license file is comprised of two columns; the first column starts in position 1, and the second in position 21.
    Ex Libris will provide the file in plain text, usually as a .txt file attached to an email.

    See Article 000037322 (What does a valid Aleph license look like?) for more information.
     

    Category: System management


    • Article last edited: 21/2/2020