Download and run the installer:
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:
Enter in the Organisation ID
The Organisation ID Wizard below should startup automatically, 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 Organisation ID Wizard helper:
Add the correct permissions for RoboShadow
Assuming the Organisation ID Wizard popped up automatically the helper will ask you to enter an Organisation ID to link it to an organisation within the portal. Your browser will automatically copy the Organisation ID when you downloaded the file. If it doesn't, you can get this from the RoboShadow Portal in the Organisation Section (link below):
https://portal.roboshadow.com/account/organisations
After this has been done, It should then ask to be granted access to the drives so that RoboShadow can get the data it needs:
You will need to then need to grant the RoboClientMac application Full Disk Access as below:
Please note you will ned to go through the First Run Helper Wizard all the way to the end and click Done
Once the setup has been completed, the RoboShadow agent can be seen under the list of active services when the client is run as below:
Checking your RoboShadow Mac Agent Runs (or how to resync data)
Please note that the RoboShadow process will only be seen in Activity Monitor for a short while periodically in order to sync the Data. Select the app from applications in the Finder and then quickly go to the Activity monitor to check it runs (be quick because if you blink you could miss it):
Go to the Finder and select Applications > RoboClientMac
The very quickly check the Activity Monitor (how to do this is also below) check to ensure the client fires, you may need to go back to the Finder and launch the application again if you dont think you were quick enough.
Please note that this is how you can force RoboShadow to resync.
To get to the activity monitor click the finder icon and go Applications >Utilities >Activity Monitor:
Check you see the new Mac device appears in the RoboShadow portal
It should 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. The example below is the hardware section:
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
Put client in Debug mode
If you need to put the application in Debug mode in the setup.cfg file found in /Users/Shared/com.roboshadow/setup.cfg
Change the Debug mode from false to trues
Uninstall
There is an uninstall file that must be run to correctly remove the agent. It can be found:
/applications/utilities/roboshadow_uninstaller
Logs and Error Checking (we may need you to send us these):
The log file (rcl.log) will be generated when the agent is run for the first time, and updates every subsequent run.
You can find this usually by going to Finder > Utilities > Console as below:
We may ask you to Dump File out to the Desktop as a send Log:
Go to /Users/Shared/com.roboshadow/setup.cfg and set the property to true, The once this has been completed please try and launch the RoboClientMac confirm it launches in the Activity Monitor and then send us the file on the desktop which will look something like “Dump-<random digits>.json”
We may also ask you to Go to the Finder > Terminal > and run:
sudo launchctl list | grep com.roboshadow
(you will be asked for your password to run this command)
We will ask you to send back the response which may look something like:
We may also ask you to check the main Launched.log
double click the launchd.log to open it in a separate window
Type com.roboshadow to filter Roboshadow results and send us a print screen
How to access files on most Macs
Click the finder Icon:
To go to folder Structure click finder > select Go from menu at the top (you may need full screen the Finder page to see the Go menu:
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