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

    Upgrade to Apache 2.4 for Primo PDS

    This procedure upgrades Apache to version 2.4 for Primo PDS.

    • The upgrade process must be run only on the servers where PDS is running. For a multi-server Primo topology, update only the FE servers. For an all-in-one Primo topology, update your Primo server.

    • The upgrade process should be run after the Primo May Release Service Pack update.


    1. Enter the following command to ensure that your OS version is Redhat/Centos 7 and up, 64bit:

      # cat /etc/redhat-release 
      Red Hat Enterprise Linux Server release 7.x 

    2. Enter the following command to see if Shibboleth is installed, which indicates that you are using the 64-bit version:

      # rpm -q shibboleth
      package shibboleth is not installed

    Prepare the Download Folder and Download

    As the root user, perform the following commands:



    test -d ${DOWNDIR} && chmod 777 ${DOWNDIR} || mkdir -m777 ${DOWNDIR}

    Run Confidence Checks before Running

    Verify PDS is up and running and Apache version is lower than 2.4 :

    1. As the primo user, enter the following commands to get the PDS ports:

      primo@aio0003(p4_1):~/p4_1/primom$echo $HTTPD_PORT



      primo@aio0003(p4_1):~/p4_1/primom$echo $PDS_PORT


    2. Open PDS main page in a browser. For example, a server with the hostname and PDS_PORT=8991 can be opened in a browser with the following command:

    3. Enter the following command to ensure that the Apache version is below 2.4:

      httpd -v


    As the primo user, enter the following commands, making sure that you replace <MFT_location> with either na (North America) or eu (Europe):

    cd /exlibris/ftp_from_exlibris


    set KEYFILE="/exlibris/primo/p4_1/ng/primo/home/system/publish/conf/keys/sp_customer"


    chmod 600 $KEYFILE




    set SFTP_COM="sftp -oPort=10022 -oUser=$MFTUSER -oStrictHostKeyChecking=no -oBatchMode=yes -i $KEYFILE downloads-<MFT_location>"


    echo "get" | $SFTP_COM




    chown -R primo:exlibris PDS_64

    Stop Services and Backup

    1. If you are working on an all-in-one Primo environment (which indicates that the BO and FE are on the same server), enter the following command as the root user to stop all services and to take a cold snapshot:

      service exlibris stop

      If the BO and FE are not on the same server, you can take the snapshot without stopping all services.

    2. As the primo user, enter the following commands to shut down Apache if it is not already stopped:



      ./apachectl stop

    3. Enter the following commands to back up Apache and PDS (In addition to the full backup!):

      tar zcvf /exlibris/ftp_from_exlibris/backup_apache_pds.tar.gz -C $primo_dev --exclude=logs apache pds product

    Run the Upgrade

    Perform the following steps to run the Apache upgrade:

    1. As the primo user, enter the following commands:

      cd /exlibris/ftp_from_exlibris/PDS_64



    2. As the root user, enter the following command:

      chown -R primo:exlibris /exlibris/primo/p4_1/primoe/apache/logs

    3. Enter the following commands to start Apache:




      Example output:

      /exlibris/primo/p4_1/primoe/apache/bin/apachectl start: httpd started

    4. Enter the following command to ensure that the Apache version has been upgraded:

      httpd -v

      Server version: Apache/2.4.38 (Unix)

      Server built:   Mar 13 2019 11:20:51

    Start All Service (Where Applicable)

    1. If you stopped the exlibris service earlier, enter the following command as the root user to restart the exlibris service:

      #service exlibris start

    2. Ensure that the following Primo components are up:

      • Back Office

      • Search engine monitoring

      • Search results


    If necessary, use one of the following options to rollback the upgrade:

    • Option one:

      Restore the backup from the snapshot.

    • Option Two:

      1. As the root user, enter the following command to stop all services (as 'root' run 'service exlibris stop')

        #service exlibris stop

      2. As the primo user, enter the following command:

        tar xzvf /exlibris/ftp_from_exlibris/backup_apache_pds.tar.gz -C $primo_dev

    • Was this article helpful?