CSC4102-2024-Installation-Guide-Mac-OSX

SSH

To check if ssh is installed on your Mac:

$ which ssh
/usr/bin/ssh

If not already installed, we recommend using OpenSHH from https://www.openbsd.org/openssh/

Installation on a mac is simple if you already have a package manager,eg:

• Homebrew brew install openssh (see https://formulae.brew.sh/formula/openssh)
• Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext. sudo port install openssh

A zipped package can also be downloaded from the macupdate site - https://download.macupdate.com/app/mac/5675/openssh/download

GIT

There are several ways to install Git on macOS. The easiest is probably to install the Xcode Command Line Tools. You can do this simply by trying to rungitfrom the Terminal the very first time.

$ git --version

You should see something like:

git version 2.39.5 (Apple Git-154)

If you don’t have it installed already, it will prompt you to install it.

You can also install it using a package manager,eg:

• Homebrew brew install git (see [https://formulae.brew.sh/formula/git)
• Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext. sudo port install git

Markdown Editor/Viewer - Mark Text

The recommended viewer on macOS X is "Mark Text (marktext)". The source code is availabe on gitub - https://github.com/marktext/marktext and the build works for Linux, macOS and Windows.

Installation on a mac is simple if you already have a package manager,eg:

• Homebrew brew install --cask mark-text (see https://formulae.brew.sh/cask/mark-text)
• Macports - is a more complicated package manager to install (see https://guide.macports.org ) but can also be used to install marktext. sudo port install marktext

A zipped package can also be downloaded from the macupdate site - https://www.macupdate.com/app/mac/63668/mark-text

When using the editor, you can toggle the view "source code mode" to switch between editing the source and viewing the result.

PlantUML

As well as installing PlantUML as an Eclipse plug-in, you can install it as a standalone application.

Installation with a package manager is simple:

• Homebrew brew install plantuml
• MacPorts - sudo port install plantuml

Note: It depends on Java (the minimum version needed is Java 8)and graphviz already being installed. (See https://medium.com/@miniChang8/install-plantuml-on-mac-93e445842445)

A compiled jar can also be downloaded from https://plantuml.com/download?utm_content=cmp-true

Guidelines for running the application can be found at - https://plantuml.com/starting

You can either :

• run on the commmand line - java -jar plantuml.jar UML-Diagram.txt
• run the GUI - java -jar plantuml.jar -gui where, plantuml.jar is the name of the jar file you downloaded previously.