Process for manually installing Byzantium.

This process assumes:

• You've booted a clean copy of Porteus Linux v1.0 or later.
• You've checked the Porteus .xzm modules we built for Byzantium out of SVN, installed, and enabled them.
• You've checked the source tree for Byzantium out of the Git repository.

The process of installing Byzantium has not been automated yet. These notes should be used in the development of the official installer, at least until we get the official byzantium.xzm module built. I get the feeling that it's going to be pretty big because we're going to have to package all of the dependencies along with it for efficiency's sake (at least, that's what Ben the Pyrate says because he's messed around with union mounts more than I).

Gotchas:

• On first boot, syslinux might complain that it can't find video mode number 317. Entering the hex value "F00" (text mode, 80x25) will get around this.
• If the USB device is formatted with a non-Linux file system, you will see the error "A Windows Filesystem (FAT, NTFS) or other non-posix compatible filesystem has been detected on /porteus/." If you intend on creating a save.dat file, you can press 'enter' and ignore it. Or, you can format the key with a Linux file system (/EXT[1-4]/, XFS) prior to installing Porteus.
• On boot, Porteus Linux will mount all of the file systems it can see on the host machine. Use caution when deleting or copying files!

These commands can be run as guest (which is logged in by default):

• The wicd applet on the toolbar works well for setting up wireless. It's also polite enough to get out of your way once it's done. Use it to get online.
• Open Firefox and download all of the modules from http://svn.virtadpt.net/byzantium. Put everything in /dev/sdb1/porteus/modules to save time and space
  • It will probably be /dev/sdb if you have only one drive in the host machine.
  • You will need to install the git package as well to check out the Byzantium source tree.

All of these commands must be run as root:

• mkdir -p /srv/controlpanel
• cp -rv Byzantium/control_panel/srv/controlpanel/* /srv/controlpanel
• mkdir /etc/controlpanel
• cp Byzantium/control_panel/etc/controlpanel/* /etc/controlpanel
• mkdir -p /var/db/controlpanel
• cp -rv Byzantium/control_panel/var/db/controlpanel/* /var/db/controlpanel
• cp Byzantium/scripts/traffic_stats.sh /usr/local/bin
• cp -rv Byzantium/control_panel/etc/rc.d/* /etc/rc.d

For the control panel to work, NO network interfaces should be configured at the outset. The Porteus configuration apps make this easy, but conflict with our needs.