Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

First, download the installer onto a Mac device from the following link: https://cdn.roboshadow.com/GetAgent/mac/2023/08/09/RoboClientMac.zip

Next, Open finder and go to Downloads and run “RoboClient_Mac.pkg”

You should then get the installer wizard to install the Mac version of the Agent appear.

Follow the steps as shown in the the wizard.

image-20240819-150303.png

Once completed, The helper Wizard should startup, If this does not happen open Finder got go to applications, You should then find “RoboClientMac” in the application list and launch the app from there, this will start the helper:

image-20240819-155222.png

The helper will then ask you to enter an Organisation ID to link it to an organisation within the portal.

image-20240819-151317.png

After this has been done, It should then ask to be granted access to the drives.

image-20240819-151825.png

You will need to then need to grant the RoboClientMac application Full Disk Access as below:

image-20240925-092351.png

Once the setup has been completed, the RoboShadow agent can be seen under the list of active services:

image-20240819-151843.png

And will appear in the portal after a few minutes. Mac Devices can be found under the Mac Tabs within the device engagement pages within the portal.

image-20240819-154624.png

Optional: Updating the Organisation ID

If you need to update the Organisation ID at a later date, this information is stored in the setup.cfg file found in /Users/Shared/com.roboshadow/setup.cfg

Open the file with a text editor and update the Organisation ID

Uninstall

There is an uninstall file that must be run to correctly remove the agent. It can be found:

/applications/utilities/roboshadow_uninstaller

image-20240819-155110.png

Logs

The log file (rcl.log) will be generated when the agent is run for the first time, and updates every subsequent run.

It should be located in: ~/Library/Logs/com.roboshadow.roboclientmac/rcl.log

But depending on how the agent was installed may be: Applications > Utilities > Console > Log reports > rcl.log instead.

in ~/Library/Logs/com.roboshadow.roboclientmac sits the logfile rcl.log, it contains the logdata from each run

If debugmode in /Users/Shared/com.roboshadow/setup.cfg is set to true, it should create a file on the desktop as 'Dump-<random digits>.json’ when it has run.

That is what it sends to the portal.

You cannot launch it manually from the Finder as it requires the privilegies required from being launched by launchd.

 
But, you can launch it using launchctl


sudo launchctl kickstart -k system/com.roboshadow.roboclientmac

Old way: Logging needs to be enabled in the com.roboshadow folder

Logs will then appear at the below location: ~/Library/Logs/com.roboshadow.roboclientmac/

How to access files on most Macs

Click the finder Icon:

image-20240925-071809.png

To go to folder Structure click finder > select go from menu >

image-20240925-071958.png

The select computer (this is also where you can find out the Mac’s Computer Name.

Then select the Disk Icon (It is usually untitled unless the user has named it)

You will be then given the 4 main directories:

  • Applications

  • Library

  • System

  • Users

Here you can browser whatever folder you like

Uninstall RoboShadow

/applications/utilities/roboshadow_uninstaller

Logs

~/Library/Logs/com.roboshadow.roboclientmac/rcl.log

..

  • No labels