Page tree
Skip to end of metadata
Go to start of metadata

The process of setting up FileWave involves installing and configuring the FileWave Server, FileWave Admin, and FileWave Clients, at a minimum. You may also have to install and configure FileWave Boosters. For Imaging, you will need to download and setup the Imaging Virtual Server. To use Engage, you will need to download the Engage Server and setup the Engage services. This Chapter focuses on the installation and configuration of the various servers and configuring the FileWave Admin application. Following sections describe setting up Boosters and Clients, as well as working with the remainder of the FileWave components.

Overall requirements (for version 14+)

Primary requirements are a 64-bit quad-core CPU, 8+GB of RAM, and a boot volume with high IOPS to handle the database. The data folder can be moved to a non-boot volume with lower IOPS and more capacity. As with most servers, the more RAM that can be devoted to it, the better.

Operating Systems Supported:


  • macOS 10.12 through 10.15 (binaries are 64 bit only)
  • Windows Server 2012 R2 and Server 2016 From version 14, Windows Server is no longer supported as a platform for FileWave server, but you can run our virtual appliance on a Windows server host
  • Linux CentOS 6.9 x86_64, and 7.4 x86_64 (binaries are 64 bit only)


FileWave Server network ports

80

TCP/IP

outgoing for FileWave Software Updates (apple.com & microsoft.com)

443

TCP/IP

outgoing for FileWave License Server (fwks.filewave.com)

20005

TCP/IP

incoming for remote control publishing

20006

TCP/IP

incoming for remote control routing

20015

TCP/IP

incoming for client-server

20016

TCP/IP

incoming for admin-server

20017

TCP/IP

incoming for client-server secure (SSL)

20030

TCP/IP

incoming for remote control data

20443

TCP/IP

incoming for client-server profiles

20445

TCP/IP

incoming for client-server inventory

Full list of ports: Default TCP and UDP Port Usage


Install versus Upgrade




Before attempting to do any updated with FileWave, point your browser to our support site's software download page (https://www.filewave.com/support/software-downloads) and check for special instructions.
You must be at version 10 of the FileWave Server before you can upgrade to v11. As long as you are running FileWave Server version 7.x or higher, you can upgrade your existing server to v10, then run the Migration Checker script (available here: https://mc.filewave.com/). This script will verify your ability to migrate your system to the new all PostgreSQL database used in FileWave v11. The results will be emailed to the address you provide at the end of the command, and will come from noreply@filewave.com. The email subject will be either [FAIL] Upgrade check report or [PASS] Upgrade check report depending on what the script has discovered. If your FileWave v10 Server passes, you can upgrade to v11 without issue; if it fails, contact FileWave Support who will get the issues resolved and get you p-upgraded to v11.
It is recommended that you do a backup of your server first before proceeding (see below). If you were running beta versions of the server, you should move your Data folder to another drive and erase all FileWave parts before install.




Upgrading your FileWave server (Best Practice)

Generally, this is the workflow (specifics follow):

  1. Do a backup following these instructions: Automated Backup
  2. Lock computer clients.
  3. Upgrade the server.
  4. Upgrade the Admin(s).
  5. Update the Model.
  6. Upgrade Boosters
  7. Unlock a couple of clients. Verify that they see the Model number change. Deploy the upgrade Fileset to these test clients and ensure they upgrade without issue.
  8. Unlock and upgrade the other computer clients.
    • Use the Upgrade Fileset for upgrading existing Clients. The standard or custom .pkg/,msi should only be used for computers that do not have FileWave installed.
  9. Ensure iOS device communication. Skip if you have no iOS. Go into iOS Inventory, refresh from the toolbar, total count is accurate, sort by Last MDM Check-in Date, open Client Info, Command History and verify the device is receiving commands.


For more details on best practices while upgrading FileWave, visit: Upgrade FileWave

macOS FW Server install

System Requirements

Any 64-bit Macintosh system running macOS version 10.12+ will work for FileWave Server; and this does not require the OS X Server software. Make sure you use a system that is on an optimal network location, has sufficient disk space to handle all of your distribution content, and has at least 4GB of RAM (8GB+ recommended). The server will run as a background process; but the system it is running on should be a dedicated device. The server is running an active SQL database, and that DB uses lots of RAM. The more you can provide, the better behaved your server will be.

Setup

The FileWave Server is installed from the FileWave disk image. Download the latest image from the FileWave Support site. The disk image contains all the components to install the Server, the Admin application, the FileWave Client for macOS, and the FileWave Booster.

Location of key files

The server process is located in /usr/local/sbin/fwxserver. All content for the server is located in /fwxserver at the root of the boot volume.

Security - change the primary password

Once you have the FileWave Server up and running, you should change the password from the default ("filewave") to something a little more secure. The default master administrator account is fwadmin. You change the administrator's password by selecting the Manage Administrators… command from the Assistants menu.

Windows FW Server install

System Requirements

FileWave server requires Windows Server 2012 R2 and Server 2016 with at least 4GB of RAM and 100GB of hard drive space.

Setup

Download the latest .msi from the FileWave support site. Note: You should use a local administrator account to run the server installer instead of a domain administrator account.

Location of key files

The server process is running in C:\Program Files(x86)\FileWave\fwxserver. Important data is located in C:\ProgramData\FileWave\FWServer.

Security - change the primary password

Once you have the FileWave Server up and running, you should change the password from the default ("filewave") to something a little more secure. The default master administrator account is fwadmin. You change the administrator's password by selecting the Manage Administrators… command from the Assistants menu.

Linux (CentOS) FW Server install

System Requirements

FileWave server is supported on Linux CentOS 6.9 x86_64, and 7.4 x86_64 (binaries are 64 bit only.

Setup

Download the latest FileWave binaries for Linux on the following Website:
http://www.filewave.com/category/server
To download the newest binaries, click on the newest version, then scroll down until you see Linux installers.
Copy the Zip file directly to your Linux Server inside the root folder /root/
Login with SSH to the Server if necessary (on Windows use PuTTY, on macOS use Terminal) and make sure you login as root
Unzip the file with the following commands: (use two dashes in the nogpgcheck option)
#(this changes you to the root directory)
cd /root/
unzip FileWave_Linux_<FILEWAVEVERSION>.zip
yum install -y --nogpgcheck fwxserver*.rpm
yum install -y --nogpgcheck fw-mdm-server*.rpm
If there are any questions, answer them with yes or accept.
After everything is installed, you can connect to the server with your FileWave administrator console from either macOS or Windows.

Security - change the primary password

Once you have the FileWave Server up and running, you should change the password from the default ("filewave") to something a little more secure. The default master administrator account is fwadmin. You change the administrator's password by selecting the Manage Administrators… command from the Assistants menu.

Note: If you are running a VM environment, you can download a full Linux container of both Server and Booster from FileWave Support.

  • No labels