Skip to end of metadata
Go to start of metadata

The following steps will help you get your Engage server up and running along with need steps for client connections.

Download all the needed parts:

Before starting making sure you have:

  • Downloaded the latest Engage Virtual appliance from: Engage Downloads Page

  • Downloaded the latest iOS engage ipa on the Engage downloads page for your specific version under the section “iOS App”

  • Downloaded the latest iOS and macOS push certificate from the Manage Push Certificate section at Manage Push Certs

  • Have VPP setup in your FileWave server and get the “EngageX” app as a device assignable. VPP Device Assignment KB

  • Download the Windows Engage Fileset from the latest Engage download page

  • Have a running FileWave server with desired clients enrolled

Certificate Considerations:

You will need to have a root trusted SSL certificate to use FileWave Engage. So your server will have to have a DNS name and a certificate to go along with it. If you have a wildcard cert for your organisation you can use that, else one has to be purchased. If you need help creating a root trusted certificate please use the guide linked here.


After the server is all setup how do you login?

After the setup steps are done for both the server and the clients, listed below, there are two ways you can login.

  • Through the app that was pushed out to your devices
  • From a web browser:
    • To login through a web browser go to: https://<FQDN of SERVER>

Engage uses https (port 443)

For all ports see: Default TCP and UDP Port Usage



Setting the Server up for the First Time:

  1. Download the latest Engage linked here
  2. Import the Engage Server into your virtual environment or use a player to start up the machine. Note: If you need help on this please use the help guide linked here
  3. When the server starts up it will display the IP address, be sure to make a note of this.
  4. It is recommended that you log into the machine (either console or SSH) and change the default password.

    Default Password

    filewave

    1. Open terminal (If on Windows you can use Putty linked here and use the credentials filewave/filewave then skip to step 3 below)
    2. Type in the following command

      ssh filewave@Engage-IP-Address
    3. Then type

      passwd
    4. Enter new Password




  5. Change the IP address to a static

    To change the IP you will just use normal Linux Debian commands: https://wiki.debian.org/NetworkConfiguration

Connecting Engage to the FileWave Server:

  1. Open and connect the FileWave Admin to your FileWave Server

  2. Open the preferences and go to the "Education" section then the“Engage” tab

  3. Enter the FQDN for the Engage Appliance into the Server Address field at the top

  4. Make sure the "generate new key" box is now checked and click OK to save and close the Admin preferences

  5. Open the Admin preferences and go to the  "Education" section → “Engage” tab again

  6. You should see a Green dot on the right of the Server Address field indicating the server is now connected.

    If red, be sure the DNS name is resolving to the correct IP of the server.

    For example. you can use he nslookup command to ask the dns server if it has an entry, and what the IP is.

    nslookup tonyqa.in.filewave.us






  7. Upload a root trusted certificate into the HTTPS Certificate Management pane. This will need to be for the DNS you gave the engage server, this can not be a self-signed cert but a root trusted.

    Wildcard certs are accepted, any help with root trusted certificates can be found here: Root Trusted Certs




  8. After you have upload a new certificate you will need to restart the nginx service on the Engage Server with the following command:

    service nginx restart

Adding Classroom data to your Engage Server:

There are two major ways to import this data. Automatically via Clever, and manually via CSV. Auomatic via Clever is recomended.

Clever

FileWave pulls in Teacher, Student, and Classroom data from your SIS with the help of Clever. We provide the Clever service to you with no additional cost and very minimal amount of setup.

  1. If you don't already have a Clever account go to: https://https://clever.com/signup
  2. Once you have created your account add FileWave to your Clever Apps. This sends FileWave an approval request
  3. When FileWave has approved your request (this is a manual process on our end) you will receive an email confirming your approval
  4. Now in Clever you an give the FileWave app the type of permission of what you would like it to sync
  5. Contact Clever to request your District ID
  6. Then in the FileWave Preferences go to Education and then the SIS tab
  7. Once there select edit settings, Clever, and paste in your District ID



  8. Once configured you can test sync to make sure it works


 CSV Import

Below you will see three links to sample CSV data. If you import and run them it will give you a teacher account (username: marcus password: marcus), and several student accounts (after you log in as a teacher you will see the list of students who's usernames are the same as their passwords. For example; Phil Benson would have a username: phil password: phil ; Rose Tyler u: rose p: rose). 

Use the CSV files as sample data to test with, or examples to make your own.

wget http://downloads.filewave.com/SampleEngageClass.zip;sudo apt-get -y install unzip;unzip ./SampleEngageClass.zip;cd SampleEngageClass;engage-control synchronize_engage --teachers=./teachers_full.csv --students=./students_full.csv --classes=./class_full.csv;cd ..;rm -rf SampleEngageClass


Setting up Engage for iOS, macOS, Windows, and Chromebook Support:

iOS and macOS:

  1. Downloaded the latest iOS and macOS push certificate from the Manage Push Certificate section at Manage Push Certs


  2. Once downloaded and unzipped you will need to uploaded those into the iOS and the macOS tabs





  3. For iOS you will need the Engage IPA available on the downloads page of the version Engage you are using located here just upload the IPA into FileWave by dragging the file from your finder/explore window straight into the Filesets section in the FileWave Admin
    Engage Downloads Page


  4. For macOS you will need to send out the EngageX application from VPP. For more information on how to setup and use VPP with iOS and macOS device use the following article:
    VPP Device Assignment KB


  5. Deploy the Engage IPA to your iOS devices and EngageX app to your macOS devices.

  6. Once you have the certificate and the app deployed the devices are now ready to go!


Self-Signed Certificate

    If you are using a self-signed certificate, you will need to follow this portion to get that certificate on
  1. You will need to to click the Get Current Certificate button at the bottom of the Engage Server tab. This download your current HTTPS cert you uploaded in earlier steps.





  2. Now that you have your current HTTPS certificate for engage you will need to upload that into the Certificate payload in a Profile. 





  3. Associate and deploy that profile out to all iOS and macOS device you wish to manage with Engage


Windows:

Download and deploy the Windows Engage Fileset found on the Engage downloads page:
Engage Downloads Page

Chromebooks:

To use Chromebooks in FileWave Engage you will need to have Chromebooks already set in the FileWave Management Server. Once done you will need to use the same setup guide as you did for the Management server for Engage. Simply follow the steps under the following section in the Quick Start Guide for Chromebooks

  1. Deploy the MDM Certificate
  2. Deploying the FileWave Inventory Extension
  3. Deploy configuration for the Inventory Extension

Quick Start Guide for Chromebooks


Congratulations you have fully setup FileWave Engage!