=============================================================================== == 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. =============================================================================== == Redmine Specific Documentation == =============================================================================== This JumpBox also includes Subversion for source control. In this release Subversion has been changed to be available over HTTP rather than over SVN+SSH. Subversion is currently integrated with Redmine in the following ways: * If you create a Project in Redmine, a corresponding Subversion repository will be created within 5 minutes (NOTE, it is NOT created immediately). * Any users created in Redmine AND assigned to a project will be granted write access to that subversion repository. Everyone else will only have READ access to that repository. * Subversion repositories are currently only available using the HTTP based svn method. The URL to access a Subversion repository is like this: svn:///svn/ or, for example svn://192.168.1.100/svn/mycoolproject The current integration with Subversion may interfere with the use of other/external repositories with Redmine. The trick to making Redmine work with other repositories is to immediately setup the external repository before the automatic process has a chance to run. We are aware of this limitation and hope to change how it works in the future. =============================================================================== == 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. =============================================================================== == Redmine Release Notes == =============================================================================== Wed Apr 25 15:57:01 MST 2012 - 1.7.5 - Redmine has been updated to Redmine 1.4.1. - This release is able to restore from JumpBox version 1.1.23 and newer. If you have an older JumpBox you should first upgrade to 1.7.3 and then upgrade again to 1.7.4 - This is a minor bugfix update. For detail on the changes see the Redmine changelog: http://www.redmine.org/projects/redmine/wiki/Changelog Mon Apr 23 13:38:31 MST 2012 - 1.7.4 - Redmine has been updated to Redmine 1.4.0. - This release is able to restore from JumpBox version 1.1.23 and newer. If you have an older JumpBox you should first upgrade to 1.7.3 and then upgrade again to 1.7.4 - This update contains a large number of bug fixes and switches to builder for the management of dependencies. For detail on the changes see the Redmine changelog: http://www.redmine.org/projects/redmine/wiki/Changelog Tue Mar 13 14:58:04 MST 2012 - 1.7.3 - Redmine has been updated to Redmine 1.3.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This update for Redmine contains 17 bug fixes. For detail on the fixed issues see the Redmine changelog: http://www.redmine.org/projects/redmine/wiki/Changelog Fri Feb 17 16:12:09 MST 2012 - 1.7.2 - Redmine has been updated to Redmine 1.3.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This update for Redmine contains 15 bug fixes. For detail on the fixed issues see the Redmine changelog: http://www.redmine.org/projects/redmine/wiki/Changelog Fri Dec 23 12:46:22 MST 2011 - 1.7.1 - Redmine has been updated to Redmine 1.3.0. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This is update for Redmine contains a long list of bug fixes detailed in the Redmine changelog:. http://www.redmine.org/projects/redmine/wiki/Changelog Fri Sep 23 09:32:23 MST 2011 - 1.7.0 - This is a maintenance release. The included version of the application has not changed. Thu Jul 14 12:39:24 MST 2011 - 1.6.7 - Redmine has been updated to Redmine 1.2.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This is a minor bugzix release for Redmine and adds no new features. See the Redmine release notes for details: http://www.redmine.org/projects/redmine/wiki/Changelog Thu Jun 9 16:28:47 MST 2011 - 1.6.6 - Redmine has been updated to Redmine 1.2.0. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This release fixes a large number of bugs and adds over 30 new features. See the Redmine release notes for full details: http://www.redmine.org/projects/redmine/wiki/Changelog Fri May 6 11:47:10 MST 2011 - 1.6.5 - Redmine has been updated to Redmine 1.1.3. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This release fixes 23 bugs with no new features. See the Redmine release notes for full details: http://www.redmine.org/projects/redmine/wiki/Changelog Thu Mar 17 10:27:04 MST 2011 - 1.6.4 - Redmine has been updated to Redmine 1.1.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This release fixes 14 bugs and adds a retro Gravatars feature to Redmine. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Thu Feb 10 13:35:56 MST 2011 - 1.6.3 - Redmine has been updated to Redmine 1.1.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This release fixes 19 bugs and updates CodeRay to the latest version. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Mon Jan 24 13:54:11 MST 2011 - 1.6.2 - Redmine has been updated to Redmine 1.1.0. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This release adds new features and fixes bugs. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Wed Jan 5 14:05:07 MST 2011 - 1.6.1 - Redmine has been updated to Redmine 1.0.5. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This is a minor bugfix release. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Fri Dec 3 10:46:25 MST 2010 - 1.6.0 - Redmine has been updated to Redmine 1.0.4. Restores from the Redmine 0.6 and newer JumpBoxes should work. - This is a minor bugfix release. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Wed Nov 17 14:18:04 MST 2010 - 1.5.1 - Redmine has been updated to Redmine 1.0.3. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/projects/redmine/wiki/Changelog Thu Oct 14 13:54:15 EDT 2010 - 1.5.0 - This JumpBox for Redmine has been moved to the new Lucid Based JumpBox platform. - Redmine has been updated to Redmine 1.0.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - Passenger has been upgrade to version 2.2.15. Mon Aug 23 13:23:12 MST 2010 - 1.1.23 - Redmine has been updated to Redmine 1.0.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a minor update that includes minor fixes and improvements. Wed Aug 11 12:09:52 MST 2010 - 1.1.22 - Redmine has been updated to Redmine 1.0.0 RC. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a major release which includes many new features and bugfixes since the last major release. Fri Jul 9 12:07:10 MST 2010 - 1.1.21 - Redmine has been updated to Redmine 0.9.6. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a security update. Wed Jun 30 13:23:37 MST 2010 - 1.1.20 - Redmine has been updated to Redmine 0.9.5. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a minor update that includes minor fixes and improvements. Tue May 4 17:10:50 MST 2010 - 1.1.19 - Redmine has been updated to Redmine 0.9.4. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a minor update that includes minor fixes and improvements. Thu Mar 4 15:08:03 MST 2010 - 1.1.18 - This release fixes a bug in the JumpBox backup process. - The included version of Redmine has now changed. - Backups made by a 1.1.17 JumpBox may not contain Redmine plugin information. Contact support@jumpbox.com for a simple fix for this problem. Tue Mar 2 12:32:12 MST 2010 - 1.1.17 - Redmine has been updated to Redmine 0.9.3. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a minor update that includes minor fixes and improvements. Tue Feb 23 12:40:56 MST 2010 - 1.1.16 - Redmine has been updated to Redmine 0.9.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This is a major upgrade that includes new features such as: Project copy, Unlimited project nesting, Version inheritance, User groups and permissions, Project creation by non-admin users, and improvements to the issue list. Fri Nov 20 11:58:54 MST 2009 - 1.1.15 - Redmine has been updated to Redmine 0.8.7. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This release fixes a CSRF vulnerability and a includes number of minor bug fixes and improvements. Sun Nov 8 13:48:51 MST 2009 - 1.1.14 - Redmine has been updated to Redmine 0.8.6. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This release fixes XSS vulnerabilities and a number of minor bug fixes and improvements. Wed Sep 16 16:17:56 MST 2009 - 1.1.13 - Redmine has been updated to Redmine 0.8.5. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This release contains a number of minor bug fixes and improvements. Mon Aug 31 14:49:50 MST 2009 - 1.1.12 - This is a maintenance release. The included version of Redmine has not changed. Wed Jun 24 15:59:07 MST 2009 - 1.1.11 - This release contains Ubuntu Security Updates which could possibly impact the security of your JumpBox. The included application has not changed. - This release includes some other minor fixes. - Restores from the Redmine 0.6 and newer JumpBoxes should work. Wed May 20 14:11:40 MST 2009 - 1.1.10 - Redmine has been updated to Redmine 0.8.4. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This release fixes a number of minor bugs. Fri Apr 24 12:04:37 MST 2009 - 1.1.9 - A bug that broke Redmine's abilitiy to view SVN repositories for "private" projects has been fixed. The Redmine application itself did not change. - Restores from the Redmine 0.6 and newer JumpBoxes should work. Fri Apr 17 14:10:16 MST 2009 - 1.1.8 - A bug that caused premature session expiration. The Redmine application did not change. - Restores from the Redmine 0.6 and newer JumpBoxes should work. Wed Apr 8 11:18:08 MST 2009 - 1.1.7 - Redmine has been updated to Redmine 0.8.3. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This minor Redmine update fixes a number of bugs. - The JumpBox for Redmine now uses Phusion Passenger instead of Mongrel. Mon Mar 9 10:29:49 MST 2009 - 1.1.6 - Redmine has been updated to Redmine 0.8.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog - This minor updates fixes a number of bug fixes, and allows administrators to notify users by email when accounts are created for them. Fri Feb 27 12:14:35 MST 2009 - 1.1.5 - A bug that broke the subversion repositories of restores that contained subprojects has been resolved. The Redmine application did not change. Sun Feb 15 16:41:37 MST 2009 - 1.1.4 - Redmine has been updated to Redmine 0.8.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. - Release notes are available at the following URL: http://www.redmine.org/wiki/redmine/Changelog Tue Feb 3 12:04:10 MST 2009 - 1.1.3 - A problem had prevented "svn cp" from working has been fixed. - Redmine now runs under the root url ("/", as opposed to "/redmine"). - Various other improvements have been made. - The version of the included application has not changed. - Restores from the Redmine 0.6 and newer JumpBoxes should work. Wed Jan 7 20:37:24 MST 2009 - 1.1.2 - Redmine has been updated to Redmine 0.8.0. Restores from the Redmine 0.6 and newer JumpBoxes should work. Tue Dec 2 09:55:34 MST 2008 - 1.1.1 - A minor bug has been resolved. - The version of the included application has not changed. - Restores from the Redmine 0.6 and newer JumpBoxes should work. Thu Oct 9 15:44:31 MST 2008 - 1.1.0 - First production release. The version of the included application has not changed. Wed Sep 24 20:38:14 MST 2008 - 0.6.8 - Platform update. The version of the included application has not changed. Wed Sep 3 17:33:08 MST 2008 - 0.6.7 - A bug that prevented restores for some users has been resolved. Tue Jul 22 15:14:06 MST 2008 - 0.6.6 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - Redmine has been updated to Redmine 0.7.3. Restores from the Redmine 0.6 and newer JumpBoxes should work. - The version of Rails used by Redmine was updated to 2.0.2. This fixes a bug related to changing the admin user's name, and possibly others. Tue Jun 24 18:13:25 MST 2008 - 0.6.5 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - Redmine has been updated to Redmine 0.7.2. Restores from the Redmine 0.6 and newer JumpBoxes should work. - The SMTP mail issue was resolved again. Email should send from the JumpBox with the normal caveats (see: http://www.jumpbox.com/faq/email). - The Private Repository SVN problem has been resolved. So you should now be able to mark repositories as private and SVN should continue working for that repository. Thu May 22 18:16:32 MST 2008 - 0.6.4 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - Redmine has been updated to Redmine 0.7.1. Restores from the Redmine 0.6 and newer JumpBoxes should work. Sat Apr 12 07:28:43 MST 2008 - 0.6.3 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - The broken SVN repository issue is resolved. - A Backup/Restore related bug has been resolved. - A JumpBox navigation bar issue in the JumpBox platform was also resolved. - This release can only restore from 0.6.3 Redmine JumpBoxes, future releases may restore from the older releases. Thu Mar 20 11:00:02 MST 2008 - 0.6.1 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - We have updated the version of Redmine to 0.6.4 and Rails to 1.2.6. - This release addresses a JumpBox Navigation Bar issue that made accessing the application with the Navigation Bar disabled inconvenient. Wed Feb 20 18:06:40 MST 2008 - 0.6 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - This is another Experimental release. It contains an updated release of Redmine (0.6.3) and many JumpBox Platform Updates (listed elsewhere in this file). - An important change to be aware of is that SVN is now done over HTTP rather than the svn+ssh method. See the Redmine Readme section for details. - There is a known, yet unidentified bug in the restore process. We believe that backups are generated correctly but don't count on it. We hope to resolve this soon. If you encounter any trouble, please post on the Proving Ground forums. - You may or may not be able to restore from a 0.5 or 0.6 Redmine JumpBox. See above. Tue Nov 27 10:58:23 MST 2007 - 0.5 - ******** WARNING ******** ** This is release is either beta or experimental. It should not be relied ** upon for production use. ******** WARNING ******** - Initial public Experimental release of Redmine Version 0.5 JumpBox.