===============================================================================
== General Documentation                                                     ==
===============================================================================

This document contains release specific notes for the accompanying JumpBox.
More general information and documentation can be found on the JumpBox 
Documentation Wiki at http://www.jumpbox.com/


== Description of the concept ==

JumpBox virtual appliances are the easiest path to running server based
applications. A JumpBox bundles the operating system with the application and 
all its dependencies into a single ready to run bundle. This allows you to focus 
on working with the application while not having to worry about getting it 
installed. It also means that the application can be deployed on any x86 
platform regardless of what platform the application is written for. All that is 
required is the JumpBox, some virtualization software like VMware, a
network that assigns dynamic IP addresses (most do), and a computer with enough 
RAM and disk space.


== System requirements ==

  * Windows, Mac or Linux with Virtualization software including:
    * VMware (http://www.vmware.com)
      * You can also download the free VMware player.
        (http://www.vmware.com/products/player/) 
    * Parallels (http://www.parallels.com)
    * Any Virtualization platform that can import OVFs or VMDK based virtual
      machines.
  * Up to 14GB Free disk space for growable disks.
  * Minimum 1GB RAM, 2GB recommended. 
  * A network that assigns dynamic IP address (most do)


== Accounts ==

When you first boot your JumpBox the console will display an IP address that you 
should open with a web browser. That will then guide you through the setup process 
to configure a user account. This account will grant you access to the JumpBox 
administration interface and it will also be the account you use to log into the 
application for the first time.

Immediately after JumpBox configuration you will be directed to the "Welcome
Page".  The welcome page contains the username you need to login to the
application bundled with the JumpBox.  Typically, the username will be 'admin'
but deviations from this are always noted on the welcome page. This welcome 
page should remain accessible at:
  http://IPADDRESS/jb/welcome.html

  
== Account Passwords ==

In general, there are three accounts on a JumpBox to start with:
 * Application Administrator
 * Linux System 'admin' User
 * JumpBox Admin Portal User
After initial configuration, all three users will have the password chosen
during configuration.  If, during the course of using the JumpBox, any of these
passwords are changed the other ones are NOT changed with it.  We do not keep
these passwords in sync after the initial configuration.  The only other
situation where these passwords are modified is during a JumpBox Restore.


== Backup Limitations ==

The JumpBox backup and restore utilities perform a FULL backup of the entire 
application state and any additional items you have specified as shown in the
"Backup Customization" section of this document.  By default, these backups 
run at 1:30 AM.  While the backup is running, the application will be 
inaccessible to ensure a consistent application state in the backup.

For users who have added large amounts of data to their JumpBoxes, our backup
tool may be inadequate.  The time it takes to backup could become disruptively
long or the JumpBox could have insufficient disk space to perform a backup
at all.  Users with these issues should consider utilizing their existing backup
infrastructure where available.  JumpBox Engineers can help identify the data 
that needs backing up and might be able to provide advice when installing 
third party backup agents.  Please ask on the JumpBox forums or via email if 
you have purchased support.

Details on the size restrictions and backup times vary considerably between
applications so please see the application specific part of this documentation
for details.

The S3 based backup mechanism currently has a 5GB limit on the backup file size.
If your backup exceed this you will receive an error.  We are working on a
resolution to this problem, though this falls into the realm where you are
encouraged to utilize a third party backup solution.


== Backup Customization ==

The JumpBox now provides a way for users to specify additional files or
directories on the JumpBox that need to be backed up by the JumpBox backup
mechanism.  This can be accomplished on a registered JumpBox by correctly
specifying the additional items in the /jumpbox/etc/user.yml.  SSH into the
JumpBox and refer to this file for usage details.  There is also a tool to
validate the user.yml file, this tool is:
  /jumpbox/bin/validate_user_yml
It will check the syntax of the file and indicate what will be backed up.

NOTE: The user.yml file must be correctly indented with two spaces for each
indent level.  So a correct example of a complete user.yml file would look 
like the following:

---
filebackup:
  # This is a comment
  /etc/php5/apache2/php5.ini: {}
  /usr/local:
    exclude_file: /admin/usr-local.exclude


== Application Specific Documentation ==

This JumpBox Platform README may be accompanied by additional information in
an application specific section below.  Also found below is JumpBox platform and
application specific Release Notes.  These may contain important information so
make sure to skim to those sections.

Additional application information is available on the JumpBox Wiki:
  http://wiki.jumpbox.com/


== Virtual Machine Resources ==

This JumpBox has default settings that may be too low for some user's needs.
You may consider raising the amount of RAM allocated to the JumpBox or adding
a virtual CPU if your platform supports it.


== Virtualization Platforms ==

For details on how to use your JumpBox on a specific virtualization platform
please visit the JumpBox Documentation Wiki: 
  http://wiki.jumpbox.com/doc/virtualization


== JumpBox Help and Information ==

If you have trouble with your JumpBox please check our wiki for tutorials, FAQs
and other important information:
    http://wiki.jumpbox.com/

If you are still experiencing difficulty post a question on our forums at:
    http://www.jumpbox.com/forums/

For details on purchasing support from JumpBox see:
    http://www.jumpbox.com/support/

To keep up to date with JumpBox see our blog at:
    http://www.jumpbox.com/blog/

== Notices ==

JumpBox is a registered trademark of JumpBox Inc.  All other marks and names
mentioned herein may be trademarks of their respective companies.


===============================================================================
== JumpBox Runtime Release 1.7                                               ==
===============================================================================

Release 1.7-58 Notable Changes
------------------------------
 - Many upstream updates from Ubuntu.
 - The kernel is now updated to the backported Natty kernel to resolve the ESX
   4.1 issues some users were still experiencing.

Release 1.6-41 Notable Changes
------------------------------
 - Upstream updates from Ubuntu.  This contains updates up to USN-1080-1.

Release 1.6-39 Notable Changes
------------------------------
 - Upstream updates from Ubuntu.  This is now Ubuntu Lucid 10.04.2 and contains
   updates up to USN-1065-1.

Release 1.6-31 Notable Changes
------------------------------
 - This is still an Ubuntu Lucid based release, however a number of things have
   changed, these are outlined below.
 - This release now uses the linux-generic-pae kernel for compatibility with
   vmware ESX 4.1, this unfortunately breaks compatibility with older
   virtualization platforms that lack PAE support.
 - Non VMware disks and configuration files have been removed.  This means that
   compatibility with other platforms can only be achieved by the use of those
   platforms VMDK import processes or through the use of OVFs.  Please check the
   JumpBox Blog and Website for more information on these changes.
 - [Update] All JumpBoxes now have three disks.  A two GB root disk, a two GB
   /usr disk and a 10GB /storage disk.

Release 1.5-23 Notable Changes
------------------------------
 - This has been a production release for at least several versions, our
   apologies for not indicating as much in these release notes.
 - All JumpBoxes now have a larger, 2GB, root disk by default.
 - The hostname is now displayed in the virtual console after setup.

Release 1.5-17 Notable Changes
-------------------------------
 - *** THIS IS A BETA RELEASE, FOR EVALUATION USE ONLY ***
 - Has known issue with error handling when setting invalid email relay.
 - The default amount of RAM allocated to the JumpBox has been increased to a
   minimum of 512 MB, some JumpBoxes may use more.
 - Fixed intermittent NFS related backup issue from 1.5-13.
 - Time sync with the host has been disabled and replaced by the NTP time
   server, this requires that the JumpBox have network access.  If outbound
   networking is not available you can use your own NTP server or reenable the
   virtual host based time sync on VMware based platforms.
 - We have fixed the "First Boot Method" for getting a larger storage disk as 
   described here:
       http://wiki.jumpbox.com/doc/runtime/faq/larger_storage_disk

Release 1.5-13 Notable Changes
-------------------------------
 - *** THIS IS A BETA RELEASE, FOR EVALUATION USE ONLY ***
 - This is the first Ubuntu Lucid Lynx 10.04 LTS based release of a JumpBox.
 - Has known intermittent issue with NFS based backups and restores.  Retrying
   in the event of failure works.

===============================================================================
== PmWiki Release Notes                                                      ==
===============================================================================

Tue Oct  2 15:16:16 MST 2012 - 1.7.11
 - The included version of PmWiki has been upgraded to 2.2.43. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed Aug 22 15:26:52 MST 2012 - 1.7.10
 - The included version of PmWiki has been upgraded to 2.2.42. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Aug 14 16:17:35 MST 2012 - 1.7.9
 - The included version of PmWiki has been upgraded to 2.2.41. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed Jul 25 15:37:06 MST 2012 - 1.7.8
 - The included version of PmWiki has been upgraded to 2.2.40. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed Jun 27 13:39:19 MST 2012 - 1.7.7
 - The included version of PmWiki has been upgraded to 2.2.39. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue May 22 14:51:42 MST 2012 - 1.7.6
 - The included version of PmWiki has been upgraded to 2.2.38. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed May  9 14:29:38 MST 2012 - 1.7.5
 - The included version of PmWiki has been upgraded to 2.2.37. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Apr  3 12:55:07 MST 2012 - 1.7.4
 - This is a platform maintenance update. The version of the application has 
   not changed.

Tue Jan  3 10:55:54 MST 2012 - 1.7.3
 - The included version of PmWiki has been upgraded to 2.2.36. 
 - This is a minor bugfix update. See the PmWiki release notes for complete 
   details: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed Nov 16 16:10:36 MST 2011 - 1.7.2
 - The included version of PmWiki has been upgraded to 2.2.35. 
 - This update contains security fixes and updating is recommended for all 
   users.  See the PmWiki release notes for complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed Sep 28 15:29:13 MST 2011 - 1.7.1
 - The included version of PmWiki has been upgraded to 2.2.33. 
 - This update contains security fixes and updating is recommended for all 
   users.  See the PmWiki release notes for complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Aug  2 14:30:55 MST 2011 - 1.7.0
 - The included version of PmWiki has been upgraded to 2.2.29. 
 - This update fixes 2 XSS security vulnerabilities.  See the PmWiki release 
   notes for complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Thu Jul 14 12:30:46 MST 2011 - 1.6.4
 - The included version of PmWiki has been upgraded to 2.2.27. 
 - This update fixes a validation issue and adds a new block to WikiStyle.
   See the PmWiki release notes for complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Thu Jun  2 10:19:41 MST 2011 - 1.6.3
 - The included version of PmWiki has been upgraded to 2.2.26. 
 - This update fixes an issue in WikiTrails. See the PmWiki release notes for 
   complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Apr 12 15:54:39 MST 2011 - 1.6.2
 - The included version of PmWiki has been upgraded to 2.2.25. 
 - This update is for documentation. See the PmWiki release notes for complete 
   details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Fri Feb 18 10:12:51 MST 2011 - 1.6.1
 - The included version of PmWiki has been upgraded to 2.2.24. 
 - This update changes how some PageVariables are handled. See the PmWiki
   release notes for complete details: 
   http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Jan 10 15:33:09 MST 2011 - 1.6.0
 - The included version of PmWiki has been upgraded to 2.2.21. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - An XSS vulnerability was fixed as well as a few other bugs.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Nov 22 10:13:03 MST 2010 - 1.5.1
 - The included version of PmWiki has been upgraded to 2.2.19. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release updates pmwiki documentation and is not an essential upgrade.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Sep 13 15:37:05 MST 2010 - 1.5.0
 - The included version of PmWiki has been upgraded to 2.2.18. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Jun 21 12:53:34 MST 2010 - 1.1.18
 - The included version of PmWiki has been upgraded to 2.2.17. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Wed May 12 15:59:25 MST 2010 - 1.1.17
 - The included version of PmWiki has been upgraded to 2.2.16. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Mar 29 15:23:24 MST 2010 - 1.1.16
 - The included version of PmWiki has been upgraded to 2.2.15. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Mar  1 14:33:41 MST 2010 - 1.1.15
 - The included version of PmWiki has been upgraded to 2.2.14. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Feb 22 11:39:40 MST 2010 - 1.1.14
 - The included version of PmWiki has been upgraded to 2.2.13. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Feb 15 16:39:07 MST 2010 - 1.1.13
 - The included version of PmWiki has been upgraded to 2.2.11. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Jan 18 08:37:49 MST 2010 - 1.1.12
 - The included version of PmWiki has been upgraded to 2.2.10. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Thu Dec 10 13:27:48 MST 2009 - 1.1.11
 - The included version of PmWiki has been upgraded to 2.2.8. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Sun Nov  8 13:49:31 MST 2009 - 1.1.10
 - The included version of PmWiki has been upgraded to 2.2.7. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Oct  5 10:00:15 MST 2009 - 1.1.9
 - The included version of PmWiki has been upgraded to 2.2.6. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Fri Aug 28 17:08:59 MST 2009 - 1.1.8
 - The included version of PmWiki has been upgraded to 2.2.5. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release contains some minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Fri Jul 17 12:39:27 MST 2009 - 1.1.7
 - The included version of PmWiki has been upgraded to 2.2.4. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release fixes six potential XSS vulnerabilities, and contains a number
   of other minor improvements.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Jun 22 16:00:24 MST 2009 - 1.1.6
 - The included version of PmWiki has been upgraded to 2.2.2. Release notes
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release fixes a security flaw which did not affect the JumpBox for
   PmWiki unless the configuration was customized.
 - Restoring from 1.0 and newer JumpBox backups should work.

Mon Mar 30 14:25:44 MST 2009 - 1.1.5
 - The included version of PmWiki has been upgraded to 2.2.1. Release notes 
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - This release comes with updated local documentation, an improved redirect
   mechanism, and various other minor bugfixes. 
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Feb  3 10:52:09 MST 2009 - 1.1.4
 - The included version of PmWiki has been upgraded to 2.2.0. Release notes 
   are available here: http://www.pmwiki.org/wiki/PmWiki/ReleaseNotes
 - Restoring from 1.0 and newer JumpBox backups should work.

Tue Dec  9 12:11:21 MST 2008 - 1.1.3
 - The JumpBox for PmWiki no longer requires registration.

Tue Sep 30 12:40:39 MST 2008 - 1.1.2
 - No application specific updates.  Check the Platform Release section for
   details.

Sun Jul 27 17:59:48 MST 2008 - 1.1.1
 - Security update. The version of the included application has not changed, 
   but the JumpBox has been released to fix a vulnerability in PHP.

Mon Jun 23 15:18:04 MST 2008 - 1.1.0
 - Initial release of this application on the JumpBox 1.1.0 Platform.
 - The PmWiki version has not changed.  Restoring from 1.0 and newer JumpBox
   backups should work.

Wed Jan 30 09:17:14 MST 2008 - 1.0
 - First production release of the PmWiki Jumpbox.  Includes PmWiki version 
   2.1.27.  You should be able to restore from the 0.9 PmWiki JumpBox.

Tue Nov 27 10:58:23 MST 2007 - 0.9
 - ******** WARNING ******** 
   **  This is release is either beta or experimental. It should not be relied
   **  upon for production use.
   ******** WARNING ******** 
 - Initial public Beta release of PmWiki Version 2.1.7 JumpBox.

