Configuration Steps
---------------------

1. Use your web browser to go to your VOSS Agent's
   management portal.
#. Log in with the credentials provided by the VOSS support Team:

   |image24|

   **Figure 1 - VOSS Agent login screen**

3. Click on the menu button on the top right corner and select **Data Sources**:

   |image25|

   **Figure 2 - VOSS Agent data source configuration**

   This will direct you to the data source configuration page.

4. Click on the blue **+** sign on the top left corner to create a new
   data source.
#. On the next screen, please choose the **vendor** and **type** as
   "Microsoft" and "Microsoft Teams Connector" respectively; give your
   data source a name, and click on the **Next** button:

   |image26|

  **Figure 3 - VOSS Agent data source configuration for Microsoft Teams**

6. On the next screen, choose the newly defined data source, and click
   on **Edit**. This will enable the corresponding database and API
   configuration menus. Start with the Data API configuration. Enter the
   following:

   - Data Source Name: This is a description of your data source.
   - Enable/Disable checkbox: Make sure that this checkbox is checked
     for successful data collection.
   - Username: Enter the username for the "Global Reader" account that
     was generated on the Microsoft Admin Portal as part of the prerequisites for this guide.
   - Password: Enter the password for the "Global Reader" account that
     was generated on the Microsoft Admin Portal as part of the
     prerequisites for this guide.

   |image27|

   **Figure 4 - VOSS Agent Microsoft API configuration for Teams**

7. Click on the **Validate** button which validates that all the required
   values are entered.
#. Click on the **Test** button which checks your Microsoft "Global Reader" account access.
#. Click on the **Save** button to finalize the API configuration.

   .. note::

     * The **Save** button will not be available until you validate
       your configuration and test it against the Microsoft API.
     * Depending on the network connection speed that is available to
       VOSS Cloud Collector, the "Test" phase may take up to a minute.

10. Click on the **Database Configuration** tab for the same data source
    profile. This is where you enter the connection details for a VOSS
    Dashboard Server which will host your collected data.
#. From the drop-down menu, select "Reporter DB".
#. Enter the IP address for the VOSS Dashboard Server.
#. "Retry Delay" is used to determine how long to wait before attempting
   to connect to the Dashboard Server Database after a failed
   connection. You may leave this attribute as is.

   .. note::

      VOSS Collector uses an encrypted channel to upload the processed data to VOSS
      Dashboard Server. This is a unidirectional connection that is initiated
      by the VOSS Collector using port TCP/5432. In case, you have a
      firewall/NAT device between the VOSS Collector and your Dashboard
      Server, please ensure that you make the necessary changes on your
      network to allow this incoming traffic thru the firewall/NAT device. If
      the collector is hosted by VOSS, our support team can provide the
      specific public IP address that the incoming connection attempts will be
      coming from.

14. Click on the **Validate** button which validates the values entered.
#. Click on the **Test** button which checks the connectivity to VOSS
   Dashboard Server.
#. Click on the "Save" button to finalize the database configuration.

   |image28|

   **Figure 5 - VOSS Agent database configuration**

   At this point, we completed the configuration that is needed to collect
   and process Microsoft Teams data. The next step is to create a data
   source to collect the service health details.

17. Click on the blue **+** sign on the top left corner again to create a
    new data source.
#. On the next screen, please choose the **vendor** and **type** as
   "Microsoft" and "Microsoft Teams Connector" respectively; give your
   data source a name, and click on the **Next** button:

   |image29|

   **Figure 6 - VOSS Agent data source configuration for Microsoft
   Health Status**

19. On the next screen, choose the newly defined data source, and click
    on **Edit**. This will enable the corresponding database and API
    configuration menus. Start with the Status API configuration. Enter
    the following:

    - Data Source Name: This is a description of your data source.
    - Enable/Disable checkbox: Make sure that this checkbox is checked
      for successful data collection.
    - Client ID: The client ID that you created during application
      registration.
    - Client Secret: The client secret that you created during
      application registration.
    - Tenant ID: The tenant ID that is
      assigned to your Microsoft Azure account.

    |image30|

    **Figure 7 - VOSS Agent Microsoft API configuration for Teams**

20. Click on the **Validate** button which validates that all the required
    values are entered.

#. Click on the **Test** button which checks for successful authentication
   with the Microsoft API.

#. Click on the **Save** button to finalize the API configuration.

   .. note::

      * The **Save** button will not be available until you validate your configuration
        and test it against the Microsoft API.
      * Depending on the network connection speed that is available to
        VOSS Cloud Collector, the "Test" phase may take up to a minute.

23. Click on the **Database Configuration** tab for the same data source
    profile. This is where you enter the connection details for a VOSS
    Dashboard Server which will host your collected data.
#. From the drop-down menu, select **Reporter DB**.
#. Enter the IP address for the VOSS Dashboard Server.
#. "Retry Delay" is used to determine how long to wait before attempting
   to connect to the Dashboard Server Database after a failed
   connection. You may leave this attribute as is.

At this point, we completed the configuration that is needed to collect
and process Microsoft 365 Health and Incident data. Your VOSS Cloud
collector is already collecting data.

There is only one more step remaining before you can start seeing some
data on your dashboards. The module file that configures all the
services and features internally for your needs to be imported to your
cloud collector.

Import the module file
.........................

The final step is to import the module file that enables the internal
features needed to start the collection.

1. Click on your username on the top right corner and choose the
   **Configuration** menu:

   |image31|

   **Figure 6 - VOSS Agent import module**

2. Click on the **Choose File** button and locate the import file that you
   received from VOSS.
#. Click on the **Upload and Check** button.

   .. note::

      The import process will not work unless the API and database configurations are complete.

4. Click on the **Deploy** button to complete the import:

   |image32|

   **Figure 7 - VOSS Agent module deployment**

5. The configuration of the agent is now complete. Please proceed to
   your Dashboard server and locate your corresponding Microsoft Teams
   dashboards.




.. |image0| image:: /src/images/MS_e11ba145eaa6f31e.png
.. |image1| image:: /src/images/MS_539a21c0f9cc6ede.png
.. |image2| image:: /src/images/MS_267f479d31471949.png
.. |image3| image:: /src/images/MS_3b60e1f6333c648e.png
.. |image4| image:: /src/images/MS_b68989c22689da44.png
.. |image5| image:: /src/images/MS_49246531e06268b8.png
.. |image6| image:: /src/images/MS_6c20c742eaca1425.png
.. |image7| image:: /src/images/MS_6987a54bf3177853.png
.. |image8| image:: /src/images/MS_8978a008073d55c1.png
.. |image9| image:: /src/images/MS_8978a008073d55c1.png
.. |image10| image:: /src/images/MS_7c990282619857db.png
.. |image11| image:: /src/images/MS_9d15bb374e85e091.png
.. |image12| image:: /src/images/MS_81d73459d9578ab.png
.. |image13| image:: /src/images/MS_cf0a5ae19fd204c4.png
.. |image14| image:: /src/images/MS_ce047d8ba8d04d98.png
.. |image15| image:: /src/images/MS_9967d6b1b895d018.png
.. |image16| image:: /src/images/MS_deea9d98523231d3.png
.. |image17| image:: /src/images/MS_eb86de4f5f97f983.png
.. |image18| image:: /src/images/MS_167fdffc5753810.png
.. |image19| image:: /src/images/MS_11ccceb99cca16dc.png
.. |image20| image:: /src/images/MS_24145da551d30c95.png
.. |image21| image:: /src/images/MS_200ff8020c80f990.png
.. |image22| image:: /src/images/MS_f0b1e402ff048907.png
.. |image23| image:: /src/images/MS_14eabf9515d0d235.png
.. |image24| image:: /src/images/MS_6ee50b5ef2ad7338.jpg
.. |image25| image:: /src/images/MS_5bfd94f358353f3c.jpg
.. |image26| image:: /src/images/MS_b97d1388277a8c88.jpg
.. |image27| image:: /src/images/MS_b7c3d1b2f55be057.jpg
.. |image28| image:: /src/images/MS_795f62e868eaae5b.jpg
.. |image29| image:: /src/images/MS_f7e7a35d3acb1ea0.jpg
.. |image30| image:: /src/images/MS_ce4775ff200c420f.jpg
.. |image31| image:: /src/images/MS_8f41fe9dc5efc5c3.jpg
.. |image32| image:: /src/images/MS_83d741c12d7c2b9d.jpg