Generate Endpoint Security for Mac Support Tool Log
In very rare situations Endpoint Security for Mac may encounter issues that are impeding the product to work as designed. In such case, you must submit a request to the Bitdefender Technical Support Team for them to investigate and see why the product’s functions are not performing as they should.
When sumbitting a request, you need to provide the following:
- A detailed description of the issue you are encountering.
- A screenshot (if applicable) of the exact error message that appears.
- A Support Tool log that contains system information.
The Support Tool consists of two parts, GatherBD and BDProfiler. The tool collects logs for the Bitdefender daemons along with product and system logs (such as the IP address of the machine, the macOS version and the allocated resources).
If the product is not installed on the affected machine or if you cannot run the GatherBD commands, you can always use the BDProfiler method.
BDProfiler requires Python 2 to run.
In addition, you can use remote troubleshooting to collect logs.
- Collect logs with GatherBD
- How to generate a BDProfiler log
- Remote troubleshooting
- How to submit a request
To collect logs from the affected endpoint, follow these steps:
- Open a Terminal window.
- Type the following commands to enable logging:
$ cd /Library/Bitdefender/AVP/enterprise.bundle/
$ sudo ./GatherBD start
- Reproduce the issue.
- Stop logging:
$ sudo ./GatherBD stop
- Gather logs into an archive:
$ sudo ./GatherBD archive all
You can find the archive file named BitdefenderSupportTool_Output.zip in: /var/tmp/ProductSupport.zip
- Attach the archive to your support ticket.
If prompted to install Xcode command line developer tools, click Install. When installation is complete, perform once again the above steps.
To gather Mac system information using the BDProfiler support tool:
- Download the ZIP archive containing the Support Tool.
- Extract the BDProfiler.tool file from the archive.
- Open a Terminal window.
- Navigate to the location of the BDProfiler.tool file.
- Add execute permissions to the file:
sudo chmod +x BDProfiler.tool
- Run the tool.
- Press Y and enter the password when asked to provide the administrator password.
- Wait for a couple of minutes until the tool finishes generating the log. You will find the resulted archive file (Bitdefenderprofile_output.zip) in the same folder with the tool.
With this method, you can gather logs remotely using GravityZone Control Center from one or more of the affected computers. You can also select from multiple storage options to save the logs.
- Log in to GravityZone Control Center.
- Go to the Network page and click the Computers and Groups section.
- Click on the affected computer and go to the Troubleshooting tab.
- Click the Gather logs button from the upper left side. A configuration window will appear.
- In the Logs Storage section, choose a storage location:
- Target machine: the logs archive is saved to the provided local path.
- Network share: the logs archive is saved to the provided path from the shared location.
- Bitdefender Cloud: the logs archive is saved to a Bitdefender Cloud storage location where the Enterprise Support team can access the files. This option is available only for Cloud solutions.
- Fill in with the necessary information (local path, credentials for the network share, path to the shared location, case ID) depending on the selected location.
- Click the Gather logs button.
If you choose other storage option, to submit the logs to Bitdefender Enterprise Support, access the selected storage location and find the archive file named ST_[computername]_[currentdate]. Attach the archive to your support ticket for further troubleshooting.
To collect advanced logs using GravityZone Control Center consider Debug session, available in the Troubleshooting section. You should use this method at the recommendation of Bitdefender Enterprise Support. For more information, please refer to Administrator's Guide.
Open a ticket to the Bitdefender Support Team, enter the requested information, attach the log file and the screenshot, and click SUBMIT. If you already have an open ticket with the issue, reply to the confirmation email received from Bitdefender and attach the files to it.