Content Gateway (Windows) Install Overview
The following article is intended to assist AirWatch Customers and Agents install, validate and troubleshoot the Windows Content Gateway.
for more information on an
assisted install. Reach out to
your Account Executive to
The install guide is intended to walk users through the preparation, installation and configuration of the Windows Content Gateway.
Provides a detailed explanation of all general, hardware, software and network requirements for a successful installation of the Windows Content Gateway. Please only reference the tab for the component you wish to install.
This instructional install video shows the step by step process for installing and validating the Windows Content Gateway.
Provides tests and checks to perform in order to validate that the component has been successfully installed and configured. These should always be performed after a new install or upgrade to confirm functionality.
How to guide for gathering Windows Content Gateway logs. These logs will be needed if you run into any issues with the Windows Content Gateway during or after an install or upgrade. It will also help our support team assist you more quickly if these are provided up front.
This forum provides resolutions to common issues and error messages that are encountered during a Windows Content Gateway install. Please be sure to gather logs prior to beginning troubleshooting.
The following steps should be performed after a Windows Content Gateway install or On Premise upgrade to confirm that the Content Gateway was installed/updated successfully. If you encounter issues at any point during validation, please proceed to the Content Gateway (Windows) Logs and Install Troubleshooting sections.
|Validation Step||Actions||Expected Results|
|Step 1 - Ensure Gateway is Enabled||Navigate to Groups & Settings > All Settings > Content > Content Gateway||"Enable the Content Gateway" is set to enabled.|
|Step 2 - Content Gateway Test Connection||Navigate to Groups & Settings > All Settings > Content > Content Gateway||Test connection is successful|
|Step 3 - Check Programs on Content Gateway Server||Go to the server that Content Gateway was installed on. Search for Programs & Features||AirWatch Content Gateway should appear as a program.|
|Step 4 - Check Installer Log||Navigate to the log file in the location where the installer was initially downloaded. Open the log file, scroll to the bottom and ensure the log doesn't show any errors.||Installation completed with no errors.|
The following steps should be performed after a Windows Content Gateway install or On Premise upgrade to confirm Content Gateway feature functionality.
|Validation Step||Actions||Expected Results|
|Step 1 - Add Repository in Console||Navigate to Console > Content > Repositories > Add a Repository. Enter information and check "Access via MAG/Content Gateway". Test connection and save.||Test connection succeeds and repository saves.|
|Step 2 - Access Repository on Device||Open the Content Locker on your device and open the Repository.||You should see all the file names on your repository within the Content Locker application.|
|Step 3 - Download File from Content Locker Repository||Once you are in the Admin Repository, download a file and open it.||File successfully downloads and you are able to open the file|
Content Gateway (Windows) Logs
The following article provides information on how and when to collect and verbose logs related to the Windows Content Gateway.
Collecting logs from the Content Gateway is an effective way of finding the source of an issue with your Content Gateway. If you are receiving errors when trying to connect to your Content Repository, if content is not pushing down to devices, if your test connection to your Content Gateway is failing, etc. There are many troubleshooting steps you can try before collecting logs but if you are submitting a support ticket the time to resolve the ticket will be much quicker if you include the logs.
To collect logs from the Content Gateway, simply enable CGContent.log (Mobile Content Management) Verbose Logging:
1. On the Content Gateway server, open Windows Explorer and browse to C:\AirWatch\AirWatch #.#\AirWatch.EnterpriseIntegration.Content\
#.# is the AirWatch version – if there are multiple, choose the most recent.
2. Locate the web.config file. Open the file in an editor (such as Notepad) and search for the loggingConfiguration tag.
3. Copy the current line of text to a new file (such as one on your Desktop) for later use.
4. Change the value of the line to resemble the following (all on one line) and save the file:
"loggingConfiguration filePath="..\..\Logs\ContentGateway\CGContent.log" tracingEnabled="true" level="Verbose" logFileRollSize="20480" maxArchivedFiles="20"/"
5. Reproduce the issue, copy the CGContent.log from C:\AirWatch\Logs\ContentGateway\ to a new location, and then change the values back to their original configuration ("Error").