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