===
Mac
===

Obtaining troubleshooting logs and understanding the minimum system requirements for Mac operating system (OS) are both basic steps in troubleshooting issues.

.. contents::
   :local:
   :depth: 2

--------------------
Troubleshooting Logs
--------------------

.. _mac-troubleshooting-logs-start:

When softphone users encounter issues with the application, retrieve Session Initiation Protocol (SIP) logs or crash logs from their devices and send the files to the support team for troubleshooting purposes.

.. _mac-troubleshooting-logs-end:

^^^^^^^^
SIP Logs
^^^^^^^^

.. include:: android-devices-troubleshoot.rst
  :start-after: .. _android-sip-logs-start:
  :end-before: .. _android-sip-logs-end:

.. _enabling-sip-logging-mac:

''''''''''''''''''''
Enabling SIP Logging
''''''''''''''''''''

.. include:: android-devices-troubleshoot.rst
  :start-after: .. _android-enabling-sip-logs-start:
  :end-before: .. _android-enabling-sip-logs-end:

.. |ico4| image:: image/g-ios-settings-icon.svg
  :width: 16
  :alt: Desktop application setting icon

#.  Select |ico4| > **Controls**.
#.  Enable **Log SIP Traffic**.
    The **Logs** option displays at the left navigation menu of the **Settings** window.

'''''''''''''''''''
Retrieving SIP Logs
'''''''''''''''''''

.. include:: android-devices-troubleshoot.rst
  :start-after: .. _android-retrieving-sip-logs-start:
  :end-before: .. _android-retrieving-sip-logs-end:
  
.. note::

  If users intend to reproduce an error and record its details in the log for troubleshooting, they must first enable the logging function. 
  Refer to the :ref:`enabling-sip-logging-mac` section to turn on this function.

#.  Select |ico4| > **Logs**.
#.  On the **Logs** screen, touch the **Save** button.
    A **Pick save location** window displays.
#.  Change the file name or the location to save the files if needed.
#.  Touch the **Save** button on the **Pick save location** window.
#.  Send the log text file to the support team.

    .. raw:: html

      <iframe width="560" height="315" src="https://www.youtube.com/embed/D9gH0OK6d0k" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

^^^^^^^^^^
Crash Logs
^^^^^^^^^^

.. _mac-crash-logs-start:

A crash log is generated by the softphone application when it crashes or encounters an error that causes it to shut down. The log contains the error details that are useful for diagnosing and debugging.

.. _mac-crash-logs-end:

'''''''''''''''''''''
Retrieving Crash Logs
'''''''''''''''''''''

.. _mac-retrieving-crash-logs-start:

Softphone desktop application users can retrieve crash logs from their computers when they encounter an application shutdown, and send the files to the support team for investigation.

.. _mac-retrieving-crash-logs-end:

#.  On the user's computer, select **Go** from the top navigation menu, and then select **Library** from the drop-down menu.
#.  On the **Library** window, select **Logs** > **DiagnosticReports**.
#.  In **DiagnosticReports**, locate the crash log file that begins with the application name.
#.  Copy the crash log and send it to the support team.

    .. note::

      The crash log file is indicated as **Analytics Report** in the **Kind** column.

    .. raw:: html

      <iframe width="560" height="315" src="https://www.youtube.com/embed/Tu-ZCTVgY1M" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>

---------------------------
Minimum System Requirements
---------------------------

.. include:: android-devices-troubleshoot.rst
  :start-after: .. _android-system-requirements-start:
  :end-before: .. _android-system-requirements-end:

^^^^^^^^^^^
OS Versions
^^^^^^^^^^^

The devices should be running macOS 13 (Ventura) and onwards.