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
    • 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
    To save a backup copy of the current license.

    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: 10/1/2014