Skip to main content

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.

    Linuxdownloads

  3. Connect to your FileWave Linux server and run the command to install. If you don’t have direct access to the server, you can connect using SSH in Terminal or Putty on Windows.

  4. Once you have run the command on your server it can take a little while to finish and you will be presented with a similar message as below. If you see that the installation failed please contact our support team immediately and they can assist you with this. You will see more information on your session but this will show at the end of the messages.

    linuxserverupgrade

  5. Confirm your installed FileWave Version by running the following:

    fwcontrol server version

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

3.3 Windows Server Migration

Windows Server Migration

No longer compatible with FileWave Server 14+

Please contact Professional Services to migrate your server to Linux.

4. Upgrading FileWave Central (FileWave Admin Native App)

FileWave Anywhere (Web Admin) is automatically updated with the Server.

To connect to your upgraded server, you will need to use the same version of FileWave Central (FileWave Admin Native) unless stated otherwise on the Downloads page. When you are updating FileWave Central (Admin) simply run the installer for your designated OS.

The installer does not require the old version to be uninstalled and is similar to running a PKG or MSI for any other software. FileWave Central is supported on macOS and Windows.

4.1 macOS FileWave Central

macOS FileWave Central

If you’re upgrading FileWave Central (Admin) on your server and you downloaded the bundle to upgrade the server, the Central/Admin package is already downloaded and you can install it from the .dmg

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

    Downloadspage

  2. You will then scroll down on the page until you see "macOS Downloads" and expand the section. Select and download “macOS Admin”

    macOSdownloads

  3. Double-click on the downloaded PKG to launch the installer and follow the install instructions on the screen. 

  4. Once the installation finishes you are ready to connect to your FileWave Server using FileWave Central (FileWave Admin).

4.2 Windows FileWave Central

Windows FileWave Central

If you’re upgrading FileWave Central (Admin) on your server and you downloaded the bundle to upgrade the server, the Central/Admin package is already downloaded and you can install it from the .msi

  1. On your Windows workstation go to the Knowledge Base → Downloads and select the most recent version of FileWave 
    FileWave Downloads Page

    Downloadspage

  2. You will then scroll down on the page until you see "Windows Downloads" and expand the section. Select and download “Windows Admin”

    Windowsdownloads

  3. Double-click on the downloaded Windows Installer to launch the installer and follow the install instructions on the screen. 

  4. Once the installation finishes you are ready to connect to your upgraded FileWave Server using FileWave Central (FileWave Admin).

5. Launch FileWave Central (FileWave Admin) to Confirm the Upgrade

Launch FileWave Central (FileWave Admin) to Confirm the Upgrade

The next step once the FileWave Central/Admin application is upgraded is to launch the Central/Admin application to connect to the newly upgraded server. After an upgrade, you always want to connect to the server and verify everything is running and working correctly. This will allow you to spot any issues quickly and, if necessary, contact our FileWave Support Team for assistance.

Do not hesitate to contact our Support Team quickly if you think there may be an issue as that will help us get you back up and running as quickly as possible. 

  1. Check the warning light in the bottom left-hand corner. You are looking for it to say "Everything is OK" as shown below. If you see the light as yellow or red please select the message to view the error. If you’re unsure how to resolve an error, don't hesitate to get in touch with Support.

    AdmineverythingisOK

  2. Make sure Filesets are showing. Select the Filesets tab and make sure you see your Filesets and structure. If you are having issues contact our support team. 

  3. If you have iOS devices, Select "iOS Inventory" to make sure you see rows of iOS device information. Also, select "Refresh" from the top menu to make sure this information refreshes. While in this tab as well please select an iOS device you know is on to make sure it is trying to check in. If you receive any errors or information is not showing please contact our Support team. 

  4. Go to the Clients tab of the FileWave Admin and make sure you see your correct group structure and your Clients showing. Remember your FileWave Clients should still be locked so they will not be getting any changes yet. 

  5. Update the Model, If this fails please contact our Support team

  6. Go back to the FileWave client tab and unlock one or two clients that you know are on to make sure they are checking in correctly. We suggest checking a couple of machines before unlocking all your clients. 

    unlockdevices

  7. After you’re confident these devices are working correctly, you can select all of your devices and unlock them. 

  8. If everything looks good, move on to upgrading your Boosters and Clients if needed.

6. Upgrading your FileWave Boosters

Upgrading your FileWave Boosters

The process of upgrading Boosters is similar to upgrading the Central/Admin application as it does not require you to back up your FileWave Booster before the upgrade or uninstall the existing version. Starting with FileWave 14.4.0, you can upgrade the Boosters inside Admin. If your Boosters are not on 14.4.0 yet, download the installers directly on the Booster to install.

In FileWave Central (FileWave Admin), go to the Boosters tab. The simplest way to upgrade multiple boosters is to use the "Upgrade All Boosters" button in the toolbar of the Boosters section of the native console:

image.png

It automatically schedules all boosters to upgrade. Alternatively, you can select multiple boosters and use the context menu or toolbar button to upgrade them.

To track the progress of upgrading multiple boosters, you can use the new Booster Upgrade status field mentioned earlier. You can also use the new check box Upgrade available which allows you to filter out boosters that have no upgrade available. This check box is displayed in both the Boosters and Booster Details tabs:

image.png

image.png

If one Booster fails to upgrade, all remaining Boosters will cancel their scheduled upgrade to prevent any issues.

7. Upgrading the FileWave Client

Upgrading the FileWave client is not required immediately after upgrading the FileWave server but is highly recommended. Older versions of the FileWave client are compatible with newer releases of FileWave. When you are ready to upgrade your FileWave clients, simply deploy the provided Fileset to do so.

Never deploy the Custom Client PKG/MSI to the devices as a way to upgrade them. They are only for devices that are not currently enrolled in FileWave. Only upgrade the client using the Upgrade Fileset.

7.1 Upgrading your macOS clients

Upgrading your macOS clients

macOS client upgrade fileset

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

    Downloadspage

  2. Scroll down on the page until you see "macOS Upgrade Fileset" and select it. This will download a pre-made .fileset file that you can easily deploy to your devices without any modification.

    macOSdownloads

  3. Open your FileWave Central/Admin application and go to the Filesets tab. 

  4. Drag and drop the downloaded Fileset into the Filesets tab. This will automatically create a Fileset in FileWave. We highly recommend dragging it into the root level of the Filesets structure so that it is not accidentally associated without being tested. 

  5. Once it is in FileWave you should associate it to a handful of test devices as you would for any other Fileset in FileWave and Update the model. 

  6. After you’ve confirmed that the tested Clients upgraded successfully, associate to all macOS Clients and update the model. You can remove any old client upgrade Filesets after the new one is associated.

Each upgrade Fileset has Requirements for compatible versions of macOS. If a client is too old to support your version of FileWave, it will fail and remain on the original version.

7.2 Upgrading your Windows Clients

Upgrading your Windows Clients

Windows client upgrade fileset

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

    Downloadspage

  2. Scroll down on the page until you see "Windows Upgrade Fileset" and select it. This will download a pre-made .fileset file that you can easily deploy to your devices without any modification.

    Windowsdownloads

  3. Open your FileWave Central/Admin application and go to the Filesets tab. 

  4. Drag and drop the downloaded Fileset into the Filesets tab. This will automatically create a Fileset in FileWave. We highly recommend dragging it into the root level of the Filesets structure so that it is not accidentally associated without being tested. 

  5. Once it is in FileWave you should associate it to a handful of test devices as you would for any other Fileset in FileWave and Update the model. 

  6. After you’ve confirmed that the tested Clients upgraded successfully, associate to all Windows Clients and update the model. You can remove any old client upgrade Filesets after the new one is associated.

Each upgrade Fileset has Requirements for compatible versions of Windows. If a client is too old to support your version of FileWave, it will fail and remain on the original version.

8. Upgrading the iOS/iPadOS App Portal IPA

Upgrading the iOS/iPadOS App Portal IPA

If you are deploying the IPA version of the App Portal for TeamViewer or Location Tracking, please use the following KB to keep the App Portal up to date.

For FileWave 15.3.0+ please note that the IPA is automatically deployed. Once 15.3.0 is released please see: Automatic updating of iOS/iPadOS Kiosk (15.3+)

9. macOS DEP and Windows MDM: Upgrade Client Packages

macOS DEP and Windows MDM: Upgrade Client Packages

When a macOS device finishes DEP enrollment into FileWave, your server sends a single client installer package. When you update your server to a newer one, you may also update this package.

  1. Visit custom.filewave.com and build a new custom PKG and/or MSI

  2. Once downloaded unzip the download

  3. Then visit the admin preferences and upload the package into the appropriate tab

    1. macOS DEP:

      1. Preferences > Mobile > macOS > "Upload macOS client package"
    2. Windows MDM

      1. Preferences > Mobile > Windows
  4. Browse for the downloaded and unzipped installer

  5. Wait for the message that it is uploaded.

  6. Press OK to save and finish

If you have upgraded every client, booster, and IVS above FileWave 13.1, you can disable Compatibility Mode: What is Compatibility Mode?