Upgrade to FileCloud v23.1 with RHEL 9

October 2, 2023

Note: this blog post is intended for system and IT administrators who manage FileCloud Server environments. To initiate the upgrade process, we will be performing a phase-by-phase method. Upgrade MongoDB from 4.4 to 6.0. Perform in-place OS upgrade. Upgrade from FileCloud v22.1 to v23.1. Preliminary Recommendations Beginning with v23.1, FileCloud will only be supporting direct […]

Note: this blog post is intended for system and IT administrators who manage FileCloud Server environments.

To initiate the upgrade process, we will be performing a phase-by-phase method.

Preliminary Recommendations

Beginning with v23.1, FileCloud will only be supporting direct upgrades from v22.1 with RHEL 8 to v23.1 with RHEL 9. For any other versions, we recommend migrating to a new server with FileCloud 23.1 installed on RHEL 9.

Prior to upgrading FileCloud, we recommend taking server snapshots and backups of /var/www/html and mongodump of the database.

If you are upgrading an AWS instance from RHEL 8 to RHEL 9, you will need a RHEL subscription.

Upgrade MongoDB from 4.4 to 6.0

First, we will override the filecloudcp with the newer version, which supports the mongodb upgrade from 5.0 to 6.0.

curl --location 'https://repo.filecloudlabs.com/static/misc/filecloudcp' -o /usr/bin/filecloudcp
chmod 755 /usr/bin/filecloudcp
  1. Running MongoDB Compatibility version to 4.4.
mongo --quiet --eval “db.adminCommand( { setFeatureCompatibilityVersion: ‘4.4’ } )"
  1. Stop services for MongoDB upgrade.
service httpd stop
service fcorchestrator stop
service cron stop
service fcdocconverter stop
service solr stop
  1. Upgrade MongoDB using filecloudcp command to 5.0.
filecloudcp -m50
  1. Run MongoDB Compatibility version to 5.0.
mongo --quiet --eval "db.adminCommand( { setFeatureCompatibilityVersion: '5.0' } )"
  1. Upgrade MongoDB using filecloudcp command to 6.0.
filecloudcp -m60
  1. Run MongoDB Compatibility version to 6.0.
mongosh --quiet --eval "db.adminCommand( { setFeatureCompatibilityVersion: '6.0' } )"

Perform In-place OS Upgrade from RHEL 8 to RHEL 9.

service apache2 stop
service fcorchestrator stop
service cron stop
service fcdocconverter stop
service solr stop
service mongod stop

subscription-manager list --installed
sudo rm -Rf /root/tmp_leapp_py3
subscription-manager release --set 8.7
dnf update -y
reboot
dnf install leapp-upgrade -y
dnf versionlock clear
#Disable AllowZoneDrifting in /etc/firewalld/firewalld.conf
sed -e '/AllowZoneDrifting/ s/^#*/#/' -i /etc/firewalld/firewalld.conf
systemctl restart firewalld
update-crypto-policies --set LEGACY
reboot
Disable root user and create a sudo user

cp -rvf /var/www/html /var/www/html_backup
cp -rvf /etc/httpd/httpd.conf /opt/httpd.conf

mongodump --out /opt/mongo_backup
service httpd stop
service fcorchestrator stop
service crond stop
service fcdocconverter stop
service solr stop
service mongod stop

#Remove the below packages:
rpm -e --nodeps nodejs
leapp preupgrade
leapp upgrade --target 9.0
reboot

Perform FileCloud Upgrade from 22.x to 23.1.

service httpd stop
service fcorchestrator stop
service cron stop
service fcdocconverter stop
service solr stop
service mongod stop

Remove old Filecloud repos.

rm -rf /etc/yum.repos.d/filecloud*.repo

Add repos compactible to RHEL 9.

yum clean all
yum remove httpd* php* -y
yum update -y
semodule -nB
mv  /var/www/html  /var/www/html_old
cp -rvf /var/www/html_backup /var/www/html
cat <<EOF > /etc/yum.repos.d/filecloud-23.1.repo
[filecloud-23.1]
name=FileCloud 23.1
baseurl=https://repo.filecloudlabs.com/yum/redhat/\$releasever/filecloud/23.1/x86_64/
gpgcheck=1
enabled=1
gpgkey=https://repo.filecloudlabs.com/static/pgp/filecloud.asc
module_hotfixes=true
EOF
yum update -y
yum install yum-utils -y
yum-config-manager --enable filecloud-23.1
apt-get install apache2 mongodb-org -y

cp -rvf /opt/httpd.conf /etc/httpd/httpd.conf

apt install -y --no-install-recommends php8.2*
ACCEPT_EULA=Y  apt-get install filecloud -y

Conclusion: Upgrade to FileCloud v23.1 with RHEL 9

This post has been published to support system and IT administrators responsible for managing and maintaining FileCloud Server environments. For more information on FileCloud v23.1, check out our release notes or reach out to our support team!

 

Article written by Nandakumar Chitra Suresh, Support Engineering Manager

Edited by Katie Gerhardt, Jr. Product Marketing Manager

 

By Katie Gerhardt

Jr. Product Marketing Manager