6.1 Mac Agent Manual Install Guide

Owned by Cameron Barker
Last updated: Oct 16, 2024
3 min read

Must be on on macOS 10.14.6 or higher

 

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:

image-20240819-150303.png

 

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:

image-20240819-155222.png

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