Updates for ]project-open[ 3.x / 4.x

• Linux: Update von 4.0.x to the most recent version­
• Linux: Update from 3.­2.x to 3.5.x­
• Windows: Update from 3.­2.x ­to 3.5.x­
• ­­Update from 3.1. to 3.x.
• Troubleshooting cvs issues on linux
  
  
• How to get get version 4.0 (alpha)
• Update your ]po[ VM to version 4.0 (DEVELOPER ONLY)
  

Linux: Update von 4.0.x to the most recent version

Please follow LINUX:Update fro­m 3.2.x to 3.5.x (stable) - Step by Step instructions but update from CVS HEAD: csv update -dPA instead from stable branch b3-5-0-patches as described below. Please note that you'll update from the "cutting edge" version until we have released a stable branch, so you should better know what you do!

LINUX: Update fro­m 3.2.x to 3.5.x (stable) - Step by Step instructions­

Updating your system requires a connection to our CVS server. If you are behind a firewall, make sure that TCP port 2401 is open and follow the steps as described underneath:
 
a) Run a database backup  
 
http://[YOUR_SERVER]/intranet/admin/backup/
 
b) Make a backup of the /web/projop/packages folder:  

Use putty to open a SSH console to your server/virtual machine (default user: root, default password: root)
In order to monitor cvs output make sure that in the putty configuration attribute "Window - Lines of scroll back" has a value of at least 10000.

cp -r /web/projop/packages /web/projop/packages.backup

su - projop

cd /web/projop/packages/

cvs login (no password - just 'enter')

cvs update -r b3-5-0-patches 

Monitor the output and watch for CVS conflicts, indicated with a 'C' at the beginning of a line. Conflicts usually happen only when local code had been changed.
Conflicts not resolved will lead to a malfunctioning system so please watch the output carefully.

f) Use the packet manager in the ADMIN section to update your modules and follow instructions given on the update pages:  
 
    http://[YOUR_SERVER]/acs-admin/apm/packages-install?update_only_p=1 
 
g) Restart your system

    http://[YOUR_SERVER]/acs-admin/server-restart  
 
h) Wait a moment until the server is up and running again and go to your 'home'

    http://[YOUR_SERVER]/intranet/ 

Windows: Update fro­m 3.2.x to 3.5­.x - Step by Step instructions­

Probably the easiest way to manually update the WIN version of ]po[ is using the Open Source tool TortoiseCVS which ­is available for download from their website.
After installation, new items are added to the context menu (right mouse click) of the Windows File Manager.

Now you can update your server using TurtoiseCVS:

a) Run a database backup  
http://localhost:8000/intranet/admin/backup/
 
b) Make a security copy of the packages folder.
Default location is C:/project-open/servers/projop/packages/

c) Use TurtoiseCVS to update all packages 
Open a WINDOWS File Manager and navigate to your "packages" folder. Mark all directories this folder contains, right-click on the selection and choose CVS update Special  from the context menu and select branch 'b3-5-0-patches' . 

Monitor the output and watch for CVS conflicts that are indicated with a 'C' at the beginning of a line. Conflicts usually occur only when local code had been changed.
Conflicts not resolved will lead to a malfunctioning system so please watch the output carefully. In case you have done some local changes to the application you can resolve those conflicts manually.

If TurtoiseCVS indicates conflicts even though you have not done any changes to the code,  look at the messages and follow the instructions given there.
In many cases deleting the affected files and repeat the CVS update should resolve the issue.

d)  Run update scripts
If you log on to ]po[ as a System Administrator you should find on home (http://localhost:8000/intranet/) a portlet listing update scripts to be executed:  

Alternativiley use the packet manager in the ADMIN section to update your modules and follow instructions given by the ]po[/OpenACS Update Wizard:  
 
    http://localhost:8000/acs-admin/apm/packages-install?update_only_p=1 
 

e) Restart your system

    http://localhost:8000/acs-admin/server-restart  
 
Wait a moment until the server is up and running again and go to your 'home' http://localhost:8000/intranet/
[Please note that in some WIN versions you might need to stop/start the web server manually using the scripts accessible through the Windows START (]project-open[/ Stop ]project-open[ / Start ]project-open[) menu.]
 

Updates from 3.1.x 

This particular upgrade can only be done semi-automatically because we had to make some adjustments to basic 'pillars' of the application in order to prepare ]po[ better for future requirements such as the integration of leading ERP systems. Please search the forum for information about the steps involved. Thomas Wabner reported a successful update from 3.1 to the VM3.2 and posted the steps involved on ­his blog . In case you want us to help you with this update please get in touch with us.

Troubleshooting cvs issues on linux

In case cvs updates do not perform as expected please check the following: 

1) Check availability of CVS server:

ping berlin.dnsalias.com

2) Check /etc/hosts

Some older ]po[ VM's have an entry to a local IP for berlin.dnsalias.com Please delete this entry.

3) Check if you can connect to the cvs server:

su - projop
­cvs login

Logging in to :pserver:anonymous@berlin.dnsalias.com:2401/home/cvsroot
CVS password:

cd /web/projop/packages/intranet-core/
cvs status intranet-core.info

===================================================================
File: intranet-core.info        Status: Needs Patch

   Working revision:    1.104
   Repository revision: 1.108   /home/cvsroot/intranet-core/intranet-core.info,v
   Sticky Tag:          (none)
   Sticky Date:         (none)
   Sticky Options:      (none)

4) CVS server busy?

In case everything worked fine, a cvs update might time out due to to maxim number of allowed to connections. Please try to run the update at a later point in time again.