Sueetie 2.0 to 2.1 Upgrade Guide

Why Upgrade?¶

YAF 1.9.5 has a number of new features including a Daily Digest and Advanced Polling. More important to us Sueetie Performance Freaks, v1.9.5 is even faster than v1.9.4. And v1.9.4 was fast! Here's a document containing an overview of YAF 1.9.5 improvements.

As for Sueetie-specific upgrade benefits, YAF 1.9.5 is fully integrated with Sueetie for tagging, calendar and other functions, so it's win-win. Also, v2.x Releases are planned on being Upgrades and not Full Releases, so unless you want to wait for a full Sueetie v3.0 Release to enjoy YAF 1.9.5, you'll want to take advantage of the Sueetie v2.1 Upgrade.

The following steps are applicable when upgrading both Gummy Bear and the Atomo Developers Package. For specific instructions on upgrading Atomo see Atomo 2.0 to 2.1 Upgrade Guide.¶

Confirm you're running Sueetie Version 2.0¶

This is typically the first step in any Sueetie upgrade. For our purposes in the v2.0-to-2.1 upgrade, we want to make certain we are running Sueetie Version 2.0. You can confirm you are running v2.0 by the "CommunityFramework" metatag and any View Source page.

We're upgrading to YetAnotherForum.NET 1.9.5 RTM...¶

Remember, the primary objective of Sueetie v2.1 is to upgrade Sueetie forums to YetAnotherForum.NET 1.9.5 RTM. The general process overview is:

1. Backup SQL Database and Existing /forum directory
2. ZIP and backup your site's existing /forum directory
3. Update db.config and mail.config for your environment
4. Replace /forum directory contents with the v2.1 Upgrade Package /forum contents
5. Step through YAF Upgrade wizard
6. Update other /web contents with those in the v2.1 Upgrade Package. These updates cover all Minature releases to date for v2.0.
   

An Installation Step-Through¶

Here's the step-through guide for how I upgrade Sueetie.com. Sueetie.com is located on a Virtual Private Server where I have Remote Desktop access, but you can perform the same steps with strictly FTP.

Backup the SQL Database and Existing /forum Directory¶

We want to make sure we have a full copy of the SQL database because the YAF installation script is going to make quite a number of changes. We also want a copy of the existing /forum directory in case we need to perform a rollback to v2.0 for any reason. ZIP up /forum and copy to a safe location.

Update db.config and mail.config for your environment¶

Use the existing /forum db.config and mail.config files for updating the v2.1 Upgrade Package configs.

Delete site's existing /forum directory¶

It's time to do the deed. No turning back now. Let's delete the existing /forum directory, but preserve the /images and /uploads directories. If you're using custom themes other than Lollipop and Chiclet you'll want to make sure you backup a copy of those as well. Here's a screenshot of the /forum contents I deleted during the Sueetie.com upgrade via Remote Desktop. The v2.1 Upgrade Package doesn't include an app_offline.htm file. I used one at Sueetie.com to block access to http://sueetie.com/forum while I was updating the /forum contents, but it's your call on that. Probably a good idea depending on your site forums traffic.

Execute the YAF 1.9.5 Upgrade Wizard¶

To upgrade YetAnotherForum.NET to 1.9.5 RTM and begin the Sueetie v2.0 to 2.1 upgrade process, after updating your /forum contents with the Sueetie v2.1 /forum contents, go to http://yoursite.com/forum where the YAF upgrade wizard will automatically launch.

YAF Upgrade Wizards have the capabilities of updating your SMTP and Connection Settings. We're not supporting those capabilities in Sueetie, however. It requires giving permissions to .config files that is in the end more complicated than updating the files in our favorite Text Editor, which is what we've done in a previous step. We're using the YAF Upgrade Wizard to upgrade the SQL Database. That's it.

Here are the upgrade screens you'll see.

The config password is found in the app.config. Sueetie pre-populated the password as "password". It would be prudent to go back to the app.config and change this password after the upgrade is complete.



Nothing needs done here unless you want to check your SQL Connection. Leave the SMTP settings blank.



Nothing to do here either. This is the Big Money "Next" Button. This updates the SQL database. Leave the "attempt to install fulltext searching" checkbox clear.



Clicking finish will display YAF 1.9.5 RTM with the Lollipop Theme.

Update the other \web contents¶

Sueetie v2.1 also contains all updates included in the three v2.0 Miniatures released to date. Copying the remaining web content outside of the /forum folder will bring your site up-to-date. Your web.config will be updated (for the sole purpose of setting the debug property to false), so remember to update your WCF Host Settings afterward to http://yoursite.com.

Bonus url.config update¶

YAF 1.9.5 uses new (and improved) url rewriting for user profiles. The existing urls will still work, but it is best to replace the following urls in the "members" section of your /util/config/url.config file with the following.

<url name="members_masteraccountinfo" pattern="/{0}/yaf_cp_profile.aspx" />
<url name="members_masterprofile" pattern="/{0}/yaf_profile{1}.aspx"  />

YAF 1.9.5 and your Custom Sueetie Theme¶

When you bring up YAF 1.9.5 after the upgrade it is configured to use the Lollipop theme. If you are using a custom theme the Lollipop YAF 1.9.5 Forum will not look like it does in the catalog. You can either change the theme to your custom theme in YAF Admin or by resetting your Site Theme Settings, which will update the YAF theme to your custom theme.

A word on custom themes with YAF 1.9.5. I copied over the YafVision theme to a new Lollipop theme and then updated the /forum/themes/Lollipop/theme.css and /themes/lollipop/style/forum.css stylesheets when doing the initial Sueetie upgrade to YAF 1.9.5. With Sueetie's global theming model we were able to preserve most YAF 1.9.4 settings with style/shared.css, style/forum.css and /forum/masters/lollipop/forum.master, but copying over YafVision (the forum theme Sueetie YAF Lollipop was based) insured all classes, images and JS files were included.

Confirm you're running Sueetie v2.1 and YAF 1.9.5 RTM¶

Any page in the root area of your site will now display v2.1 in the source view CommunityFramework meta tag as shown below. It was also display v2.1 on the Sueetie Admin Home Page. For convenience we're only updating the Sueetie /bin DLLs in the root and forum, so the wiki, blog and media CommunityFramework meta tag will continue to display v2.0, as they use their own Sueetie dlls.



An additional reward of performing the v2.1 upgrade is that you'll now see the following YetAnotherForum.NET 1.9.5 RTM version indicator in the footer of your forum. Woo-hoo!

Copyright © 2008-2012 Sueetie LLC. All rights reserved.