Skip to main content

Configuring FileWave Server Basic Preferences

This section covers the basic FileWave preferences of General, Organization Info, Kiosk, Inventory, Mail, Editor and Proxies. The more complex preferences - Mobile, LDAP, VPP&DEP, Engage, and Imaging are covered in their own sections.

General preferences

FileWave General settings break down into four sections:

Local settings

These are settings for each computer the FileWave Admin application is installed on. These are items that effect the interaction of the FW Admin with the FW Server.

  • FileWave Admin Auto Logout and Quit Time. Defines the longest interval the FW Admin application will sit idle before logging out the connected administrator and quitting.
  • More Confirmation Dialogs. Enables extra confirmation dialog boxes when moving/deleting items.
  • Show non-generic Unix owner and Group names. If enabled, Unix user IDs in Fileset contents windows will resolve to the local user account names.
  • Make new associations Kiosk by default (not including Software Update). Sets all new Fileset/device associations to automatically use the self-service Kiosk as their distribution method. This does not apply to Filesets created from the software update pane.
  • Use Alternating row colors…. Changes the view in the Admin panes to display a spreadsheet-like array of rows.

  • Ctrl-C copies just the active cell…. Allows the administrator to copy cells or entire rows of data within the various panes.
  • Client Member Port: The default TCP/IP port for a client to contact the FileWave server is 20010. You can change this value if needed, based upon network infrastructure requirements.

Server settings

The only setting here is your ability to limit the bandwidth for Fileset transfers from the Server to Boosters or Clients.

Apple Software Updates

These values define the URLs for the various Apple Software Update Servers' catalogs based on differing versions of OS X..

Microsoft Windows Updates

This is the known URL of the Microsoft software update catalog as of the publication of this document.

Organizational Info preferences

This setting pane provides the basic information concerning the managing organization. The data provided here will be shown as part of the overall device information.

Kiosk preferences

The self-service Kiosk preferences allow you to create and edit the various categories of Kiosk items offered to end users. You can also change the icon for an existing Kiosk item.


Use the [] or [-] buttons to add or delete a Kiosk item. When you have selected an existing Kiosk item, clicking on the [] button allows you to create sub-categories. Double-clicking on the title of a category allows you to change the name of the category. The Change Icon button lets you select a new graphic to display as the icon for a category. Icons should be in .png, .tiff, or .jpg format. They should also be no larger than 512x512 pixels in size. This is to keep the file size reasonable.
If you want to clear out your category set and return the FileWave defaults, click on the Revert to Defaults button and you will return to the eight (8) entries you started with. The Kiosk can be further customized with background images and titling. See the FileWave Support site for more information and directions.

Inventory preferences

The current version of FileWave has the asset management process, Inventory, included in the main FileWave Server install. Earlier versions of FileWave supported an Inventory server that could run on a different computer. The settings for Inventory on the current version can be left at the defaults; but information on the provided settings is below:

Inventory Server

The FileWave Inventory server and MDM server are now running on the same server. The server address should be a valid FQDN (fully qualified domain name). The default TCP port is 20445. If you change the Shared Key in Inventory, it will break any RESTful API scripts or interfaces you are using, until they are updated to use the new key.

iOS Inventory

  • Device Inventory Poll Interval - Default is 24hrs. This setting is how often all iOS devices will report their profiles, application, security and device settings.
  • Device Not Checked-In Notification – (applies to all MDM-enrolled devices) Default is 30 days. When a device exceeds the timeframe set, the color changes in the Client and Inventory view to alert the administrator that that device has not checked in with the MDM server.

Smart Groups

The button Refresh all Smart Groups forces a system-wide refresh of all the data requested by existing Smart Groups. (Smart Groups are discussed in detail in Chapter 8.)

Mail preferences

The mail preferences in the FileWave Server are used to support both scheduled reports and VPP email invitations. Both of these capabilities are covered in later portions of this manual. Setting up the mail preferences involves you having a common email account that will act as the sender or source of all outgoing mail from the FileWave Server. This account will show as the source of emails sent for scheduled reports and VPP MDM invitations.
You can select the sending (SMTP) server, port number (default is 587 with TLS), and whether to use encrypted email (TLS - transport layer security). You must enter a valid email account that can send mail from the designated email host. The Send test mail button allows you to verify that your settings work. It will have the FileWave Server generate a test message that will be sent from the host server, using the account you specify, and will come to the inbox of a designated user account.

Note that if you use Gmail or other email that requires 2FA then you may need to setup an app password to allow sending of email without 2FA for a server. Here is the Google documentation on this: FileWave Server Mail test receives Bad Request with Google Accounts

Editor preferences

FileWave's Filesets can contain plain text files, such as batch (.bat), configuration (.conf), and property list (.plist). The Editor tab allows you to customize which extensions can be edited within the Fileset Contents Window's text editor. This capability allows you to make simple changes to a file, even a script, inside a Fileset.
You can add the extension of a specific type of file so that it can be edited within the FileWave editor.  The below image shows adding .json to the list. (As of 15.4, .json will be included in the default list).

image.png

File types are usually limited to those that contain Unix or Windows line endings. You should test any file type that you plan on supporting before making that extension known to all of your FileWave administrators. More information on this capability and its use is in the Filesets / Payloads Chapter of this guide.

Proxies preferences

If you are using proxy servers in your environment, this preference pane will allow you to enter the credentials needed to let your FileWave Server authenticate with the proxy service. If your users' devices must go through a proxy server to access the FileWave server from outside your network, then you will need to add credentials here to allow your FileWave server to respond through that same proxy. You may also create unique override credentials for your FileWave Admin to use or bypass the proxy service, as needed.

  • Server Proxy Credentials – HTTP and SOCKS5 are the two protocol options, followed by host name, port, username and password.
  • Admin Proxy Credentials Override – HTTP and SOCKS5 are the two protocol options, followed by host name, port, username and password.

A Test button has been provided in the bottom right of each section to give feedback for your entered settings.