MIS774 — macOS Setup (Apple Silicon)

Everything you need for MIS774 Enterprise Data Management, in one command. No vendor sites, no account sign-ups, no version guessing.

Apple Silicon only (M1/M2/M3/M4). Check with uname -m — it must say arm64. If it says x86_64 you have an Intel Mac; ask your tutor.

Install

Open Terminal and paste this:

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/thuc-gh/mis774-setup/main/install.sh)"

It installs Java 21 and Pentaho automatically, then opens the MySQL installers for you to click through (those need your Mac password, so they can't be automated).

Then open a new Terminal window and start Pentaho:

cd ~/Pentaho/data-integration && ./spoon.sh

The Spoon window can take up to a minute to appear.

What you get

Component	Version
Pentaho Data Integration	11.0.0.1-259 (macOS 26 fix + MySQL driver already included)
MySQL Community Server	9.7.1 (arm64)
MySQL Workbench	8.0.47 (arm64)
MySQL Connector/J	8.0.33
Java (Temurin JDK)	21 (LTS)

Two things that will waste your afternoon if you skip them

Java must be 21. Not 25, not 26. On newer Java, Pentaho reads dates in US month/day order without any error — 1/07/26 becomes 7 January instead of 1 July. The installer handles this; just don't override it later.

Open a new Terminal window after installing. The Java setting only applies to windows opened afterwards. If java -version says 26, that's all this is.

Never run the installer with sudo. It doesn't need it, and sudo creates files your normal account can't edit afterwards. The installer refuses to run that way.

If something goes wrong

permission denied: .zshrc

The installer needs to add one line to ~/.zshrc, and that file isn't writable by you. This almost always means something was run with sudo earlier, so the file now belongs to root instead of you.

Run this one line (it will ask for your Mac password), then run the installer again:

sudo chown $(whoami) ~/.zshrc && chmod u+w ~/.zshrc

If it says the file is locked rather than owned by someone else, run these instead:

chflags nouchg ~/.zshrc
chmod u+w ~/.zshrc

If you used sudo on an earlier setup attempt, other files may also be stuck the same way. If you hit "permission denied" again on a different file, tell your tutor what you ran with sudo — don't keep adding sudo to make errors go away, as that makes it worse.

Other problems

Pentaho window is blank / grey. You're on an unpatched Pentaho. Use the download from here rather than one from the Pentaho website: this build already contains the fix (Pentaho ships a 2022 graphics library that cannot draw on macOS 26).

java -version says 26. Open a new Terminal window. If it still says 26, run source ~/.zshrc.

"Cannot be opened because the developer cannot be verified". System Settings → Privacy & Security → scroll down → Open Anyway.

Forgot your MySQL root password. There is no recovery. Uninstall MySQL completely, then reinstall it from the installer.

"not enough free disk space". The installer needs about 4GB free. Empty your Trash and try again.

Manual downloads

If you'd rather not run the script, all files are on the Releases page.

Only need to fix Java?

If Pentaho is already installed and you just need Java 21 set up correctly:

zsh -c "$(curl -fsSL https://raw.githubusercontent.com/thuc-gh/mis774-setup/main/java21.sh)"

It installs Java 21, sets JAVA_HOME, warns you if an old Java setting is fighting it, and checks the result.

Uninstalling MySQL

If your MySQL install is broken, you forgot the root password, or you want a clean start before reinstalling:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/thuc-gh/mis774-setup/main/uninstall-mysql.sh)"

It finds every MySQL installation on your Mac (the official installer used by this unit, or Homebrew), shows you exactly what it will remove, and only deletes after you type yes. It will ask for your Mac password along the way — that's normal. The same rule as installing applies: don't run it with sudo (it refuses anyway).

This permanently deletes all MySQL databases on your Mac. If you have coursework in MySQL you want to keep, export it first — in MySQL Workbench: Server → Data Export — or back up everything with mysqldump -u root -p --all-databases > backup.sql.

To see what it would remove without deleting anything:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/thuc-gh/mis774-setup/main/uninstall-mysql.sh)" -- --dry-run

What's in this repo

File	Purpose
install.sh	Full installer (Java, Pentaho, MySQL)
java21.sh	Java 21 only
uninstall-mysql.sh	Complete MySQL removal (for a clean reinstall)
LICENSES.md	Licences and source availability for everything distributed here

---

Unit mirror for Deakin MIS774. Files are hosted here so the versions stay pinned and the links keep working — vendor download URLs move when versions are superseded. See LICENSES.md for licensing and source.