Upgrade to Apache 2.4 for Primo PDS

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

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.

Prerequisites

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
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:

DOWNDIR=/exlibris/ftp_from_exlibris

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 :

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
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
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):

cd /exlibris/ftp_from_exlibris

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

chmod 600 $KEYFILE

set MFTUSER=primo_customers_sp@customers.gl

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

echo "get primo_pds64_download.sh" | $SFTP_COM

bash primo_pds64_download.sh

chown -R primo:exlibris PDS_64

Stop Services and Backup

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.
As the primo user, enter the following commands to shut down Apache if it is not already stopped:

apcb

./apachectl stop
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:

As the primo user, enter the following commands:

cd /exlibris/ftp_from_exlibris/PDS_64

bash upgradeshib3dp.sh
As the root user, enter the following command:

chown -R primo:exlibris /exlibris/primo/p4_1/primoe/apache/logs
Enter the following commands to start Apache:

apcb

./apachectl_auto

Example output:

/exlibris/primo/p4_1/primoe/apache/bin/apachectl start: httpd started
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)

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

#service exlibris start
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