=============================================================================== == 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. =============================================================================== == MediaWiki Release Notes == =============================================================================== Wed May 8 13:26:24 MST 2013 - 1.8.2 - MediaWiki was updated to version 1.20.5. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This MediaWiki update is a security and bug fix release. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.20 Wed Apr 24 13:34:09 MST 2013 - 1.8.1 - MediaWiki was updated to version 1.20.4. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This MediaWiki update is a bug fix release. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.20 Wed Mar 13 10:41:00 MST 2013 - 1.8.0 - MediaWiki was updated to version 1.20.3. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This MediaWiki update is a bug fix release. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.20 Thu Dec 6 15:57:56 MST 2012 - 1.7.9 - MediaWiki was updated to version 1.20.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a MediaWiki bug fix release. For full detail see the MediaWiki release notes for versions 1.20.1 and 1.20.2: http://www.mediawiki.org/wiki/Release_notes/1.20 Wed Nov 14 10:15:23 MST 2012 - 1.7.8 - MediaWiki was updated to version 1.20.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This MediaWiki release has a long list of updates and bug fixes. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.20 Fri Sep 7 11:33:12 MST 2012 - 1.7.7 - MediaWiki was updated to version 1.19.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a security update. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.19 Thu Jun 21 09:32:16 MST 2012 - 1.7.6 - MediaWiki was updated to version 1.19.1. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a minor bug fix update for three issues. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.19 Fri May 11 10:57:44 MST 2012 - 1.7.5 - MediaWiki was updated to version 1.19.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a bug fix release for a very long list of issues. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.19 Wed May 2 15:08:05 MST 2012 - 1.7.4 - MediaWiki was updated to version 1.18.3. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a bug fix release for 5 issues. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/MediaWiki_1.18 Wed Mar 28 09:20:08 MST 2012 - 1.7.3 - MediaWiki was updated to version 1.18.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a bug fix release for a long list of issues. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/MediaWiki_1.18 Wed Jan 18 14:37:33 MST 2012 - 1.7.2 - MediaWiki was updated to version 1.18.1. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a bug fix release for 9 issues. For full detail see the MediaWiki release notes: http://www.mediawiki.org/wiki/MediaWiki_1.18 Thu Dec 8 15:51:09 MST 2011 - 1.7.1 - MediaWiki was updated to version 1.18.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is significant update to MediaWiki and contains numerous changes including better gender support, improved file metadata, better directionality support and many bug fixes and other enhancements. For full details see the MediaWiki release notes: http://www.mediawiki.org/wiki/MediaWiki_1.18 Tue Sep 27 15:05:23 MST 2011 - 1.7.0 - This is a maintenance release. The included version of the application has not changed. Mon Jun 27 16:24:28 MST 2011 - 1.6.7 - MediaWiki was updated to version 1.17.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is significant update to MediaWiki and contains hundreds of bug fixes and other changes. For full details see the MediaWiki release notes: http://www.mediawiki.org/wiki/Release_notes/1.17 Version 1.6.6 was not publicly released. Wed May 11 15:03:13 MST 2011 - 1.6.5 - MediaWiki was updated to version 1.16.5. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is a security release with further fixes for an IE 6 vulnerability. - Full details and release notes are available here: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_5/phase3/RELEASE-NOTES Thu Apr 21 13:39:56 MST 2011 - 1.6.4 - MediaWiki was updated to version 1.16.4. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is security release addressing an IE 6 vulnerability. - Full details and release notes are available here: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_4/phase3/RELEASE-NOTES Wed Apr 13 14:19:22 MST 2011 - 1.6.3 - MediaWiki was updated to version 1.16.3. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - This is security and maintenance release for the 1.16 branch of Mediawiki. - Full details and release notes are available here: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_3/phase3/RELEASE-NOTES Tue Feb 1 18:07:35 MST 2011 - 1.6.2 - MediaWiki was updated to version 1.16.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_2/phase3/RELEASE-NOTES - This is security and bugfix release for the 1.16 branch of Mediawiki. Wed Jan 5 13:55:48 MST 2011 - 1.6.1 - MediaWiki was updated to version 1.16.1. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_1/phase3/RELEASE-NOTES - This is security and bugfix release for the 1.16 branch of Mediawiki. Mon Dec 20 13:47:55 MST 2010 - 1.6.0 - This is a maintenance release. The included version of the application has not changed. - The JumpBox is now based on the 10.04 Lucid version of Ubuntu Linux Wed Aug 4 12:09:15 MST 2010 - 1.1.18 - MediaWiki was updated to version 1.16.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_16_0/phase3/RELEASE-NOTES - This is a major quarterly release of Mediawiki. It contains numerous bugfixes and improvements. Wed Jun 2 10:08:40 MST 2010 - 1.1.17 - MediaWiki was updated to version 1.15.4. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_15_4/phase3/RELEASE-NOTES - This is a security and bugfix release of MediaWiki. Wed Apr 7 11:07:23 MST 2010 - 1.1.16 - MediaWiki was updated to version 1.15.3. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_15_3/phase3/RELEASE-NOTES - This is a security and bugfix release of MediaWiki. Mon Mar 8 19:44:04 MST 2010 - 1.1.15 - MediaWiki was updated to version 1.15.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_15_2/phase3/RELEASE-NOTES - This is a security and bugfix release of MediaWiki. Wed Feb 10 10:01:56 MST 2010 - 1.1.14 - No application specific updates. Mon Jul 13 16:24:15 MST 2009 - 1.1.13 - MediaWiki was updated to version 1.15.1. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://lists.wikimedia.org/pipermail/mediawiki-announce/2009-July/000087.html - This is a security and bugfix release of MediaWiki. Thu Jun 18 14:22:10 MST 2009 - 1.1.12 - MediaWiki was updated to version 1.15.0. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://svn.wikimedia.org/svnroot/mediawiki/tags/REL1_15_0/phase3/RELEASE-NOTES - This release fixes a number of minor bugs and includes numerous minor improvements. (Version 1.1.11 of the JumpBox was broken and should not be used.) Mon May 4 15:52:30 MST 2009 - 1.1.10 - No application specific updates. Mon Feb 23 16:53:29 MST 2009 - 1.1.9 - MediaWiki was updated to version 1.13.4. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - Release notes are available at the following URL: http://www.mediawiki.org/wiki/Release_notes/1.14 Mon Feb 9 16:19:29 MST 2009 - 1.1.8 - MediaWiki was updated to version 1.13.4. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. - The application now runs under the root url. - This release is a security update: http://lists.wikimedia.org/pipermail/mediawiki-announce/2009-February/000083.html (The release notes for 1.1.7 were omitted in error). Thu Oct 2 18:42:15 MST 2008 - 1.1.6 - MediaWiki was updated to version 1.13.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. Mon Sep 22 20:30:32 MST 2008 - 1.1.5 - No application specific updates. Check the Platform Release section for details. Fri Sep 5 12:41:06 MST 2008 - 1.1.3 - A bug that preventred restores from 1.0RC2 versions has been fixed. Mon Aug 18 14:13:19 MST 2008 - 1.1.2 - MediaWiki was updated to version 1.13. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. 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. Wed Jun 18 13:46:10 MST 2008 - 1.1.0 - Initial release of this application on the JumpBox 1.1.0 Platform. - The MediaWiki version did not change. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. Wed Mar 26 12:39:07 MST 2008 - 1.0.7 - MediaWiki was updated to version 1.12. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. Thu Mar 6 14:41:37 MST 2008 - 1.0.6 - MediaWiki was updated to version 1.11.2. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. Wed Jan 2 17:14:39 MST 2008 - 1.0.4 - No application specific updates. Check the Platform Release section for details. Mon Oct 1 20:39:27 MST 2007 - 1.0.3 - MediaWiki was updated to version 1.11. Users should be able to restore from the MediaWiki JumpBox version 1.0 and later. Wed Aug 22 18:25:49 MST 2007 - 1.0.2 - Fixed bug that prevented restoring from version 1.0. Wed Aug 22 14:17:23 MST 2007 - 1.0.1 - No application specific changes. Tue Jul 17 15:28:02 MST 2007 - 1.0 - Content was added to the Help Page. Mon Jun 25 09:45:55 MST 2007 - 1.0RC5 JumpBox Platform changes: - Navigation Bar restores properly - License Validation no longer requires the JumpBox to be connected to the Internet - SSH Enable first-time bug fixed - Static IP changing bug fixed - All Ubuntu copyright notices restored - Primary Application licensing given equal treatment. - Samba config typo fixed Tue Jun 5 10:46:28 MST 2007 - 1.0RC4 - Upgraded to Mediawiki 1.10.0 - Restore mechanism modified to handle updates from JumpBox versions: 0.5, 1.0RC1, and 1.0RC2 - Installed ImageMagick - Fixed bug in restore filename checkking that prevented restores from working out of the box - Corrected the sources.list so apt should work - Fixed various browser specific javascript bugs - Updated parallels config file to remove unneeded hardware - Added Hardware/MAC address to console message Wed Apr 25 11:22:31 MST 2007 - 1.0RC2 Fixed bug with setting Mac addresses dynamically in parallels. Tue Apr 24 14:54:42 MST 2007 - 1.0RC1 Base OS Updates, New Administration UI Layout, Improvements and Bug Fixes: - Improved JumpBoc Navigation Bar and added disable feature - Improved Administration UI including addition of Network Information - Added HTTP Proxy Setting - Application level IP addresses are updated when IP changes via DHCP or the Administration Interface - Fixed single DNS server name resolution problem - Fixed erroneous duplicate hostname/IP messages Thu Mar 08 17:29:23 MST 2007 - 0.5 First public release of Mediawiki version 1.9.3.