Once
installed, start the program from the main menu at
/applications/system-tools/, or by typing "HerculesStudio" at the shell
prompt.

Mac OS X:

Mount the image and click on the program icon to start Hercules Studio.

Operation

After
installing Hercules Studio the easiest way to start it is by navigating
to Applications->System Tools->Hercules Studio menu entry and
selecting it from there.

There are two command line options that enable customizing it's behavior on startup:

-f <hercules-config-file>

- will startup hercules immediately with the given configuration

-r <hercules .rc file>

- will setup hercules to use the given "run-command" file

This way the entire startup of the guest operating system can be automated.

example:

HerculesStudio -f mvs38.conf -r autoipl.rc

Prerequisites

1. Qt environment

Hercules Studio is based on the Qt framework. You can skip this if you use KDE window manager (which is also based on Qt).

Under RedHat/Fedora you will need to install package qt-x11 using the command:

su -c "yum install qt-x11"

On Debian-based systems (like Ubuntu) issue the following command:

sudo aptitude install libqtcore4 libqtgui4

2. Hercules configuration

(Note: You can ignore this part if your Hercules version is 3.08 or above)

Hercules should be configured and built to support a gui (this was not the default on Linux before version 3.08):

./configure --enable-external-gui

Source repository:

There are 3 branches to the repository: Master, Qt4 and 1.4.0 (stable):

1. Master
The master development branch contains the latest fixes and can only be compiled with Qt5.
2. Qt 4
The Qt4 development branch is the parallel branch of the master, but it is used to build Hercules Studio against Qt4.
3. 1.4.0
This is the last release branch, as it was on December 2012, when the 1.4.0 release was done. This is also the branch which all distributions use to build Hercules Studio.