Add questions to using Fleet FAQ and deployment FAQ (#2912)

* add faq questions * Apply suggestions from code review Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com> * fix broken links * Update FAQ.md Co-authored-by: Mike Thomas <78363703+mike-j-thomas@users.noreply.github.com>
2021-11-15 17:55:57 -06:00
parent 5ac01dff4e
commit b7f2f3a0f0
2 changed files with 20 additions and 0 deletions
@@ -16,6 +16,7 @@
 - [How do I automatically assign a host to a team when it enrolls with Fleet?](#how-do-i-automatically-assign-a-host-to-a-team-when-it-enrolls-with-fleet)
 - [How do I resolve an "unknown column" error when upgrading Fleet?](#how-do-i-resolve-an-unknown-column-error-when-upgrading-fleet)
 - [Why my host is not updating a policy's response.](#why-my-host-is-not-updating-a-policys-response)
+- [What should I do if my computer is showing up as an offline host?](#what-should-i-do-if-my-computer-is-showing-up-as-an-offline-host)

 ## What do I need to do to switch from Kolide Fleet to FleetDM Fleet?

@@ -154,3 +155,11 @@ The following are reasons why a host may not be updating a policy's response:
 * The policy's query includes tables that are not compatible with this host's platform. For example, if your policy's query contains the [`apps` table](https://osquery.io/schema/5.0.1/#apps), which is only compatible on hosts running macOS, this policy will not update its response if this host is running Windows or Linux. 

 * The policy's query includes invalid SQL syntax. If your policy's query includes invalid syntax, this policy will not update its response. You can check the syntax of your query by heading to the **Queries** page, selecting your query, and then selecting "Save."
+
+## What should I do if my computer is showing up as an offline host?
+
+If your device is showing up as an offline host in the Fleet instance, and you're sure that the computer has osquery running, we recommend trying the following:
+
+* Try un-enrolling and re-enrolling the host. You can do this by uninstalling osquery on the host and then enrolling your device again using one of the [recommended methods](./04-Adding-hosts.md).
+* Restart the `fleetctl preview` docker containers.
+* Uninstall and reinstall Docker.
@@ -15,6 +15,8 @@
 - [What are the MySQL user access requirements?](#what-are-the-mysql-user-requirements)
 - [Does Fleet support MySQL replication?](#does-fleet-support-mysql-replication)
 - [What is duplicate enrollment and how do I fix it?](#what-is-duplicate-enrollment-and-how-do-i-fix-it)
+- [How long are enroll secrets valid?](#how-long-are-enroll-secrets-valid)
+- [Should I use multiple enroll secrets?](#should-i-use-multiple-enroll-secrets)

 ## How do I get support for working with Fleet?

@@ -133,3 +135,12 @@ You can deploy MySQL or Maria any way you want. We recommend using managed/hoste
 Duplicate host enrollment is when more than one host enrolls in Fleet using the same identifier (hardware UUID or osquery generated UUID). This can be caused by cloning a VM Image with an already enrolled
 osquery client. To resolve the issues, it's advised to configure `--osquery_host_identifier` to `uuid`, and then delete the single host record for that whole set of hosts in the Fleet UI. You can find more information about
 [host identifiers here](https://github.com/fleetdm/fleet/blob/main/docs/02-Deploying/02-Configuration.md#osquery_host_identifier).
+
+## How long are enroll secrets valid?
+
+Enroll secrets are valid until you delete them.
+
+## Should I use multiple enroll secrets?
+
+That is up to you! Some organizations have internal goals around rotating secrets. Having multiple secrets allows some of them to work at the same time the rotation is happening.
+Another reason you might want to use multiple enroll secrets is to use a certain enroll secret to auto-enroll hosts.