Upgrading Obsidian

From Obsidian Scheduler
Revision as of 15:07, 20 March 2014 by Craig (talk | contribs)
Jump to navigationJump to search

There are a number of options available to you. Select the one that best suits your situation.

First of all, you don't need to go through the installer UI again, although you're free to do so. Since the primary purpose of the installer is to provide fully configured Obsidian artifacts and your environment would already be configured, you really just need the updated artifacts (libraries and WAR files).

Automated Installer File

This section applies if you have saved an automated installer XML file from a previous version of Obsidian.

If the release notes do not document any installer incompatibility between source and target releases, this means there are no new configuration options available and you can use your automated installer file without modification.

You can see installation configuration for more information, but essentially all you need to do is run java -jar Obsidian-Install-n-n-n.jar my-obsidian-install-config.xml. You may wish to change the target installation path before proceeding.

If the release notes do document installer incompatibility between releases, follow the relevant instructions to update your installer configuration file and then follow the same procedure.

Existing Configuration

You have a choice when it comes to upgrading an Obsidian environment that is already configured.

  1. You can rerun the installer UI to get the configured artifacts.
  2. Use the quickstart installation mode to get the updated artifacts with the quickstart configuration.

Existing Configuration wiht QuickStart

If you are using overrides support to specify ALL your configuration items, you likely are ready to go as the default configuration items are being overridden.

Otherwise, you are relying at least partially on embedded configuration items. You will need to replace the quickstart configuration values with your existing configuration values. The Obsidian WAR files have the com.carfey.properties file inside at WEB-INF/classes/com.carfey.properties and the standalone installation has it at the root of obsidian-props.jar.