The Internet Suspend/Resume® (ISR) project
   OpenISR® software: Source code and binary packages

License and Disclaimer

All software below is experimental in nature, and is provided "as is" with no warranties of any kind. See the appropriate license text for full text of disclaimers and caveats: GNU General Public License v2, GNU Lesser General Public License v2.1, or Eclipse Public License v1.0. (Different components of the system are licensed under different terms, as specified in the source code headings.)

System Requirements

 To run the client:
  • Linux userspace: libfuse and the FUSE utilities, curl, zlib, xz-utils liblzma, e2fsprogs libuuid, libarchive, GTK+, PyGTK, PyYAML, gtk-vnc Python bindings, Perl, Python, ssh, rsync
  • VirtualBox, KVM, VMware Workstation, or VMware Player
  • An accessible OpenISR server and at least 10GB free disk space (for parcel cache)
To run the server:
  • Linux userspace: An HTTP server, an ssh server, rsync, Perl, zlib, xz-utils liblzma, e2fsprogs' uuidgen, libarchive
  • Lots of free disk space (depending on the number and size of parcels to be stored)

Recent Changes

 Changes in version 0.10.1 include:
  • Support VirtualBox 4.0.4 and above
  • Support KVM on RHEL 6
  • Allow showing image cache state in dirtometer
  • Various other improvements
Changes in version 0.10.0 include:
  • Export parcel disk via FUSE rather than custom kernel modules
  • Support qemu-kvm 0.13
  • Drop support for qemu-kvm 0.10 and VirtualBox older than 3.0.2
  • Perform chunk demand-fetching asynchronously
  • Various other improvements
Changes in version 0.9.10 include:
  • Support kernels 2.6.34 and 2.6.35
  • Support VirtualBox 3.2
  • Add "isr dirtometer" command
  • Various other improvements
Changes in version 0.9.9 include:
  • Hoard cache performance improvements
  • Support VirtualBox 3.1
  • Support suspend/resume across different CPU types on VirtualBox 3.1
  • Various other improvements
For details and older changes, see the CHANGES file.

GPG Key

 OpenISR source releases, binary packages, and release tags in Git are signed with GPG. The public key for isr@cs.cmu.edu is: 
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.12 (GNU/Linux)

mQGiBEX5u28RBADyIe4k/TTVn2R+syOCcA6KtN0hdxGmN0VABvF9ZHmqIPcGoZx3
sxgDrch+PLm5b782smtbnpuzz8NgH4lAGtrYJnT+c1ak2hURXI6+GXlqG8mSMTyo
WzqgbRp0XVI56Fccx7hqI9qvC2YOixM6dB9WtI1iiyd3hlTNcxYgT4lZqwCgt9Ty
BDAjDIDIw/hij/WO5iaXM40D/j7tZB5DuR2bZh5EZF9Rvwqc9oRxn0+Q90MCYtNJ
WDYY5MbhRl9+TyqoEcSBxghAVrQ501p/d5e/5+QmxqJNbYQsEimsk8AtqGPV5xAp
+joqY+0TuByFTQ05DxN/eQLM9Rj0yE+7GaI6aVBck8uXF+H1BDtrnYCcxYT90Le6
Q2YNA/sGBFuBg/QX2gT4ovzX6r6fY++nGcMbeB3+S/CKeTekx3aoC5RjSXVUbpf/
5maJWSScQX5U2K8Gk7zsPTg8Yy7LjikuRbNfCqYxK/9Xm0CworEQr0u0aZWuCSvI
iqFh2yQQ3EtDoN4hF64s/flNFpUoj2PpH2fm1IFfUISdRiIY6rQoSW50ZXJuZXQg
U3VzcGVuZC9SZXN1bWUgPGlzckBjcy5jbXUuZWR1PohmBBMRAgAmAhsDBgsJCAcD
AgQVAggDBBYCAwECHgECF4AFAk9ruuMFCRLYAPAACgkQdL7DVyG5dryLgACdHlNu
FzHaLvnhGHg6y+vvZ5JrwegAnA2oaK2mzs+B7FFcTjfOyXdLGII7
=gWAP
-----END PGP PUBLIC KEY BLOCK-----
and is available for download here.

Source Releases

 The latest source release is openisr-0.10.1.tar.gz (SHA-1 checksum, GPG signature). For client installation instructions, see the README. For server installation instructions, see README.server. Older releases are available here.

Binary Packages

 Debian/Ubuntu
OpenISR client packages are available via APT for the following distributions:
  • Debian 6.0 (Squeeze)
  • Ubuntu 8.04 (Hardy)
  • Ubuntu 10.04 (Lucid)
To install, first add the OpenISR package repository to APT:
  1. Add the appropriate line to /etc/apt/sources.list, depending on your distribution version: 
    deb http://isr.cmu.edu/debian squeeze/
or...
deb http://isr.cmu.edu/ubuntu hardy/
or...
deb http://isr.cmu.edu/ubuntu lucid/
    If you would like to be able to get the OpenISR source code with apt-get source, you can also add a deb-src line: 
    deb-src http://isr.cmu.edu/debian squeeze/
or...
deb-src http://isr.cmu.edu/ubuntu hardy/
or...
deb-src http://isr.cmu.edu/ubuntu lucid/
  2. Import the OpenISR public key into your APT keyring: 
    curl http://isr.cmu.edu/software/isr-signing-key | sudo apt-key add -
Then, to install the client:
  1. Install the openisr-client package: 
    sudo apt-get install openisr-client
To install the server: (This is only necessary if you do not have access to an existing OpenISR server!)
  1. Install the openisr-server package: 
    sudo apt-get install openisr-server
  2. Configure your web server to map http://your-server/isr to the /var/lib/openisr/server directory. With Apache, this can be done by adding this line to your Apache configuration file: 
    Alias /isr /var/lib/openisr/server
  3. Ensure that sshd is configured to start at boot.
  4. Use the isr_admin tool to create user accounts and parcels.
Red Hat Enterprise Linux
OpenISR packages are available via Yum for Red Hat Enterprise Linux 5 and 6. To install, first add the OpenISR repository to Yum by installing the repository RPM.

Then, to install the client:

  1. Use Yum to install the openisr-client package.
To install the server: (This is only necessary if you do not have access to an existing OpenISR server!)
  1. Use Yum to install the openisr-server package.
  2. Configure Apache to map http://your-server/isr to the /var/lib/openisr/server directory by adding this line to your Apache configuration file: 
    Alias /isr /var/lib/openisr/server
  3. Ensure that httpd and sshd are configured to start at boot.
  4. Use the isr_admin tool to create user accounts and parcels.

Development Repository

 The OpenISR source code repository is available on GitHub.