If an Action returns a failure, first check the log for errors.
- This can be confirmed in the Robot Cloud Database (previously named Site Access).
- In a browser, go to https://m.robotcloud.net (you will be prompted for your credentials).
- Search for the affected Mac, then it’s History tab, then Policy Logs and search for the policy name.
- Look in the status column for Failed result and click the Show button to see the log.
The most common failure point is with downloading the payload (zip, pkg or dmg).
- Toward the beginning of the log, you should see a line about downloading the payload.
- The following line or verification check should confirm if the payload could not be downloaded.
- Next, confirm where the payload was downloaded from.
Payloads are downloaded from three possible locations (Local Distribution Point, Cloud Distribution Point or directly from the software developer.
- If from a Local DP, the log output will show: Mounting, <Client Name> to /Volumes/RobotCloud...
- If from a Cloud DP, the log output will show: Downloading https://<server>.cloudfront.net/<payloadname>
- If from a software developer, the log output will show: Downloading <payload> and Verifying <payload>
Local Distribution Point troubleshooting.
- Two potential fail points here: payload is missing or LDP connection error.
- If the payload is missing, run a Robot Cloud Sync on the Mac Server to update it’s repository (See KB link 4e).
- If a connection failure, confirm by running Distribution Point Status (see section 7).
- If a Status check fails, reinstall Robot Cloud Sync.
Cloud Distribution Point troubleshooting.
- The Cloud Distribution Point is an Amazon hosted HTTP share and is maintained by Robot Cloud Admins.
- If a connection failure, confirm by running Distribution Point Status (see below).
- If a Status check fails, confirm that the network allows access to an Amazon HTTP share.
Software Developer direct download troubleshooting.
- This type of Action will route the payload from the software developer’s website.
- The log output will show: Verification failed, incomplete or missing download.
- Confirm that the network allows access to the software developer’s website.
Check Distribution Point Status.
- This tool can be found in the Self Service application on the affected Mac or triggered via Command Line.
- Self Service > Robot Cloud Actions > Distribution Point Status > TEST > (Local or Cloud) > Test.
- To run via Command Line use:
sudo jamf policy -event local(or)
sudo jamf policy -event cloud
Successful download, but failure to install the package.
- In some cases the payload is present, but the package fails to install.
- Check the log output to confirm why the package could not be installed.
- It’s possible the application is currently open and needs to be quit before it will install.
- The package could have been corrupted in transfer and need to be re-downloaded.
- You can also check the console application or /var/log/install.log on the affected Mac for additional detail.
If the outlined troubleshooting doesn’t resolve the issues, a restart of the affected Mac could be the missing piece of the puzzle.
In the event a restart of the affected Mac and outlined troubleshooting doesn’t resolve the issue, please contact us for additional assistance.