search

BrightSpots / rcv

Ranked Choice Voting Universal Tabulator
Mozilla Public License 2.0
70 stars 19 forks source link

Update documentation to include Mac OS verification step #858

Open paulgronke opened 1 month ago

paulgronke commented 1 month ago

Hello, not sure if this is a Mac OS issue (currently running Sonoma), but when I attempt to open the RCV script, i receive a security warning for "java" (see image).

Typically, a user can override the security protections for a trusted executable, but in this case, I think the java executable is being called from w/in the "rcv" script, so I have no option to override the settings.

Screenshot 2024-06-27 at 3 34 48 PM

We should include this explicitly in the (forthcoming) user guide documentation. See Paul's comment below for information on exactly how he got to this issue.

paulgronke commented 1 month ago

Resolved. MacOS users will need to execute the "java" script first in order to establish this as a trusted executable. Follow this by the "rcv" script and the GUI appears.

yezr commented 1 month ago

thanks for the heads up Paul! I'm make sure to include this in our documentation. We're working on a friendlier and more accessible user guide. Something like this would be great to include in there.

yezr commented 1 month ago

Did you build from source with gradle? How exactly did you get to this error?

paulgronke commented 1 month ago

Platform: MacBook Pro running Sonoma 14.5

Did not build from source. Here is how I obtained the error:

1) Downloaded “universal_rcv_tabulator_v1.2.0_mac.zip” from https://github.com/BrightSpots/rcv/releases (downloaded this version because the county I am working with has to use the VVSG certified version).

2) Unzipped the archive

3) First attempt to run: right click on “rcv” which is identified by the MacOS as a unix executable. This generates an onscreen dialog box warning the user that this executable was downloaded from the internet and do you trust it. Clicked “run”. This opens a terminal window and a security error.

4) Second attempt: right click on “java” in the same folder, under the assumption that the RCV script calls the java executable, and the MacOS requires the same security authorization for the java script. Once the java script has been authorized=, go back to executing the “rcv” script and the java window opens.

Paul Gronke Professor, Reed College Director, Elections and Voting Information Center http://evic.reed.edu

General Inquiries: Michelle Shafer, @.***

On Jun 28, 2024, at 5:32 AM, Mathew Ruberg @.***> wrote:

Did you build from source with gradle? How exactly did you get to this error?

— Reply to this email directly, view it on GitHub https://github.com/BrightSpots/rcv/issues/858#issuecomment-2196806117, or unsubscribe https://github.com/notifications/unsubscribe-auth/AGBOF6FSIDM6SQ3XYHNXKJLZJVJXJAVCNFSM6AAAAABKAY64X6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCOJWHAYDMMJRG4. You are receiving this because you modified the open/close state.