.. _upgrade:

=======

Upgrade

=======

Upgrading from PyPI (aka "Cheeseshop")

---------------------------------------

.. note::

   Firstly, it is recommended that you **always** perform a database and

   configuration backup before doing an upgrade.

   (These directions will use '{version}' to note that this is the version of

   Rhodecode that these files were used with.  If backing up your RhodeCode

   instance from version 1.3.6 to 1.4.0, the ``production.ini`` file would be

   backed up to ``production.ini.1-3-6``.)

If using a sqlite database, stop the Rhodecode process/daemon/service, and

then make a copy of the database file::

 cp rhodecode.db rhodecode.db.{version}

Back up your configuration file::

 cp production.ini production.ini.{version}

Ensure that you are using the Python Virtual Environment that you'd originally

installed Rhodecode in::

 pip freeze

will list all packages installed in the current environment.  If Rhodecode

isn't listed, change virtual environments to your venv location::

 source /opt/rhodecode-venv/bin/activate

Once you have verified the environment you can upgrade ``Rhodecode`` with::

 easy_install -U rhodecode

Or::

The final step is to upgrade the database. To do this simply run::

 paster upgrade-db production.ini

This will upgrade the schema and update some of the defaults in the database,

and will always recheck the settings of the application, if there are no new

options that need to be set.

.. note::

   DB schema upgrade library has some limitations and can sometimes fail if you try to

   upgrade from older major releases. In such case simply run upgrades sequentially, eg.

   upgrading from 1.2.X to 1.5.X should be done like that: 1.2.X. > 1.3.X > 1.4.X > 1.5.X

   You can always specify what version of RhodeCode you want to install for example in pip

   `pip install RhodeCode==1.3.6`

You may find it helpful to clear out your log file so that new errors are

readily apparent::

 echo > rhodecode.log

Once that is complete, you may now start your upgraded Rhodecode Instance::

Or::

 paster serve /var/www/rhodecode/production.ini

.. note::

   If you're using Celery, make sure you restart all instances of it after

   upgrade.

.. _virtualenv: http://pypi.python.org/pypi/virtualenv

.. _python: http://www.python.org/

.. _mercurial: http://mercurial.selenic.com/

.. _celery: http://celeryproject.org/

.. _rabbitmq: http://www.rabbitmq.com/

# Change variables/paths as necessary and place file /etc/init/celeryd.conf

# start/stop/restart as normal upstart job (ie: $ start celeryd)

description	"Celery for RhodeCode Mercurial Server"

author		"Matt Zuba <matt.zuba@goodwillaz.org"

respawn

umask 0022

env PIDFILE=/tmp/celeryd.pid

env HOME=/var/hg

env USER=hg

# To use group (if different from user), you must edit sudoers file and change

# root's entry from (ALL) to (ALL:ALL)

# env GROUP=hg

script

    if [ -z "$GROUP" ]; then

        exec sudo -u $USER $COMMAND

    else

        exec sudo -u $USER -g $GROUP $COMMAND

    fi

end script

post-stop script

    rm -f $PIDFILE

end script

#!/bin/bash

###########################################

#### THIS IS AN ARCH LINUX RC.D SCRIPT ####

###########################################

. /etc/rc.conf

. /etc/rc.d/functions

APP_HOMEDIR="/srv"

APP_PATH="$APP_HOMEDIR/$DAEMON"

CONF_NAME="production.ini"

LOG_FILE="/var/log/$DAEMON.log"

PID_FILE="/run/daemons/$DAEMON"

APPL=/usr/bin/paster

RUN_AS="*****"

ARGS="serve --daemon \

--user=$RUN_AS \

--group=$RUN_AS \

--pid-file=$PID_FILE \

--log-file=$LOG_FILE \

$APP_PATH/$CONF_NAME"

[ -r /etc/conf.d/$DAEMON ] && . /etc/conf.d/$DAEMON

if [[ -r $PID_FILE ]]; then

    read -r PID < "$PID_FILE"

    if [[ $PID && ! -d /proc/$PID ]]; then

        unset PID

        rm_daemon $DAEMON

    fi

fi

#!/bin/sh -e

########################################

#### THIS IS A DEBIAN INIT.D SCRIPT ####

########################################

### BEGIN INIT INFO

# Required-Start:    $all

# Required-Stop:     $all

# Default-Start:     2 3 4 5

# Default-Stop:      0 1 6

### END INIT INFO

APP_HOMEDIR="opt"

APP_PATH="/$APP_HOMEDIR/$APP_NAME"

CONF_NAME="production.ini"

PID_PATH="$APP_PATH/$APP_NAME.pid"

LOG_PATH="$APP_PATH/$APP_NAME.log"

PYTHON_PATH="/$APP_HOMEDIR/$APP_NAME-venv"

RUN_AS="root"

DAEMON="$PYTHON_PATH/bin/paster"

DAEMON_OPTS="serve --daemon \

 --user=$RUN_AS \

 --group=$RUN_AS \

 --pid-file=$PID_PATH \

 --log-file=$LOG_PATH  $APP_PATH/$CONF_NAME"

start() {

  echo "Starting $APP_NAME"

  PYTHON_EGG_CACHE="/tmp" start-stop-daemon -d $APP_PATH \

#!/sbin/runscript

########################################

#### THIS IS AN GENTOO INIT.D SCRIPT####

########################################

APP_PATH="/home/$APP_HOMEDIR/$APP_NAME"

CONF_NAME="production.ini"

PID_PATH="$APP_PATH/$APP_NAME.pid"

LOG_PATH="$APP_PATH/$APP_NAME.log"

PYTHON_PATH="/home/$APP_HOMEDIR/v-env"

DAEMON="$PYTHON_PATH/bin/paster"

DAEMON_OPTS="serve --daemon \

--user=$RUN_AS \

--group=$RUN_AS \

--pid-file=$PID_PATH \

--log-file=$LOG_PATH  $APP_PATH/$CONF_NAME"

#extra options

opts="${opts} restartdelay"

depend() {

    need nginx

}

start() {

    ebegin "Starting $APP_NAME"

    start-stop-daemon -d $APP_PATH -e PYTHON_EGG_CACHE="/tmp" \

        --start --quiet \

        --pidfile $PID_PATH \

        --user $RUN_AS \

        --exec $DAEMON -- $DAEMON_OPTS

    eend $?

#!/bin/sh

########################################

#### THIS IS A REDHAT INIT.D SCRIPT ####

########################################

##################################################

#

# RhodeCode server startup script

# Recommended default-startup: 2 3 4 5

# Recommended default-stop: 0 1 6

#

##################################################

# the location of your app

# since this is a web app, it should go in /var/www

APP_PATH="/var/www/$APP_NAME"

CONF_NAME="production.ini"

# write to wherever the PID should be stored, just ensure

# that the user you run paster as has the appropriate permissions

# same goes for the log file

# replace this with the path to the virtual environment you

# made for RhodeCode

DAEMON="$PYTHON_PATH/bin/paster"

DAEMON_OPTS="serve --daemon \

    --user=$RUN_AS \

    --group=$RUN_AS \

    --pid-file=$PID_PATH \

    --log-file=$LOG_PATH $APP_PATH/$CONF_NAME"

LOCK_FILE="/var/lock/subsys/$APP_NAME"

# source CentOS init functions

. /etc/init.d/functions

RETVAL=0

remove_pid () {

  rm -f ${PID_PATH}

  rmdir `dirname ${PID_PATH}`

}

ensure_pid_dir () {

  PID_DIR=`dirname ${PID_PATH}`

  if [ ! -d ${PID_DIR} ] ; then

    mkdir -p ${PID_DIR}

    chown -R ${RUN_AS}:${RUN_AS} ${PID_DIR}

    chmod 755 ${PID_DIR}

  fi

}

    ensure_pid_dir

    PYTHON_EGG_CACHE="/tmp" daemon --pidfile $PID_PATH \

        --user $RUN_AS "$DAEMON $DAEMON_OPTS"

    RETVAL=$?

    [ $RETVAL -eq 0 ] && touch $LOCK_FILE

    return $RETVAL

}

    if [ -e $LOCK_FILE ]; then

      killproc -p $PID_PATH

      RETVAL=$?

      rm -f $LOCK_FILE

      rm -f $PID_PATH

    else

      RETVAL=1

    fi

    return $RETVAL

}

  if [ -e $LOCK_FILE ]; then

    # exit with non-zero to indicate failure

    RETVAL=1

  else

    RETVAL=0

  fi

  return $RETVAL

}

    RETVAL=$?

}

case "$1" in

  start)

    echo -n $"Starting $DESC: "

    echo

    ;;

  stop)

    echo -n $"Stopping $DESC: "

    echo

    ;;

  status)

    RETVAL=$?

    if [ ! $RETVAL -eq 0 ]; then

      echo "RhodeCode server is running..."

    else

      echo "RhodeCode server is stopped."

    fi

    ;;

  restart)

    echo -n $"Restarting $DESC: "

    echo

    ;;

  *)

    echo $"Usage: $0 {start|stop|restart|status}"

    RETVAL=1

    ;;

esac

exit $RETVAL

description	"RhodeCode Mercurial Server"

author		"Matt Zuba <matt.zuba@goodwillaz.org"

start on (local-filesystems and runlevel [2345])

stop on runlevel [!2345]

respawn

umask 0022

env HOME=/var/hg

env USER=hg

env GROUP=hg

post-stop script

	rm -f $PIDFILE

end script

; RhodeCode Supervisord

; ##########################

; for help see http://supervisord.org/configuration.html

; ##########################

[inet_http_server]         ; inet (TCP) server disabled by default

port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for all iface)

;username=user              ; (default is no username (open server))

;password=123               ; (default is no password (open server))

[supervisord]

logfile_maxbytes=50MB        ; (max main logfile bytes b4 rotation;default 50MB)

logfile_backups=10           ; (num of main logfile rotation backups;default 10)

loglevel=info                ; (log level;default info; others: debug,warn,trace)

nodaemon=true               ; (start in foreground if true;default false)

minfds=1024                  ; (min. avail startup file descriptors;default 1024)

minprocs=200                 ; (min. avail process descriptors;default 200)

umask=022                    ; (process file creation umask;default 022)

;identifier=supervisor       ; (supervisord identifier, default is 'supervisor')

;directory=/tmp              ; (default is not to cd during start)

;nocleanup=true              ; (don't clean up tempfiles at start;default false)

;childlogdir=/tmp            ; ('AUTO' child log dir, default $TEMP)

;strip_ansi=false            ; (strip ansi escape codes in logs; def. false)

; the below section must remain in the config file for RPC

; (supervisorctl/web interface) to work, additional interfaces may be

; added by defining them in separate rpcinterface: sections

[rpcinterface:supervisor]

supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]

serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket

;username=user               ; should be same as http_username if set

;password=123                ; should be same as http_password if set

;prompt=mysupervisor         ; cmd line prompt (default "supervisor")

;history_file=~/.sc_history  ; use readline history if available

numprocs = 1

numprocs_start = 5000 # possible should match ports

process_name = %(program_name)s_%(process_num)04d

redirect_stderr=true