doc/migration.txt

   1 Migration to version 0.97.0
   2 ===========================
   3
   4
   5 Migration to version 0.96.2
   6 ===========================
   7
   8 # install pytz:
   9
  10     * package: http://sourceforge.net/projects/pytz
  11     * howto install: http://pytz.sourceforge.net
  12
  13 # install simplejson:
  14
  15     * package: http://pypi.python.org/pypi/simplejson/
  16     * installation tips:
  17           o ungzip and untar the package
  18           o sudo python setup.py bdist_egg
  19           o if you have easy_install: sudo easy_install -UZ simplejsonXXXXX.egg
  20           o if you DO NOT have easy_install: unzip the egg file (actually it is a zip file) and copy the folder simplejson in your python/lib/site-packages folder
  21
  22 # run script tools/TZMigration.py (NOTE: firstly you have to install Indico package and then run this script)
  23
  24     * You must stop the Apache server while running the script because user interaction with Indico could cause inconsistencies. Indico migration at CERN took ~4 hours
  25     * You will be asked to provide the category timezones file. You, as Indico admin, have to create this file in order to choose which timezone will be set to each of your categories. The file must have 2 columns (separated by 1 tab), the first one will contain the ID for each Indico category and the second one is the TZ for the corresponding category. Please, see an example at http://cdsware/indico/download/categories-timezones.txt.
  26     * A complete list of timezone codes can be found at http://cdsware/indico/download/timezone-codes.txt
  27     * On the other hand, if you do not want to create the categories timezones file, you can provide an empty file as parameter. The script will add the categories to your server timezone (default timezone). And afterwards, you will be able to change the TZ for each category by hand.
  28
  29
  30 Migration to version 0.96.0
  31 ===========================
  32
  33 You just have to run the script:
  34
  35 /tools/check_conflict_description_content.py
  36
  37
  38 Migration to version 0.94
  39 =========================
  40
  41 To update from 0.94 and previous versions, you must run the following script before installation:
  42
  43     * tools/check_conflict_description_content.py
  44
  45
  46 Migration to version 0.92.2
  47 ===========================
  48
  49 run the following scripts:
  50
  51     * tools/updateAC.py
  52     * tools/pendingsMigration.py
  53
  54
  55 Migration to version 0.90.3
  56 ===========================
  57
  58 To upgrade from 0.90.3 and previous versions:
  59
  60     * if you want to use the new html cache feature make sure the XMLCacheDir in config.xml is set to a path which is writable by the http server. Else, disable the cache by going to the "Admin" "Main" page.
  61     * PIL is now mandatory
  62     * reportlab version must be 2.0
  63     * run the following script:
  64           o tools/indexes/reindexcalendars.py
  65           o tools/indexes/reindexcategories.py
  66           o tools/indexes/reindexOAIModificationDates.py (only needed if you use the OAI gateway)
  67
  68
  69
  70 Migration to version 0.90.0
  71 ===========================
  72
  73 INSTALLATION:
  74
  75 To update from version 0.8.14 and below to 0.90.0 an above.
  76     Update Avatar object: run "userIdentityMigration0.8.14To0.8.15.py"
  77
  78 To upgrade from version 0.8.14 and previous, you must run the script "Tools/Migration0.8.14To0.90.0.py" after the upgrade
  79
  80
  81 Migration to version 0.8
  82 ==========================
  83
  84 INSTALLATION:
  85
  86 1) run "rectifySubContArchiveHierarchy.py"
  87 2) run "indexes/reindex*.py"
  88 3) clean up the tasks (in order to launch the taskDaemon):
  89
  90 from MaKaC.common import DBMgr
  91 DBMgr.getInstance().startRequest()
  92 from MaKaC.common.timerExec import HelperTaskList
  93 taskList = HelperTaskList().getTaskListInstance()
  94 taskList.listTask={}
  95 taskList._p_changed=1
  96 DBMgr.getInstance().endRequest()
  97 DBMgr.getInstance().startRequest()
  98 taskList = HelperTaskList().getTaskListInstance()
  99 taskList.getTasks()
 100
 101 4) run task daemon!
 102
 103
 104 Migration to version 0.6
 105 ==========================
 106
 107 PRE-INSTALLATION:
 108
 109 0)Write down owner:group of "htdocs" (e.g. root:root)
 110 1)Move "htdocs" to "htdocs-bk"
 111 2)Create new "htdocs" folder
 112 3)Set owner:group to "htdocs"
 113 4)Create a fake "index.py"
 114 5)Restart apache & ZODB
 115
 116 INSTALLATION:
 117
 118 1)Make a copy of the DB
 119 2)Make a backup of all the site-packages folder
 120 3)Run the script: newremoveIC.py
 121 4)Install ZODB-3.3:
 122    4.1)Stop DB
 123    4.2)Remove 3.2 (from site-packages):
 124         - BDBStorage
 125         - BTrees
 126         - Persistence
 127         - ThreadedAsync
 128         - ZConfig
 129         - ZEO
 130         - ZODB
 131         - ZopeUndo
 132         - zLOG
 133         - zdaemon
 134     4.3)Install 3.3 <http://indico.cern.ch/dist/ZODB3-3.3.tgz>:
 135         % python setup.py build
 136         % python test.py
 137         % python setup.py install
 138     4.4)Start Database
 139 5)Remove "MaKaC" from site-packages
 140 6)Install Indico.0.6.0
 141 7)Remove "IndexedCatalog" from site-packages
 142 8)Run chdatetime.py
 143 9)Run:
 144     reindexcalendars.py
 145     reindexcategories.py
 146     reindexusers.py
 147 10)Remove "mx" lib from site-packages
 148 11)Restart apache
 149
 150
 151 Migration to version 0.4.13
 152 ==========================
 153 1) Run tools/setSubmissionPrivileges.py
 154
 155
 156 Migration to version 0.4.X
 157 ==========================
 158
 159 To successfully upgrade an Indico system running a version 0.2.X to a version 0.4.X:
 160
 161 Note that the sessions in the scheduled won't be migrated so please do remove them before
 162 following the steps.
 163
 164 1) Install the new 0.4.X IndiCo distribution
 165 2) Run tools/contribTypeConverter.py
 166 3) Run tools/syncContribCounters.py
 167 4) Run tools/migrateContribs.py
 168 5) Run tools/createContribsFromAbstracts.py
 169 6) Run tools/resetDisplayMgrs.py
 170
 171 that should be enough