An open source web application meant to help manage & create invoices in a simple, straightforward way.

Upgrade guide

Requirements

  • Siwapp >= 0.3 installed on your system..

Find out which upgrade package you need

Upgrades are only from one version to the very next. If you want to upgrade from siwapp 0.3 to siwapp 0.3.4, you should do it step by step, you should repeat the process described here for 0.3 to 0.3.1, 0.3.1 to 0.3.2, 0.3.2 to 0.3.3 and 0.3.3 to 0.3.4

PS: If you’re going to go for the A) method (described below), you don’t need to do the upgrades incrementally.

Get your upgrade package

  • Go here and get the tar.gz or zip package that corresponds to the upgrade you want to do.
  • Decompress it, and get ready for some uploading

Put everything in its place

Here comes the tricky part. Depending on how many files the upgrade modifies, it may get painful. You have three ways of doing this:

A). The quickest and riskiest: upload the whole application and readapt it to your system.

This one doesn’t need to be incremental. You can jump straight to the newest version from your old one. (provided, as said in the requirements, that you have a siwapp >= 0.3).

PS: If you hacked somehow your siwapp system, those hacks shall be lost after the upgrading.

  • Save your web/config.php and your config/databases.yml files someplace safe.
  • Upload the whole siwapp application again (not the upgrade package, but the whole app
  • Deploy it in your system.
  • Substitute the app’s default config/databases.yml and web/config.php by your own.
  • Beware of file permissions, as specified in the installation guide
  • There you go!!!

B). If you have shell access:

  • upload the tar.gz or .zip upgrade package to your siwapp root location. This is the place in your server’s file structure where the siwapp folders are. Here you’ll find the list of siwapp folders.
  • uncompress the package. It should put every upgrade file in its right place. Watch out for the web folder contents, since your ‘web’ folder may have another name. see siwapp deployment instructions for more on this

C). If you have a decent ftp client

  • uncompress your upgrade package to some folder in your local computer
  • fire up your ftp program and point it to  your siwapp root location on your server.
  • select – in your ftp client – all the contents of the local folder you uncompressed the siwapp upgrade package to.
  • upload it. the ftp program should take care of putting and replacing every needed file at your server.

D). The super-safe, super-tedious way

  • Upload the contents of each of the main folders of your decompressed upgrade package into its counterparts on your siwapp installation, replacing old files with the new ones from the upgrade package.
  • Beware the “web” folder in your upgrade package, its counterpart on your server may have a different name. See the siwapp deployment strategies section for more info on this.

Run the upgrader application

Given that you access your siwapp app at http://myhosting.com/path/to/siwapp/, point your browser to:

http://myhosting.com/path/to/siwapp/installer.php/upgrade

The system will upgrade your app and inform you accordingly

Last details:

  • Log out the application. Some of the new features may require you to re-login to be enabled
  • Clean the cache Remove all the contents of the “cache” folder in your server
  • Re-login

An example: 0.3.3 to 0.3.4

  • Say you access your siwapp app at http://myhosting.com/billing/
  • Say your siwapp root directory is in /home/joe/siwapp/
  • Get the upgrade package : siwapp_upgrade_0_3_3_to_0_3_4.tar.gz
  • If you’re going for the B) method:
    • upload your tar.gz file to /home/joe/siwapp/
    • open up a shell at your servers and:
    • yourserver$ cd /home/joe/siwapp/
    • yourserver$ tar -xzvf siwapp_upgrade_0_3_3_to_0_3_4.tar.gz
  • If you’re going for the C) method:
    • decompress your tar.gz file you a local folder. say “upgrade_package_folder”
    • fire up your ftp and upload all the contents of “upgrade_package_folder” to the directory /home/joe/siwapp in your server
  • If you’re playing it safe:
    • Decompress it: you should get these files and folder structure:
      • apps/siwapp/config/app.yml
      • lib/EmailMessages.php
      • lib/model/doctrine/CustomerTable.class.php
  • replace your server’s apps/siwapp/config/app.yml for the one that comes in the package
  • replace your server’s lib/EmailMessages.php for the one that comes in the package
  • replace your server’s lib/model/doctrine/CustomerTable.class.php for the one that comes in the package
  • Point your browser to http://myhosting.com/billing/installer.php/upgrade
  • you’re done
  • That’s it. Enjoy!