Upgrading from Nova 1 to Nova 2

Nova 2 Getting Started Install Guide Developer Resource

The process of updating from Nova 1 to Nova 2 is pretty simple and straightforward, but it's important that you follow these instructions otherwise something could go wrong and you'll have to start all over again, or worst-case scenario, you lose your data (yet another reason you should always backup first).

1. Getting Started

1.1 Backing Up

As with all updates to the system, you should backup both your database and your files to your desktop in the event something goes wrong. Without backups, there will be no way to revert back to an older version if something happens. It's also important to have a copy of all the changes you've made to Nova 1 since you'll have to manually re-apply those changes after the update is finished.

1.2 Remove

Once you've finished backing up all of your stuff, delete all of the Nova files in your site.

When we say delete, we mean it. Delete every Nova file on your server and then upload the new copy. There have been a massive number of changes to Nova since the release of 1.2.6 and if you don't delete all the files and upload fresh copies, there's no telling what your FTP client might do to the files (attempt to merge them, not overwrite them, etc.).

1.3 Upload

Now that you've got an empty directory (kinda scary to hit that delete button, huh?), it's time to upload Nova 2 to your site.

It'll likely take a few minutes to upload everything since there are a lot of files that'll need to be uploaded.

Important: Don't try to cram all of your modifications and skins in at this point. Do the update from Nova 1 and then go back and do your modifications and skins after you know Nova 2 is up and running.

2. Updating

2.1 Database Connection

Wait, haven't I done this before?

You have indeed, but don't worry, the new process is a breeze and takes less than a minute to complete.

To get started, just open your browser and head to your site. From there, Nova will take over, push you in to the Setup Config page, and walk you through the process of setting up a connection to your database. Once you've put your information in, Nova will actually try to connect to the database and if there's a problem, will tell you right away so you can correct. After everything is correct, it'll write the database connection file to the right location on your server and you'll be on your way.

If you've forgotten some of the pieces of your connection, you can always refer to the database file from your backup (ah, see, bet you're glad you did a backup now). You'll find that in the app/config/database.php file wherever you backed Nova 1 up to.

2.2 Update

Whew! That was easy. Now that the Setup Config process is finished, you have a couple of options for how to proceed. What we want to do right here is update Nova.

The update process works just like the update process in Nova 1. The first step will try to do an automatic backup for you, but you don't have to worry about that too much since you manually backed up everything before you started. (You did back up everything before you started, right?)

Let the update process do its thing and when you're done, you'll be back on the front Nova page and ready to keep continuing the udpate process.

Technically speaking, the update process is done, but odds are you have skins to update, MODs to re-apply, and other such clean-up work you'll want to do.

3. Everything Else

3.1 What About My Skins?

Nova's skinning system didn't change for version 2, so any of your skins from Nova 1 should work with only a few minor modifications (we say "minor" modifications because there are some small changes that need to be made to Thresher and the admin system for Nova 2). For each of your Nova 1 skins you want to use in Nova 2, use the following steps to make sure they're working as expected in Nova 2.

The first thing to do is classify whether your skin is light or dark. In other words, do you have a light-colored background or a dark-colored background? If the skin you're updating has a light-colored background, all of the materials you'll need to copy can be found in the Pulsar skin app/views/default. If the skin you're updating uses a dark-colored background, all of the materials you'll need to copy can be found in the Titan skin app/views/titan. If you've edited a skin taken off of AnodyneXtras, you can download the new copy of the skin now and use the resources found in those skins instead.

Thresher Updates

  1. Copy the wiki.css file from the appropriate skin's wiki/css directory (mentioned above) and paste it into to your skin's wiki/css directory (if you've skinned the wiki).
  2. Edit the main.css stylesheet in wiki/css and add an import statement at the end of the file for the new wiki.css file you just pasted in (you can simply copy and paste one of the import statements already in there). Save the file and make sure everything is uploaded to the server. (This new stylesheet controls the look and feel of the new Thresher Manage Pages section and the new category selection piece.)
  3. If you don't like the colors used, you can change them from the wiki.css stylesheet you just added.
  4. Copy the cat-add.png image from the wiki/images directory of whichever skin you're using as reference and paste it into your own wiki/images directory.

Admin Updates

  • Copy the jquery.chosen.css file from the appropriate skin's admin/css directory (mentioned above) and paste it into to your skin's admin/css directory (if you've skinned the admin system).
  • Nova 2 will automatically look for this stylesheet and import if it exists, so you don't have to do anything else.
  • If you don't like the colors used, you can change them from the jquery.chosen.css stylesheet.
  • Copy the chosen-sprite.png image from the admin/images directory of whichever skin you're using as reference and paste it into your own admin/images directory.
  • If you're using Titan or a modified version of Titan, you will need to pull Titan 2.0's admin.css file from the admin/css directory of the new version of Titan and paste it into to your skin's admin/css directory (if you've skinned the admin section). The reason this is needed only for Titan is because of the use of popovers that are styled with white backgrounds instead of dark backgrounds.

Gotchas

If you've followed the above directions to the letter but you're finding pieces of your skin don't work right or errors are thrown, the odds are your skin uses seamless substitution to swap out one of the default view files for your own. In particular, the posting pages have been subject to this oversight. The fix is to simply go in to your skin and find the view file(s) that are causing the problem. (View files are found in the pages directory in the main/wiki/admin folders.)

3.2 What About My MODs?

Not only has Nova's file structure has changed, but the controllers themselves have also changed. You won't simply be able to copy and paste your old code in to Nova 2 and have it work. The best way to go about it is to copy the method from the base controller in nova/modules/core/controllers and paste it into the appropriate controller in app/controllers. Then, you can re-apply the MOD that way. Sadly, there's no quick and easy way to do this.

If you have questions about a specific MOD working in Nova 2, you should contact the MOD developer.

Before you re-apply a MOD, you should verify that the MOD is necessary any more. For instance, one of Nova 2's new features is that you can use previously disallowed HTML tags like script and embed (for YouTube videos, for example) in site messages. This means that any MODs where you've overridden view files to get some code or video in to a page no longer need that MOD. If you have questions about these kinds of things, post something on the our forums.

Log in with your AnodyneID to rate this article or submit the article for review.