dotCMS - Open Source Content Management System, Ondemand CMS, and Professional Support

Upgrading dotCMS

1. Backup your dotCMS directory and database. Make sure you get good backups :)

2. Download the latest dotCMS and unzip it.

3. From your older dotCMS copy the dotCMS/assets directory to the newer dotCMS /dotCMS/
    Note: If you have changed where your assets live use your altered assets directory.

4. If you have changed velocity files or jsps on the filesystem you will also need to move them.  If you don't
    know what these are then you probably haven't.  

    Note: If you have changed any language properties copy the file under /common/ext-ejb/content/*

    Note: From a version prior to 1.7a you need to move your reports directory also.

5. Time to tell the new dotCMS where your database is.  
    Uncomment the database you are using in the config (ROOT.xml).    
    
    You will need to update the last part of the URL to your database name along with username:password.
    The following is an example of a postgres config pointing to a database named dotcms

    <!-- POSTGRESQL -->
    <Resource name="jdbc/dotCMSPool" auth="Container"
          type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
          url="jdbc:postgresql://127.0.0.1/dotcms"
          username="postgres" password="xxxxx" maxActive="50" maxIdle="10" maxWait="-1"
          removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true"/>

6. Check your setting in conf/server.xml are correct.
    This file is all new. Make sure that ip, ports, settings and ssl are all configured
    correctly (configuring Tomcat is outside the scope of this document).
    By default dotCMS will automatically run on localhost. If you need
    the dotCMS to run on a particular IP address, edit the ./conf/server.xml file and search
    the connector and server tags and add the address property on both. E.G.
    
    <Server address="208.250.1.102" port="8005" shutdown="SHUTDOWN" debug="0">
    ...
     <Resource name="jdbc/dotCMSPool" auth="Container"
          type="javax.sql.DataSource" driverClassName="org.postgresql.Driver"
          url="jdbc:postgresql://localhost/dotcms"
          username="postgres" password="xxxxx" maxActive="60" maxIdle="10" maxWait="60000"
          removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true"
          testOnBorrow="true" validationQuery="SELECT 1"/>
                  
7. If you are on a UNIX box, change the /bin scripts permissions,
    add execution permission to *.sh in the bin dir.
    > cd /wwwroot/test.dotcms.org/bin
    > chmod 755 *.sh

8. Start your dotCMS using bin/startup.bat or bin/startup.sh depending on whether on UNIX or Windows.

9. Log into the dotCMS as an admin and goto CMS Maintenance usually under CMS Admin tab and do the following.
    1. Execute Fix Asset Inconsistencies
    2. Reindex all structures  
    
10. Enjoy!  If you run into issues, please report them to us here: http://jira.dotmarketing.net/browse/DOTCMS