Upgrading your On-Premise FileWave Server

What

Needing to upgrade your on-premise FileWave server? This guide will go over the steps involved in updating your FileWave server for macOS, Linux, and Windows.

If your FileWave server is hosted by FileWave, you may review the KB article here: Your Hosted FileWave Server Has Been Upgraded - What Are Your Next Steps?

When/Why

What steps do you need to take to continue managing your devices? This article will guide you to upgrade your FileWave Central/Admin application and your FileWave clients, boosters along side creating custom installers for your macOS DEP enrolled and Windows MDM devices.

How

This guide will go over the steps involved in updating your FileWave on-premise server for macOS, Linux, and Windows.

Before upgrading, please visit the Known Issues tab of the Known Issues.

For best results, upgrade the FileWave components in the following order: 

1. Lock Desktop and iOS Clients
2. Backup your FileWave server
3. Upgrading the FileWave Server software
4. Upgrading FileWave Central (FileWave Admin Native App)
5. Launch FileWave Central (FileWave Admin) to Confirm the Upgrade
6. Upgrading your FileWave Boosters
7. Upgrading the FileWave Client
8. Upgrading the iOS/iPadOS App Portal IPA
9. macOS DEP and Windows MDM: Upgrade Client Packages

1. Lock Desktop and iOS Clients

It's always a good idea to lock all your client devices before upgrading your FileWave components. That way you can verify that the server is running correctly and not worry about your macOS and Windows clients getting any of the changes.

  1. Highlight all of your Desktop devices → right click → select "Lock". 

  2. Change the filter to mobile, highlight all iOS devices → right click → select "Lock"

lockclients

What is a Lock?

See Locking Devices

2. Backup your FileWave server

There are two ways to do so depending on your server. If you are running a Linux or macOS server you need to use the backup script that we provide to backup your server. Please always run a manual backup with the script we offer before starting the upgrade. We offer this knowledge base article for this process and the commands you will need to run as well as a way to check the backup file. 

If you are running a virtual machine for your FileWave server you are still able to use the backup script we offer but are also able to take a snapshot of the server in your virtual environment as a backup. Before taking the snapshot of the server please turn off the virtual machine so that FileWave server services are not running when you are backing up the Virtual Machine. This will prevent any issues with fragmented information in the backup.

If you do not want to stop the VM, you can use the below commands to stop the FileWave services and then take the backup. 

Stop the FileWave Server Services (for VM Snapshot only)

sudo fwcontrol server stop

After the backup is complete, please start the services again using the following command

sudo fwcontrol server start

3. Upgrading the FileWave Server software

Once you have a backup of your FileWave server created you will first Upgrade the FileWave server software before upgrading your FileWave Central (FileWave Admin Native) app, FileWave boosters, or FileWave clients. If you upgrade your FileWave clients' software first before upgrading the server, for example, your clients may break the connection to the server. Upgrading the FileWave server is not as intimidating as it may seem as it is an in-place upgrade and you do not need to uninstall anything first or stop the FileWave server services. Below you will find sections for macOS, Linux, and Windows Server.

3.1 macOS Server Upgrade

macOS Server Upgrade

The macOS server upgrade is similar to installing any other pkg software on a macOS machine. 

  1. On your macOS FileWave server go to the Knowledge Base → Downloads → select the most recent version of FileWave 
    FileWave Downloads Page

    Downloadspage

  2. You will then scroll down on the page until you see "macOS Installers" and select it. This will download all of the FileWave Installers for the version of FileWave you want to upgrade to in a .dmg file. If you only want to upgrade the server, select “macOS Server”.

    macOSdownloads

  3. Run the installer you just downloaded. If you downloaded the bundle, double-click on the FileWave Server installer after mounting the dmg.

  4. The installer can take a while to run but when it is finished you will be presented with the window below and you are finished with upgrading the server. (If the upgrade reports a failure please contact our Support Team immediately and they can assist you with it) 

    macOSserverinstallation

  5. You are now done upgrading the server and will then move to upgrade your FileWave Central (FileWave Admin Native) app.

3.2 Linux Server Upgrade

Linux Server Upgrade

The Linux server upgrade can be intimidating since it will all be done in Terminal but we try to make it as simple as possible for you. 

  1. Go to the Knowledge Base → Downloads → select the most recent version of FileWave 
    FileWave Downloads Page

    Downloadspage

  2. Scroll down on the page until you see "Linux Downloads". You can download the .rpm and move it to the server or just run the ‘yum install’ command under Upgrading Linux Servers → Upgrading the FileWave Server to download and install all at once.