[OPENDJ-2120] Add Note for Mac OS X for Launching ControlPanel.app Created: 10/Jun/15  Updated: 08/Nov/19  Resolved: 03/Dec/15

Status: Done
Project: OpenDJ
Component/s: documentation
Affects Version/s: 2.6.2
Fix Version/s: 2.6.4

Type: Improvement Priority: Minor
Reporter: Chris Adriaensen [X] (Inactive) Assignee: Mark Craig
Resolution: Fixed Votes: 0
Labels: Verified

QA Assignee: Ondrej Fuchsik


When trying to launch the ControlPanel.app on Mac OS X it gives an error that gives the impression the app is corrupted; though this is related to the signing of the application and the security settings of the user. Please see discussion on following reported issue: https://bugster.forgerock.org/jira/browse/OPENDJ-1224. As such it would make sense to add a note in the documentation that's explaining this; suggest adding it at Section 2.1 'Control Panel' in the OpenDJ Administration Guide with the Mac OS X instructions (ControlPanel.app).

"Please make sure your security settings allow for unidentified applications to run on your machine (System Preferences > Security & Privacy > General > "Allow apps downloaded from: Anywhere")."

Comment by Robert Faller [ 10/Jun/15 ]

Another work-around is to drop to the command level (Terminal) and invoke ./control-panel

Comment by Chris Adriaensen [X] (Inactive) [ 10/Jun/15 ]

Another workaround is to open not the 'ControlPanel.app' itself but go in the contents and run 'JavaApplicationStub' under 'Contents > MacOS' using the command line. Hence 'open ControlPanel.app' is being blocked if your security settings are configured not to allow unidentified applications but './ControlPanel.app/Contents/MacOS/JavaApplicationStub' isn't.

Comment by Mark Craig [ 23/Nov/15 ]

Bob, if it's okay with you, I'm going to assign this one to myself. Let me know if you want it back.

Comment by Mark Craig [ 23/Nov/15 ]

This one appears to be fixed in 3.0.0. Initially I get the popup that the Mac doesn't recognise who the app is from, and so I have to confirm that I want to run it.

But it does seem to work with 3.0.0-SNAPSHOT.

Comment by Mark Craig [ 23/Nov/15 ]

As this no longer seems to be an issue for 3.0.0, I guess it could be mentioned in the release notes for a maintenance release.

Going to remove it from this sprint.

Comment by Mark Craig [ 03/Dec/15 ]

I've updated the source of the server release notes for the next release of 2.6.x.

The fix is not particularly satisfying. Since we don't actually redeliver the entire doc set at this point for 2.6, the information will not show up in the ideal location, unfortunately.

Generated at Fri Oct 23 08:48:32 UTC 2020 using Jira 7.13.12#713012-sha1:6e07c38070d5191bbf7353952ed38f111754533a.