OCU (Operator Control unit) Setup

This page includes necessary information for setting OCU units under various OS distributions.

Ubuntu

1. Go to Ubuntu's website and follow the instructions for installation. If you are not comfortable with partitioning the hard drive of your Windows machine, they have a fairly easy to use Ubuntu installer.

2. Install Ubuntu packages that are necessary.

sudo apt-get install emacs22-gtk manpages-dev mercurial cvs \
    freeglut3 freeglut3-dev bison flex libxi-dev libxmu-dev \
    zlib1g-dev python-dev python-scipy ipython python-numpy \
    python-pygame python-wxgtk2.8 python-opengl libftdi-dev

3. Make a user account for yourself if you haven't done that, yet. When booted into the desktop interface click on "System" -> "Administration" -> "Users and Groups" via the top menu. On the window that appears, click "Unlock", then "Add User". Add your username, set your account type to "Administrator" (thus giving yourself sudo privileges), and type your password. Next time you login, use your own account.

4. If you intend to use SSH to access this computer remotely (suggested), you must install the SSH server.

sudo apt-get install openssh-server

Mac OS X

1. Make certain X11 is installed. You can run open X11 to check if you have it. If not, it can be found on your OS installation CDs.

2. Install Xcode, as provided on the OS CDs provided with the computer (or available via Apple Developer Tools).

3. Install MacPorts. Installation instructions are available at their website. (For all versions, navigate to their file repository. Download the latest version of MacPorts that matches your OS X install version.)

4. Add MacPorts executables to your path. Add the following lines to your .bash_profile. if it doesn't already exist, create this under your user's home directory. (Note, MacPorts seems to do this for you nowadays).

# MacPorts
export PATH=/opt/local/bin:/opt/local/sbin:$PATH
export MANPATH=/opt/local/share/man:$MANPATH
export PATH=/opt/local/libexec/gnubin:/opt/local/bin:/opt/local/sbin:$PATH
# Next two lines set compiler and linker defaults to include MacPorts
export LIBRARY_PATH=/opt/local/lib
export CPATH=/opt/local/include

After you are done with the changes, run:

source ~/.bash_profile

5. Replace the default command line programs with GNU versions.
sudo port install coreutils +with_default_names

6. (Optional) Give yourself fancy colored ls and prompt settings. Add the following lines to bash_profile.

export PS1="\[\033[0;32m\]\u@\h \[\033[01;34m\]\W \$ \[\033[00m\]"
if [ "$TERM" != "dumb" ]; then
    export LS_OPTIONS='--color=auto'
fi
alias ls="ls $LS_OPTIONS"

Suggested Software Packages

Within the MacPorts system, a variety of common programs can be installed. Here is a suggested "master list" of a variety of useful packages. Note that this command may take a very long time to complete.

sudo port install py26-game py26-scipy py26-ipython py26-matplotlib py26-cairo py26-pil \
    subversion mercurial texlive wget py26-wxpython
  • Note that, for new version of py26-game, you need to register for Apple Product Development to get their latest Java Developer tools. You will get an error on this that has the URL path that you can use for registering and installation.
  • If py26-wxpython fails, try it again with py26-wxpython +gtk

If you're using Python 2.6 (suggested), you'll need to run two commands to select it as default, rather than the already-installed Apple distribution of Python 2.5.

sudo port install python_select  
sudo python_select python26

Windows

Cygwin

Windows with Cygwin is a suitable method of running Dynamism natively on Windows. In this example, I pair Cygwin 1.7 with Windows 7, but this should theoretically work with prior versions of either.

Get the setup package, and make certain you select installation of the following packages:

  • gcc4
  • gdb
  • make
  • mercurial
  • nano
  • openssh
  • python
  • python-numpy

Other, potentially useful packages may be selected:

  • autoconf
  • automake
  • zip
  • unzip

PyGame with Cygwin

I formerly hacked something for XP but even that took a lot of time and effort. You may want to check if you can find a recent pygame version available on Cygwin libraries. Sticking on Ubuntu is the best option.