Prerequisites

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:

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

   8991

    

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

   8991

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

   http://pdshost1.qa.local:8991/pds

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

   httpd -v

Download

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

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:

   apcb

    

   ./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

    

   bash upgradeshib3dp.sh

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:

   apcb

   ./apachectl_auto

    

   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

Rollback

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