Skip Navigation Links.
MISSING BANNER
Download Center >> Upgrade Instructions

Upgrade to Version 4.11.0 from 4.10.2

 

For a test site running on your machine, you can certainly run the Installer MSI, which will perform an in-place upgrade for you. However, for production sites, I would recommend following the steps below. The first step the MSI runs during the upgrade is a removal of the previous version, and I do not feel comfortable doing that to the instances that I have running in production.

These instructions are specific to upgrading SobekCM from version 4.10.2 to version 4.11.0.  

Preparing for your Upgrade

Before you embark in the upgrade, you should prepare by looking at the steps below. This includes:

  1. Download and unzip the upgrade package at: http://sobekrepository.org/software/download
  2. Once you are ready to do the upgrade, stop your builder service from running
  3. Perform a backup on your SQL database
  4. Backup the following folders from your web:
    • Files in the main web folder
    • bin subfolder
    • config subfolder
    • default subfolder
  5. You may also want to backup your builder application, since this version includes changes to that.
  6. Ensure you have .NET Framework 4.5.2 installed on all the necessary machines ( builder and web ) since this version upgrades to 4.5.2.  The previous version used .NET Framework 4.5.0.

Performing the Upgrade

The upgrade process for this version is standard and is essentially used for all SobekCM upgrades, except for one existing configuration file that you will need to delete.

  1. Stop your SobekCM Builder from running.  There is no reason to have your builder confused or trying to build files mid-versions.
  2. Upgrade your database instance by running the SQL upgrade script against your database.  This will bring your database up to the latest version (4.11.0).
  3. Upgrade the web application:
    • Copy over all the files from the WEB folder in the upgrade package.
    • Test the web application as it should function correctly now.
  4. Upgrade and restart the SobekCM Builder:
    • On the builder server, copy the files from the Builder folder and overlay your existing files.
    • Restart the builder

Installing and Configuring the new Solr/Lucene Indexes

The new version can run on the old solr/lucene indexes, but you will want to switch to the new indexes as soon as possible.    The new version uses a much newer version of solr/lucene and a completely new schema.

On the machine that will house your solr/lucene indexes:

  1. Solr Executable
    1. Install a recent version of Java Development Kit ( I used the latest build on version 8 )
    2. Download a recent version of solr/lucene.  It must be at least version 7.1.0.  You should be able to use any version 7.1.0 or newer though.
    3. The new version uses Jetty rather than Tomcat, so it can be put anywhere on you system.  I generally put it directly under the root drive ( like C:\solr-7.1.0, but you can put it anywhere convenient)
    4. Test solr by navigating to the bin directory under the solr directory in admin command prompt and typing 'solr start'
    5. Then you should be able to open a browser to http://localhost:8983 and see the solr admin screen.
  2. SobekCM Configuration and Data folders
  3. Building the new Index

 

Previous Version Upgrade Information

Below is information for upgrading to previous versions.

If you are needing to make a large jump in version, you may need to read each individual step upgrade below.