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 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 upgrades from v22.1 with Ubuntu 20.04 LTS to v23.1 with Ubuntu 22.04 LTS. For any other versions, we recommend migrating to a new server with FileCloud 23.1 installed on Ubuntu 22.04 LTS.

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

Upgrade MongoDB from 4.4 to 6.0

First, we will override the filecloudcp with the newer version that 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. Run MongoDB Compatibility version to 4.4.

mongo --quiet --eval "db.adminCommand( { setFeatureCompatibilityVersion: '4.4' } )"

2. Stop services for MongoDB upgrade.

• service apache2 stop
• service fcorchestrator stop
• service cron stop
• service fcdocconverter stop
• service solr stop

3. Upgrade MongoDB using filecloudcp command to 5.0.

filecloudcp -m50

4. Run MongoDB compatibility version to 5.0.

mongo --quiet --eval "db.adminCommand( { setFeatureCompatibilityVersion: '5.0' } )"

5. Upgrade MongoDB using filecloudcp command to 6.0.

filecloudcp -m60

6. Run MongoDB Compatibility version to 6.0.

mongosh --quiet --eval "db.adminCommand( { setFeatureCompatibilityVersion: '6.0' } )"

Perform In-place OS Upgrade from Ubuntu 20.04 LTS to Ubuntu 22.04 LTS

service apache2 stop
service fcorchestrator stop
service cron stop
service fcdocconverter stop
service solr stop
service mongod stop
apt-get dist-upgrade -y
apt-get autoremove -y
apt-get install update-manager-core -y
reboot
do-release-upgrade -f DistUpgradeViewNonInteractive

Perform FileCloud Upgrade from 22.x to 23.1.

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

Remove Old FileCloud Repos.

rm -rf /etc/apt/sources.list.d/filecloud.list
rm -rf /etc/apt/sources.list.d/mongodb-org-6.0.list

 Add repos compactible to Ubuntu 22.04 LTS.

curl -fsSL https://pgp.mongodb.com/server-6.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-6.0.gpg --dearmor
curl -fsSL https://repo.filecloudlabs.com/static/pgp/filecloud.asc | sudo gpg -o /usr/share/keyrings/filecloud.gpg --dearmor
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-6.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
echo "deb [ arch=amd64 signed-by=/usr/share/keyrings/filecloud.gpg ] https://repo.filecloudlabs.com/apt/ubuntu jammy/filecloud/23.1 main" | sudo tee /etc/apt/sources.list.d/filecloud.list
apt-get clean all
apt-get update -y
apt-get install -y --no-install-recommends php8.2*
apt-get upgrade -y

Conclusion: Upgrade to FileCloud v23.1 with Ubuntu 22.04 LTS

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