|
|
Quick Upgrade Process
This upgrade process can be used to quickly upgrade your Jamroom. It works especially well if you are running a newer version of Jamroom and would like to upgrade to a newer bug fix release - i.e. you are running Jamroom 2.61 and you want to upgrade to Jamroom 2.66.
- First, make a backup of your Jamroom database via the Admin Menu → Jamroom Tools → Backup Database option. Make sure and save the downloaded SQL file to your computer.
- Download the latest version of the Jamroom Core from the Jamroom Downloads Page. If you are a registered Jamroom User, make sure and download the latest versions of the Jamroom Bonus Pack and Jamroom Power Pack as well.
- Unzip the Jamroom Core download (as well as the Bonus Pack and Power Pack if you have registered) into a temporary directory on your hard drive, and upload the "core" files:
- jamroom/*.php (all PHP files)
- jamroom/include/* (upload this entire directory and all of its sub directories)
- Log in to your Jamroom and Jamroom will prompt you to run the Database validator - do so and your Jamroom is all upgraded!
- Now you will want to verify any new Jamroom Config settings, or any missing images, etc. - check out the Jamroom release announcement for a list of all files that changed, and if you are missing any you can upload them separately. When "jumping" to a new Jamroom version (i.e. Jamroom 2.51 to Jamroom 2.66) you will also want to upgrade the Language files:
- jamroom/language/*.php (all PHP files)
- Upgrading this way ensures that none of your customized templates or Artist Themes are ever overwritten in the upgrade process.
Upgrading Jamroom 2.31 and newer
-
First thing, make sure and do a FULL backup of your Jamroom database and folder structure. I know that the actual MP3 data can be quite large, but it’s worth it to back it up to another partition or hard drive, if available.
-
Next, make sure and note any CUSTOM settings in your jamroom/config/settings.cfg.php file (the Jamroom Settings file) - you’ll want to replace the default settings with your custom settings after you have upgraded the scripts. Likely you haven’t had to change this file, but it’s good to make sure you know how things are configured within it. There are a few other, less modified files in the jamroom/config directory as well - make sure and note any changes to them as well.
-
Next, make sure and save off to a secure place any custom templates (i.e. jamroom/templates/*) as well as any custom themes (jamroom/themes) as you will also want to replace these when finished with the upgrade.
-
Log out of your Jamroom (if you are logged in as the Master Admin).
-
After you are satisfied with your Backup (did I mention making a backup?), you’ll want to upload the new version of the script’s to your server. There are 2 ways this can be done:
-
The first way is to overwrite your entire installation with the new version, and then go back and replace any “custom” versions of templates, etc.
-
The second way is to check out the New Version post in the Jamroom Announcements forum to find out what files actually changed, then just replace the files that have changed. Important while this way typically is the easiest, it requires you to “keep up” with the releases. If you are behind in upgrading your Jamroom to the latest release, you will want to upgrade via the first method.
-
Next, replace any custom templates and themes you had saved off in steps 1 2 and 3 above - replace the “default” versions with your own custom version.
-
Important - Now you must log in to your Jamroom as the Master Admin. When you first log in to Jamroom after performing the upgrade, Jamroom will tell you that your database needs to be validated - click on the “Validate Database” link to have Jamroom ensure your database is configured correctly.
-
Next, click on the “Jamroom Config” button and validate all the settings are as you want them. Save the Jamroom Config. Also, click on “Modify Quota” for each of your Jamroom Quotas and ensure any new settings in the Jamroom Quotas are configured how you would like them to be configured.
Upgrading from Jamroom 2.0b4 to Jamroom 2.30
-
First thing, make sure and do a FULL backup of your Jamroom database and folder structure. I know that the actual MP3 data can be quite large, but it’s worth it to back it up to another partition or hard drive, if available.
-
Next, make sure and note any CUSTOM settings in your jamroom/config/settings.cfg.php file (the Jamroom Settings file) - you’ll want to replace the default settings with your custom settings after you have upgraded the scripts. Likely you haven’t had to change this file, but it’s good to make sure you know how things are configured within it. There are a few other, less modified files in the jamroom/config directory as well - make sure and note any changes to them as well.
-
Next, make sure and save off to a secure place any custom templates (i.e. jamroom/templates/*) as well as any custom themes (jamroom/themes) as you will also want to replace these when finished with the upgrade.
-
Log out of your Jamroom (if you are logged in as the Master Admin).
-
After you are satisfied with your Backup (did I mention making a backup?), you’ll want to upload the new version of the script’s to your server. There are 2 ways this can be done:
-
The first way is to overwrite your entire installation with the new version, and then go back and replace any “custom” versions of templates, etc.
-
The second way is to check out the New Version post in the Jamroom Announcements forum to find out what files actually changed, then just replace the files that have changed. Important while this way typically is the easiest, it requires you to “keep up” with the releases. If you are behind in upgrading your Jamroom to the latest release, you will want to upgrade via the first method.
-
Next, replace any custom templates and themes you had saved off in steps 1 2 and 3 above - replace the “default” versions with your own custom version.
-
-
Important - Now you must log in to your Jamroom as the Master Admin. When you first log in to Jamroom after performing the upgrade, Jamroom will tell you that your database needs to be validated - click on the “Validate Database” link to have Jamroom ensure your database is configured correctly.
-
Next, click on the “Jamroom Config” button and validate all the settings are as you want them. Save the Jamroom Config. Also, click on “Modify Quota” for each of your Jamroom Quotas and ensure any new settings in the Jamroom Quotas are configured how you would like them to be configured.
- When finished you will need to DELETE the upgrade.php script, or Jamroom will show an error announcement when you log into your Jamroom as the Master Admin.
Upgrading from Jamroom 2.0b3 and Older
Upgrading from a version 2.0b3 or older of Jamroom requires a 2-step process - first, upgrading to Jamroom 2.09a, then upgrading your Jamroom to the latest version of Jamroom.
First, we must upgrade your Jamroom to Jamroom 2.09a:
- First thing, make sure and do a FULL backup of your Jamroom database and folder structure. I know that the actual MP3 data can be quite large, but it’s worth it to back it up to another partition or hard drive, if available.
-
-
Unzip the 2.09a archive into a temporary directory on your hard drive - ensure that you preserve the directory structure! (very important!).
-
Upload the new version to your server using your FTP/SFTP client, overwriting the previous Jamroom files.
-
Depending on the version of Jamroom you are currently running, you now need to run the required upgrade script:
-
If you are currently running any version of Jamroom 1 (i.e. Jamroom 1.23), you must run the “upgrade_1-2.php” script.
-
If you are currently running Jamroom 2.0t1 → 2.0b3, then you must run the “upgrade_2x.php” script.
-
Next, upgrade your Jamroom to the latest version:
-
First thing, make sure and do a FULL backup of your Jamroom database and folder structure. I know that the actual MP3 data can be quite large, but it’s worth it to back it up to another partition or hard drive, if available.
-
Next, make sure and note any CUSTOM settings in your jamroom/config/settings.cfg.php file (the Jamroom Settings file) - you’ll want to replace the default settings with your custom settings after you have upgraded the scripts. Likely you haven’t had to change this file, but it’s good to make sure you know how things are configured within it. There are a few other, less modified files in the jamroom/config directory as well - make sure and note any changes to them as well.
-
Next, make sure and save off to a secure place any custom templates (i.e. jamroom/templates/*) as well as any custom themes (jamroom/themes) as you will also want to replace these when finished with the upgrade.
-
Log out of your Jamroom (if you are logged in as the Master Admin).
-
After you are satisfied with your Backup (did I mention making a backup?), you’ll want to upload the new version of the script’s to your server. There are 2 ways this can be done:
-
The first way is to overwrite your entire installation with the new version, and then go back and replace any “custom” versions of templates, etc.
-
The second way is to check out the New Version post in the Jamroom Announcements forum to find out what files actually changed, then just replace the files that have changed. Important while this way typically is the easiest, it requires you to “keep up” with the releases. If you are behind in upgrading your Jamroom to the latest release, you will want to upgrade via the first method.
-
Next, replace any custom templates and themes you had saved off in steps 1 2 and 3 above - replace the “default” versions with your own custom version.
-
-
Important - Now you must log in to your Jamroom as the Master Admin. When you first log in to Jamroom after performing the upgrade, Jamroom will tell you that your database needs to be validated - click on the “Validate Database” link to have Jamroom ensure your database is configured correctly.
-
Next, click on the “Jamroom Config” button and validate all the settings are as you want them. Save the Jamroom Config. Also, click on “Modify Quota” for each of your Jamroom Quotas and ensure any new settings in the Jamroom Quotas are configured how you would like them to be configured.
- When finished you will need to DELETE the upgrade.php script, or Jamroom will show an error announcement when you log into your Jamroom as the Master Admin.
|
|
|
