# Troubleshooting

# FileWave Server Mail test receives Bad Request with Google SMTP Accounts

## **What**

Setting up the Mail settings within FileWave preferences to send reports is great. However, the first time configuring this feature with Google accounts may run into errors like Bad Request as seen below.

[![BadRequest.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/p4XADkBIE1KPfJvM-badrequest.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/p4XADkBIE1KPfJvM-badrequest.png)

## **When/Why**

When first-time setting up FileWave mail preferences, you need to set up 2FA with your Google account to add FileWave as a custom application for third-party management. This allows permission for FileWave to send emails to your Google account.

![FileWave Admin Preferences 2022-11-02 at 9.43.50 AM-20221102-134352.jpg](https://kb.filewave.com/uploads/images/gallery/2023-06/kpr5K1ytrKJ8uRtG-filewave-admin-preferences-2022-11-02-at-9-43-50-am-20221102-134352.jpg)

## **How**

Be sure to enable 2FA on your Google account to have access to Signing in to Google. You may follow the Google documentation here: [Manage third-party apps &amp; services with access to your Google account](https://support.google.com/accounts/answer/3466521?hl=en). Once you have enabled it, there will be an option for App passwords. Here you may create a custom name for the app, and it will generate a password that you will copy and paste into FileWave email preferences.

Attempt again by sending a test email to verify FileWave and Google account permissions.

[![GoogleAppPassword0.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/6TiN4xpvXiUuKUgN-googleapppassword0.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/6TiN4xpvXiUuKUgN-googleapppassword0.png)

[![GoogleAppPassword1.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/NlLN3mL4JT4Eg60E-googleapppassword1.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/NlLN3mL4JT4Eg60E-googleapppassword1.png)

[![GoogleAppPassword2.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/j6UlDHoH6VR3IqSD-googleapppassword2.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/j6UlDHoH6VR3IqSD-googleapppassword2.png)

[![GoogleAppPassword3.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/axh5MgVnxhszFEV7-googleapppassword3.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/axh5MgVnxhszFEV7-googleapppassword3.png)

[![GooglePassword4.png](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/ky6ztRBizPaAU6uo-googlepassword4.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/ky6ztRBizPaAU6uo-googlepassword4.png)

## Related Links

- [Generating scheduled reports](https://kb.filewave.com/books/filewave-central-anywhere/page/generating-scheduled-reports "Generating scheduled reports")
- [Sending Scheduled Reports to More Than One Address](https://kb.filewave.com/books/filewave-central-anywhere/page/sending-scheduled-reports-to-more-than-one-address "Sending Scheduled Reports to More Than One Address")
- [Configuring FileWave Server Basic Preferences](https://kb.filewave.com/books/filewave-central-anywhere/page/configuring-filewave-server-basic-preferences "Configuring FileWave Server Basic Preferences")

# Adjusting the Idle Timeout in FileWave Anywhere (WebAdmin)

## What

This article will guide you on how to change the idle timeout setting in FileWave Anywhere (WebAdmin). By default, the idle timeout is set to 25 minutes. This means that if there is no activity on the interface for 25 minutes, the user will be automatically logged out. However, depending on your needs, you may find this period too short or too long.

## When/Why

You might want to change this setting if the default 25-minute timeout does not suit your work patterns or security needs. If you frequently need to step away from your work but find yourself logged out when you return, you might want to extend this timeout. Conversely, if you're concerned about leaving the interface open and unattended for too long, you might want to reduce the idle timeout.

<p class="callout danger">However, it is important to bear in mind that extending the idle timeout can potentially increase security risks. For example, if you log into FileWave Anywhere on a shared or public computer and forget to log out, you could remain logged in until the timeout occurs, leaving your account vulnerable.</p>

## How

To adjust the idle timeout, you will need to modify a specific line in the `settings_custom.py` file on your FileWave Server. This file is located at `/usr/local/filewave/django/filewave/` on macOS or Linux systems.

<p class="callout info">**Please note:** If you are a hosted customer, you will not have direct access to the server and will need to contact FileWave Support to have them make this change for you.</p>

Here is the process for self-hosted customers:

1. Open the `settings_custom.py` file in a text editor.
2. Add or modify the following line:   
    `UI_INACTIVITY_TIMEOUT = 25 * 60 # seconds the UI can stay inactive before auto logoff`
3. Replace the `25` in this line with the number of minutes you want for your idle timeout. For instance, if you want the timeout to be 60 minutes, the line should read: `UI_INACTIVITY_TIMEOUT = 60 * 60`.
4. Save and close the file.
5. To activate the change, you need to restart the server. Do this by running the following command in the terminal: `fwcontrol server restart`.

After these steps, the idle timeout will be set to the number of minutes you specified.

# Could not create the /Volumes/XYZ directory error when opening client info

## Problem

Client Info may show a "Could not create the directory" error when its last Export Current Tab location no longer exists. This commonly happens after exporting to an external drive and then disconnecting that drive. The path in the message will usually be different from the example below.

![](https://kb.filewave.com/uploads/images/gallery/2023-07/4pXw8JTXQsOXrUc7-embedded-image-odlvkxcj.png)

## Solution

Select a new export location to clear the error:

- Open Client Info for a macOS or Windows client.
- Select "Export Current Tab" on the left side of the Client Info window.
- Choose a local folder on the computer, such as your desktop.
- Select "Save".

![](https://kb.filewave.com/uploads/images/gallery/2023-07/0Vp2sY6IxQpNaNR1-embedded-image-0hbhmjuf.png)

- Close Client Info and open it again. The directory error should no longer appear.

# Dashboard Warning levels and Descriptions

## Problem

The table below provides an overview of the information that is returned by the Dashboard in the FileWave Admin console.

## Environment

FileWave Central Console

## Resolution

<table id="bkmrk-item-description-fre" style="width:100%;"><thead><tr style="background-color:rgb(251,238,184);"><th style="width:23.2404%;">Item</th><th style="width:76.7596%;">Description</th></tr></thead><tbody><tr><td style="width:23.2404%;">Free Disk Space</td><td style="width:76.7596%;">Free disk space on fwxserver (db location). Warning if &lt; 50GB or &lt; 20% Total space, Error if &lt; 25GB or &lt; 10% total space.</td></tr><tr><td style="width:23.2404%;">CPU Load</td><td style="width:76.7596%;">CPU Load on fwxserver. Always OK.</td></tr><tr><td style="width:23.2404%;">Google Cloud Messaging</td><td style="width:76.7596%;">Returns Google Cloud Messaging status. Cached 1 minute. Error if configuration is not correct.</td></tr><tr><td style="width:23.2404%;">Total Disk Space</td><td style="width:76.7596%;">Total disk space on fwxserver (db location).</td></tr><tr><td style="width:23.2404%;">Client distribution</td><td style="width:76.7596%;">Returns client OS distribution (OSX, Windows, iOS, Android...). Cached 1 minute.</td></tr><tr><td style="width:23.2404%;">Free RAM</td><td style="width:76.7596%;">Free RAM on fwxserver. Always OK as some systems like OSX will free memory on demand only.</td></tr><tr><td style="width:23.2404%;">APN for MDM</td><td style="width:76.7596%;">Returns APN certificate status for MDM. Cached 1 minute. Warning if certificate expires in less than 30 days. Error if certificate is missing, expired, or Root certificate is missing.</td></tr><tr><td style="width:23.2404%;">VPP Tokens</td><td style="width:76.7596%;">Returns VPP tokens status. Cached 5 minutes. Warning if token expires in less than 30 days. Error if token is expired or incorrect.</td></tr><tr><td style="width:23.2404%;">FileWave Client/Mobile License</td><td style="width:76.7596%;">Returns License Status. Cached 1 minute. If you have more than 50 licenses: warning if available count goes below 10, error when 0. If you have less than 50 licenses: warning if available count goes below 4, error when 0.</td></tr><tr><td style="width:23.2404%;">Entreprise app file (ipa)</td><td style="width:76.7596%;">Check ipa status. Cached 1 hour. Warning if IPA file is local but does not have expected size. Error is IPA file is not on disk for local IPA, or not reachable for external IPAs.</td></tr><tr><td style="width:23.2404%;">DEP Accounts</td><td style="width:76.7596%;">Returns DEP Accounts status. Cached 5 minutes. Warning if access token expires in less than 30 days. Error if token is expired or incorrect.</td></tr><tr><td style="width:23.2404%;">Email sent</td><td style="width:76.7596%;">Returns Email sent status for the 7 past days. Cached 5 minutes. Warning if mails are still in the queue (not sent) Error if mails could not be sent (SMTP error). Note that we can't check if the POP/IMAP server rejected the mail. returns the following dict : 'success': , 'pending': , 'error': : , ...</td></tr><tr><td style="width:23.2404%;">Email settings</td><td style="width:76.7596%;">Returns email settings status. Cached 5 minutes. Error if can't connect to SMTP server.</td></tr><tr><td style="width:23.2404%;">LDAP Extraction status</td><td style="width:76.7596%;">LDAP Extraction status. Warning if one or more servers have not been contacted yet, Error if there was an error during extraction.</td></tr><tr><td style="width:23.2404%;">Total RAM</td><td style="width:76.7596%;">Total RAM on fwxserver.</td></tr><tr><td style="width:23.2404%;">Smart Group Count</td><td style="width:76.7596%;">Number of evaluated SmartGroups. Warning if last report occurred more than 1h ago, error if 2h ago.</td></tr></tbody></table>

### Related Content

- [Configuring and using the Dashboard](https://kb.filewave.com/books/filewave-central-anywhere/page/configuring-and-using-the-dashboard "Configuring and using the Dashboard")

# Opening FileWave Central / Anywhere in a Specific Language (macOS)

## What

FileWave Admin will automatically use the language, if supported, set on the workstation at installation (default English). It is however possible to run FileWave Admin in a different language, as shown below.

## When/Why

Sometimes even though your computer is running in a language like German you may wish to run Central in English.

## How

##### **macOS (FW 16.2.0 and higher)**

You can now pick a language other than the system on in both Central and Anywhere as shown below in the images. Although the image of Central is from macOS, it looks the same on Windows.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2025-08/scaled-1680-/V1WGBxoBq2lSpxVR-image.png)](https://kb.filewave.com/uploads/images/gallery/2025-08/V1WGBxoBq2lSpxVR-image.png)  
</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2025-08/scaled-1680-/ssygEWpYF2TwblHK-image.png)](https://kb.filewave.com/uploads/images/gallery/2025-08/ssygEWpYF2TwblHK-image.png)  
</td></tr></tbody></table>

##### **macOS (FW 16.1.x and lower)**

In FileWave versions below 16.2.0 you would need to use the command below to open Central in another language. Anywhere would use your Browser language;

The following command may be used to both open and specify a chosen language at runtime.

```
/Applications/FileWave/FileWave\ Admin.app/Contents/MacOS/FileWave\ Admin --lang en_US &
```

<table id="bkmrk-language-locale-code" style="width: 108.452%; height: 357.563px;"><thead><tr style="background-color: rgb(251, 238, 184); height: 29.7969px;"><th style="width: 26.4274%; height: 29.7969px;">**Language**

</th><th style="width: 15.1713%; height: 29.7969px;">**Locale Code**

</th><th style="width: 58.4013%; height: 29.7969px;">**Notes**

</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**English (US)**

</td><td style="width: 15.1713%; height: 29.7969px;">en\_US

</td><td style="width: 58.4013%; height: 29.7969px;">Use for American English.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**German**

</td><td style="width: 15.1713%; height: 29.7969px;">de\_DE

</td><td style="width: 58.4013%; height: 29.7969px;">Standard locale for German in Germany.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**French**

</td><td style="width: 15.1713%; height: 29.7969px;">fr\_FR

</td><td style="width: 58.4013%; height: 29.7969px;">Standard locale for French in France.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Korean**

</td><td style="width: 15.1713%; height: 29.7969px;">ko\_KR

</td><td style="width: 58.4013%; height: 29.7969px;">Korean for South Korea.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Japanese**

</td><td style="width: 15.1713%; height: 29.7969px;">ja\_JP

</td><td style="width: 58.4013%; height: 29.7969px;">Japanese for Japan.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Chinese (Simplified)**

</td><td style="width: 15.1713%; height: 29.7969px;">zh\_CN

</td><td style="width: 58.4013%; height: 29.7969px;">For Mainland China.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Chinese (Traditional)**

</td><td style="width: 15.1713%; height: 29.7969px;">zh\_TW

</td><td style="width: 58.4013%; height: 29.7969px;">For Taiwan.

</td></tr></tbody></table>

# Opening FileWave Central / Anywhere in a Specific Language (Windows)

## What

When you install FileWave Admin, it will automatically use the language you have set on your workstation (if not available, it will default to English). If you want to change FileWave to run in another language, you have to launch Central/Admin with an argument that specifies the desired language.

## When/Why

Sometimes even though your computer is running in a language like German you may wish to run Central in English.

## How

##### **Windows (FW 16.2.0 and higher)**

You can now pick a language other than the system on in both Central and Anywhere as shown below in the images. Although the image of Central is from macOS, it looks the same on Windows.

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>[![FileWave Admin 2025-08-29 15.02.55.png](https://kb.filewave.com/uploads/images/gallery/2025-08/scaled-1680-/Km2fywj9uemHBHGK-filewave-admin-2025-08-29-15-02-55.png)](https://kb.filewave.com/uploads/images/gallery/2025-08/Km2fywj9uemHBHGK-filewave-admin-2025-08-29-15-02-55.png)

</td><td>[![image.png](https://kb.filewave.com/uploads/images/gallery/2025-08/scaled-1680-/DYBMBNeBw19F6JC8-image.png)](https://kb.filewave.com/uploads/images/gallery/2025-08/DYBMBNeBw19F6JC8-image.png)

</td></tr></tbody></table>

##### **Windows (FW 15.4.2 and lower)**

If you want to open the FileWave Central/Admin Application in a different Language, you would use the following command to launch. In this article, we’re going to automate the process so it opens with your preferred language every time using a Desktop Shortcut.

```
"C:\Program Files (x86)\FileWave\FileWaveAdmin.exe" --lang en_US
```

##### **Windows (FW v15.5.0 or higher until 16.2.0)**

```
"C:\Program Files\FileWave\admin\FileWaveAdmin.exe" --lang en_US
```

Available Language Options:

<table id="bkmrk-language-locale-code" style="width: 108.452%; height: 357.563px;"><thead><tr style="background-color: rgb(251, 238, 184); height: 29.7969px;"><th style="width: 26.4274%; height: 29.7969px;">**Language**

</th><th style="width: 15.1713%; height: 29.7969px;">**Locale Code**

</th><th style="width: 58.4013%; height: 29.7969px;">**Notes**

</th></tr></thead><tbody><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**English (US)**

</td><td style="width: 15.1713%; height: 29.7969px;">en\_US

</td><td style="width: 58.4013%; height: 29.7969px;">Use for American English.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**German**

</td><td style="width: 15.1713%; height: 29.7969px;">de\_DE

</td><td style="width: 58.4013%; height: 29.7969px;">Standard locale for German in Germany.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**French**

</td><td style="width: 15.1713%; height: 29.7969px;">fr\_FR

</td><td style="width: 58.4013%; height: 29.7969px;">Standard locale for French in France.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Korean**

</td><td style="width: 15.1713%; height: 29.7969px;">ko\_KR

</td><td style="width: 58.4013%; height: 29.7969px;">Korean for South Korea.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Japanese**

</td><td style="width: 15.1713%; height: 29.7969px;">ja\_JP

</td><td style="width: 58.4013%; height: 29.7969px;">Japanese for Japan.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Chinese (Simplified)**

</td><td style="width: 15.1713%; height: 29.7969px;">zh\_CN

</td><td style="width: 58.4013%; height: 29.7969px;">For Mainland China.

</td></tr><tr style="height: 29.7969px;"><td style="width: 26.4274%; height: 29.7969px;">**Chinese (Traditional)**

</td><td style="width: 15.1713%; height: 29.7969px;">zh\_TW

</td><td style="width: 58.4013%; height: 29.7969px;">For Taiwan.

</td></tr></tbody></table>

# What is the difference between Revert and Restore?

## Problem

You need to undo FileWave model changes, but **Revert to Last Model** and `fwcontrol server restore` do different jobs.

Use revert when you want to discard changes that have not been published yet. Use restore when you need to make an older published model current again.

In FileWave Central, revert is available from **Server &gt; Revert to Last Model**.

![revert.png](https://kb.filewave.com/uploads/images/gallery/2023-06/iRlxCw3oGlM71P7t-revert.png)

Restore is run from the command line:

```shell
sudo fwcontrol server restore [version]
```

<p class="callout info">When you work in FileWave Central, your changes are made in the next model. They do not affect managed devices until you update the model.</p>

## Resolution

### Revert

Revert discards unpublished model changes and returns FileWave Central to the currently deployed model.

For example, the deployed model is 10. You open FileWave Central and make changes that would become model 11 when published.

- You create a Fileset called **My Fileset A**.
- You delete a Fileset called **Old Fileset B**.
- You move the association for **Fileset C** from **Group 1** to **Group 2**.

If you choose **Revert to Last Model** before updating the model, FileWave discards those unpublished changes and goes back to model 10.

If you already updated the model to 11, revert no longer helps because model 11 is now the current model.

### Restore

Restore makes a previous published model current again.

Using the same example, if you published model 11 and then realized model 10 was the last good model, restore model 10:

```shell
sudo fwcontrol server restore 10
```

<p class="callout info">The server keeps the last 20 models.</p>

After the command finishes, quit FileWave Central and open it again. Model 10 is now restored. In this example:

- **My Fileset A** no longer appears in the Filesets view, although its uploaded data may still exist on the server.
- **Old Fileset B** appears again in the Filesets view, but its payload data is missing from the server.
- The association for **Fileset C** points back to **Group 1**.

<p class="callout danger">Restoring a previous model does not restore deleted Fileset payload data. Use your backups for that.</p>

## Additional Information

If you need to recover from a major model mistake, contact [FileWave Support](https://help.filewave.com) before making more changes.