Project

General

Profile

How to Update from v16 (Microscope Windows Computer) » History » Version 3

Anchi Cheng, 05/18/2010 10:16 PM

1 1 Anchi Cheng
h1. How to Update from v16 (Window)
2
3 3 Anchi Cheng
The changes from v1.6 requires update of all in-house components of Leginon, dbemtools and database but not the php-mrctools. 
4 2 Anchi Cheng
Don't forget that you need to also update the packages on the microscope-controlling computer
5
since the pyScope update need to be synchronized.
6 1 Anchi Cheng
7 2 Anchi Cheng
See [[Installation Troubleshooting]] and  "Leginon Bulletin Board":http://emg.nysbc.org/bb/viewforum.php?f=2  searching
8 1 Anchi Cheng
for "install" if you run into problems.
9
10
h2. Packages required from NRAMM
11
12 2 Anchi Cheng
All Leginon (and Appion) packages distributed from NRAMM are now under one svn control.
13
14
A few updates are needed for preparation of python 3.0 compatibility where the method for importing module is changed.  They will still run under python 2.4 and up.
15 1 Anchi Cheng
Here are the packages you need to install with python installer
16
17 2 Anchi Cheng
|_.SVN subPackage Name|_.Reason for update:|
18
|numextension|package import method change|
19
|libcv|package import method change|
20
|leginon|new features|
21
|pyami|new features|
22
|sinedon|required for updating database|
23
|pyscope|new method for creating pythoncom modules|
24
|imageviewer|debug|
25 1 Anchi Cheng
26 2 Anchi Cheng
Because numextension and libcv requires extra compiler, we have created
27
window installer for them for python 2.5 and made them available through "http://www.leginon.org/":http://www.leginon.org/
28 1 Anchi Cheng
29 2 Anchi Cheng
h2. Check out SVN Source Files from the depository
30 1 Anchi Cheng
31 2 Anchi Cheng
Assuming that you have installed some kind of svn client such as TortoiseSVN "http://tortoisesvn.tigris.org/", you can use your mouse to do the following
32
*Create Leginon2.0 directory somewhere at your convenience
33
*Change directory into Leginon2.0
34
*Right-click the mouse botton in this directory window and select Tortoise svn
35
Checkout in the menu:!http://emg.nysbc.org/software/leginon/images/images/svnmenu.png!
36
*Set up svn checkout window like this, but check out from http://emg.nysbc.org/svn/myami/trunk and save it to Leginon2.0 folder !http://emg.nysbc.org/software/leginon/images/images/svnco.png!
37
38
39
h2. Perform system check if you can't remember where you have installed your Leginon before.
40
41
*Go to ~/Leginon2.0/leginon
42
*Double click on syscheck.py
43
44
You should have all the supporting packages installed for v1.6. If you see any lines like "*** Failed...", then you have something missing. Otherwise, everything should result in "OK".
45
46 1 Anchi Cheng
h2. Uninstall your existing packages:
47
48
Although new installation overwrite the old in most cases, problem has been observed in
49
the past. Therefore, it is best to remove the old files before new installation.
50
51
Use "Add or Remove Programs" application in "Control Panel" to do this. Leginon related
52
packages are shown with prefix "Python 2.5"
53
54
If you didn't use Installer to install previously, the packages may not show up in the
55 2 Anchi Cheng
Programs list. Simply remove or rename the folder containing the old packages in this case.
56 1 Anchi Cheng
57 2 Anchi Cheng
h2. Move your existing packages to a backup directory:
58 1 Anchi Cheng
59 2 Anchi Cheng
At the beginning of the syscheck.py output, the location of the exisiting Leginon folder is shown. Although new installation overwrite the old in most cases, problem has been observed in the past. Therefore, it is best to remove the old files from the path before new installation.  Better yet, copy into a backup folder because we need some configuration files from them.
60 1 Anchi Cheng
61 2 Anchi Cheng
For example, your Leginon folder is at C:\\python25\Lib\site-packages\Leginon
62 1 Anchi Cheng
63 2 Anchi Cheng
<pre>Go to C\\python25\site-packages
64
Create Leginon1_6_backup folder
65
Move Leginon fold into Leginon1_6_backup folder</pre>
66 1 Anchi Cheng
67 2 Anchi Cheng
Be aware that in some cases the installed package name is different (capitalized) from your svn package name and that numextension amd libCV are not in its own subdirectory in the python library but just the compiled .so files
68 1 Anchi Cheng
69 2 Anchi Cheng
h2. Install the subpackages you downloaded from NRAMM svn depository
70
71 1 Anchi Cheng
* Start a command line Window from Start Menu
72
73
* Reinstall the package in each folder with commands such as
74 2 Anchi Cheng
<pre>cd Your_Download_Place\Leginon 2.0\leginon
75 1 Anchi Cheng
c:\\python25\python.exe setup.py install</pre>
76 2 Anchi Cheng
* run syscheck.py again to make sure you have everything.
77 1 Anchi Cheng
78 2 Anchi Cheng
h2. Copy your Leginon1.6 sinedon.cfg to the new installation
79 1 Anchi Cheng
80 2 Anchi Cheng
* Find your sinedon.cfg. Depending on your previous setting, look in the directories listed here in order:
81
*your home directory as described in syscheck.py
82
*The sinedon directory where it is called from. If unsure, start python command line and type these to find out:
83
<pre>python> import sinedon
84
python> sinedon</pre>
85 1 Anchi Cheng
86 2 Anchi Cheng
*  If sinedon.cfg reside in the installed sinedon subpackage, you should copy it from your Leginon1.6 backup to the new installation.
87
<pre>go to  C:\\python25\Lib\site-packages\
88
copy Leginon_1_6_backup\sinedon\sinedon.cfg  into the new sinedon folder
89
</pre>
90 1 Anchi Cheng
91 2 Anchi Cheng
h2. Back up all your databases
92 1 Anchi Cheng
93 2 Anchi Cheng
We will be doing a database update that is not backward compatible,  Make sure you back up all your current databases before performing the update
94 1 Anchi Cheng
95 2 Anchi Cheng
* mysqldump -u usr_object your_leginon_database > leginondb_1_6_backup_today's_date
96
* mysqldump -u usr_object your_project_database > projectdb_1_2_backup_today's_date
97
* .... do the same to any of your processing databases if you have installed and used Appion 1.0
98 1 Anchi Cheng
99 2 Anchi Cheng
h2. Install updated Web viewers and tools
100 1 Anchi Cheng
101 2 Anchi Cheng
See [[Install the Web Interface]] section in Complete Installation Chapter to put the new web tools (Now under subpackage myamiweb) to document root for the web server.  The Setup Wizard will take you through the steps to create config.php and to create and initialize values for the new tables.
102
103
h2. Run database update scripts
104
105
<pre>cd ~/Leginon2.0/dbschema
106
python schema-r12857.py
107
python schema-r13713.py
108
</pre>
109
110
The first one update UserData and GroupData so that new data viewing and processing privileges can be enforced
111
The second is a wide-scale change on database schema many on appion processing databases, and some on projectdata and leginondata.