Skip to main content

Your Hosted FileWave Server Has Been Upgraded - What Are Your Next Steps?

What

The FileWave OPSOperations Team has upgraded your hosted FileWave server;Server. WhatUse stepsthis do you needchecklist to takeconfirm tothe continueenvironment managingand update the administrator tools, Boosters, clients, Kiosk, and enrollment packages that remain under your devices?control.

If your FileWave server is On-Premise and not hosted by FileWave, you may review the KB article here: Upgrading your On-Premise FileWave Server

When/Why

YouThe FileWave Operations Team will get an email fromyou with the FileWavescheduled OPSupgrade team stating that your FileWave server will be upgraded on a specified daydate and time. After thatthe hosted Server upgrade completes,is youcomplete, will need to dofollow the steps outlinedbelow. here..FileWave While your server is maintained bymaintains the FileWavehosted team,Server, but you willremain stillresponsible need to update yourfor FileWave Central/AdminCentral, applicationcustomer-managed Boosters, enrolled clients, and theenrollment clients enrolled.packages.

How

OnceAfter you havereceive receivedconfirmation an email fromthat the FileWavehosted OPSServer Team,upgrade statingis thatcomplete, yourbegin by updating FileWave server has completed the FileWave server upgrade. You may begin upgrading your FileWave Central application.Central.

1. 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. 

Please expand the section that relates to your server OS:

1.1 macOS Central Upgrade

macOS Central Upgrade

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

1.2 Windows Central Upgrade

Windows Central Upgrade

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

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

Launch FileWave Central 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, please contact 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 look at one or two clients that you know are on to make sure they are checking in correctly. 

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

3. Upgrading your FileWave Boosters

Upgrading your FileWave Boosters

TheFileWave processServer of16.4 upgradingautomatically schedules eligible customer-managed Boosters isfor similarupgrade to upgradingafter the Central/AdminServer applicationupgrade. asThe itdefault doesdelay notis requireseven 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.days.

In FileWave CentralCentral, (FileWaveopen Admin),Preferences go> Upgrades to review or change the Boosters tab.delay. The simplestsame waypane to upgrade multiple boosters is to usecontains the "Upgradeclient-upgrade Allbatch Boosters"size, buttonerror inthreshold, theand toolbarreport of the Boosters section of the native console:schedule.

image.pngFileWave Central 16.4 Upgrades preferences showing Client Upgrade and Booster Upgrade settings

ItFileWave automaticallyCentral schedules16.4 allcentralizes boostersclient-upgrade to upgrade. Alternatively, you can select multiple boosterscontrols and usethe automatic Booster-upgrade delay.

FileWave 16.4 validates both the context menu or toolbar button toreported upgrade them.

state

To trackand the progressinstalled ofBooster upgradingversion. multipleFailed boosters,automatic youupgrades canare useretried within defined limits, and one failed Booster does not cancel upgrades for the newremaining BoosterBoosters.

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 bothUse the Boosters view to monitor upgrade availability, scheduled work, and Boosterresults. DetailsInvestigate tabs:Boosters that remain below the target version or report repeated failures. Contact FileWave Support if a hosted upgrade leaves customer-managed Boosters unable to update.

image.png

FileWave

image.png

Servers

Ifearlier onethan 16.4 continue to use their version-specific manual Booster fails to upgrade, all remaining Boosters will cancel their scheduled upgrade to prevent any issues.workflow.

4. Upgrading the FileWave ClientClients

UpgradingClient upgrades do not have to begin immediately after the hosted Server upgrade, but keeping clients current is strongly recommended. The correct workflow depends on both the FileWave Server version and the client isversion.

Do not requireduse immediatelya after upgrading the FileWave server but is highly recommended. Older versions of the FileWavecustom client arePKG compatibleor with newer releases of FileWave. When you are readyMSI to upgrade youran FileWavealready clients,enrolled simplydevice. deployCustom client packages are for new installations and enrollment. Use integrated client upgrades or 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 theappropriate Upgrade Fileset.

4.1 UpgradingIntegrated yourupgrades for clients running 16.3 or later

Upgrade clients through Software Update

When the FileWave Server is running 16.4 or later, macOS and Windows clients already running FileWave Client 16.3 or later can be upgraded through Software Updates > Manage > FileWave Client Upgrades.

The integrated workflow stages upgrades in controlled batches, monitors progress, retries transient failures, pauses a target version when the configured permanent-failure threshold is reached, and provides reporting.

    Review Preferences > Upgrades and confirm the batch size, error threshold, and report schedule. Open Software Updates > Manage > FileWave Client Upgrades and select the target client version. Start with a representative pilot group. Monitor download, installation, retry, and failure status before expanding the rollout.

    4.2 Upgrade Fileset bridge for earlier clients

    UpgradeBridge yourclients running versions earlier than 16.3

    Clients running versions earlier than FileWave Client 16.3 must first use the macOS or Windows Upgrade Fileset from the FileWave Downloads page. The FileWave 16.4 Upgrade Filesets include a client-version requirement and are skipped on clients

    macOSalready clientrunning upgrade16.3 filesetor later.

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

      Downloadspage

      and download the macOS or Windows Upgrade Fileset for the target FileWave version.
    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

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

    Drag and dropImport the downloaded Fileset.fileset into theFileWave 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. 

    Central.

    Once it is in FileWave you should associateDeploy it to a handfulsmall test group of testclients devicesrunning asversions youearlier wouldthan for any other Fileset in FileWave and Update the model. 

    After you’ve confirmed that the tested Clients upgraded successfully, associate to all macOS Clients16.3 and update the model.Model.

    YouConfirm can remove any old client upgrade Filesets afterthat the newtest oneclients isupgraded associated.successfully before expanding the deployment. After the bridged clients reach 16.3 or later, manage future upgrades through the integrated Software Update workflow.

    Each upgradeUpgrade Fileset hasalso Requirementsincludes foroperating-system compatiblerequirements. versions of macOS. If aA client ison tooan oldunsupported tooperating supportsystem your version of FileWave, it will fail and remainremains on theits original version.

    4.2. Upgrading your Windows Clients

    Upgrading your Windows clients

    Windows client upgrade fileset

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

      Downloadspage

      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

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

      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. 

      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. 

      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 originalClient version.

      Windows upgrade troubleshooting: If thea Windows Client upgradeUpgrade filesetFileset does not complete, the client versioninventory does not updateshow inthe inventory,new version, or the client service does not restart, see Troubleshooting Windows Client Upgrade Fileset Issues.

      5. Upgrading theConfirm iOS/iPadOS AppKiosk Portal IPAlicensing

      Upgrading theConfirm iOS/iPadOS AppKiosk Portallicensing IPA

      FileWave Kiosk onfor iOS /and iPadOS is nowdistributed deployed fromthrough the Apple App Store as a VPP / VPP/Apps and Books app.application. Before upgrading, makeconfirm surethat FileWave is syncingsynchronizing with ASM/ABMApple School Manager or Apple Business Manager and that enough free FileWave Kiosk licenses have already been acquired.

      (

      See ReadAutomatic Moreupdating of iOS/iPadOS Kiosk) for the complete workflow.

      6. Prepare macOS DEP and Windows MDM:client Upgradepackages Clientfor Packagesnew enrollments

      Prepare client packages for new enrollments

      FileWave uses custom macOS DEP and Windows MDM:client Upgradepackages Clientfor Packages

      When a macOS device finishes DEPinitial enrollment intoand FileWave,new yourinstallations. serverThese sendspackages aare singlenot clientthe installerupgrade package.mechanism Whenfor youalready updateenrolled yourclients.

      server
      FileWave toServer a16.4 neweror one, you may also update this package.later
      1. In FileWave Central, open Preferences > Mobile.
      Select macOS or Windows. Select Show settings and review the package configuration. Select Build macOS client package or Build Windows client package. After the build completes, use the corresponding Download button when you need the installer for a new deployment. Enable Keep the package up to date when FileWave should rebuild the package after future Server upgrades.

      VisitFileWave Central 16.4 macOS client package build and download controls

      FileWave Server 16.4 manages the macOS enrollment package directly in FileWave Central.

      FileWave Central 16.4 Windows client package build and download controls

      FileWave Server 16.4 manages the Windows enrollment package directly in FileWave Central.

      FileWave Server earlier than 16.4

      Earlier supported FileWave Server versions continue to use custom.filewave.com anduntil buildthe aServer newis upgraded to 16.4.

        Build the required custom PKG and/or MSI at custom.filewave.com. Download

        Once downloaded,and unzip the download

        package. In

        ThenFileWave visitCentral, theopen admin preferences and upload the package into the appropriate tab.

          macOS DEP:

            Preferences > Mobile >and select the applicable macOS >or "UploadWindows macOS client package" pane. Upload

            Windowsthe MDM

            unzipped
              installer, Preferences > Mobile > Windows

              Browsewait for the downloadedsuccessful-upload andmessage, unzippedthen installer

              select OK.

              Wait forUpdate the messageModel thatwhen itthe ischange uploaded.

              requires distribution.

              PressDo OKnot deploy either package to savean andalready finishenrolled device as an upgrade. Use the client-upgrade workflow described in section 4.