SystemStudio Sources

SystemStudio is licensed under the GPL, version 2+.

Viewing SystemStudio Source Code

SystemStudio source code is available for browsing at https://www.renditionsoftware.com/hg/public/systemstudio/.

Running SystemStudio from Source Code

You can also check out SystemStudio and run it directly from source code on a system installed with Red Hat Enterprise (RHEL) 5 or CentOS 5 using the following the steps:

  1. Install SystemStudio dependencies.

    2. Working with SystemStudio directly from source code requires some additional software packages to be installed on your system. You can install these packages as described below. Note that some may already be installed. Also note that yum must be run as the root user.

    Enterprise Linux 5

    For Red Hat Enterprise Linux and CentOS 5, Mercurial is available from the EPEL package repository. Note that the steps below must be completed as root user.

    Enable the EPEL Repository

    # rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386\
/epel-release-5-3.noarch.rpm

    Install Packages

    # yum install createrepo dosfstools gnupg mercurial mkisofs pykickstart \
python-devel python-hashlib python-lxml python-paramiko python-setuptools \
rpm-build syslinux
    Enterprise Linux 6

    For Red Hat Enterprise Linux and CentOS 6, all required packages are available from the base operating system distribution. To install the packages, type the following (as root user) at the command prompt: 

    # yum install createrepo dosfstools genisoimage mercurial pykickstart \
python-crypto python-devel python-lxml python-paramiko python-setuptools \
rpm-build syslinux
  2. Check out the sources to a folder of your choosing, referred to as $WORKSPACE below. SystemStudio source code is managed using Mercurial.
    3. $ cd $WORKSPACE
$ hg clone https://www.renditionsoftware.com/hg/public/systemstudio
  3. Add the systemstudio library locations to your python path.

    4. In your '~/.bashrc' file, add the following line, replacing '$WORKSPACE' with your chosen location.

    export PYTHONPATH=$WORKSPACE/systemstudio:$PYTHONPATH

    and then at the command line run

    $ source ~/.bashrc
  4. Create the SystemStudio configuration file.

    5. As root user, create a file named 'systemstudio.conf' in the '/etc/systemstudio/' folder

    # mkdir /etc/systemstudio
# touch /etc/systemstudio/systemstudio.conf

    and add the following lines, again replacing $WORKSPACE:

    <systemstudio>
  <share-path>$WORKSPACE/systemstudio/share/systemstudio</share-path>
</systemstudio>
  5. Run SystemStudio

    6. To run SystemStudio, type the following at the command line, replacing $WORKSPACE with the correct location. Note that SystemStudio must be run as the root user because it mounts and modifies installation images during the system build process . See the SystemStudio Quick Start for information on creating a simple system definition.

    # $WORKSPACE/bin/systemstudio path-to-system-definition