upsilon-web Quickstart

From Upsilon Project
Jump to: navigation, search

Dialog-warning.png Warning: upsilon-web is still very much alpha-quality software. It is getting the most development focus now, as we move to a more modern AJAX driven interface. If you have issues, please raise them on GitHub.

Quickstart (upsilon-web)

Installation

Most shared hosts will have all the necessary packages to install upsilon-web. If you are installing upsilon-web on a machine that you have root access to, then you may need to install the dependencies listed below for your operating system.

Dependencies

Fedora16.png Fedora, Rhel16.png RHEL, etc

<pre<noinclude></noinclude>>user@host$: sudo yum install httpd php php-cgi php-pdo php-mysql mysql-server tar unzip </pre<noinclude></noinclude>>

Debian16.png Debian, Ubuntu16.png Ubuntu, etc

<pre<noinclude></noinclude>>user@host$: apt-get install apache2 libapache2-mod-php5 mysql-server php5-mysql tar unzip </pre<noinclude></noinclude>>

Start the Web and MySQL Server

Fedora16.png Fedora, Rhel16.png RHEL, etc

<pre<noinclude></noinclude>> user@host$: chkconfig httpd on && service httpd start user@host$: chkconfig mysqld on && service mysqld start </pre<noinclude></noinclude>>

Debian16.png Debian, Ubuntu16.png Ubuntu, etc

<pre<noinclude></noinclude>> user@host$: service apache2 start user@host$: service mysqld start </pre<noinclude></noinclude>>

Unzip the upsilon-web .tar.gz file

Now we need to download the archive that contains upsilon-web, and "unzip" it into the /var/www/ directory, or similar.

<pre<noinclude></noinclude>> user@host$: cd /var/www/html # or /var/www/ if this is all you have user@host$: wget http://upsilon-project.co.uk/releases/upsilon-web-tgz/upsilon-web-1.4.0.tar.gz user@host$: tar xavf upsilon-web-1.4.0.tar.gz </pre<noinclude></noinclude>>

Dialog-information.png Note: If you are on shared hosting, then you can downlaod the .tar.gz file to your desktop computer, extract it, and just upload the "upload" directory to the remote server.

Setup the databases

You need to import setup/schema.sql and setup/initialData.sql.

Dialog-warning.png Warning: The importDb.sh is intended for developers, but can by used the first time you install upsilon-web. It will drop any existing databases called "upsilon" and will therefore destroy existing data.

If you have access to a shell prompt, you can run the following;

<pre<noinclude></noinclude>> user@host$: mysql -u root -p -e 'CREATE DATABASE upsilon' user@host$: mysql -u root -p upsilon < schema.sql user@host$: mysql -u root -p upsilon < initialData.sql </pre<noinclude></noinclude>>

Now create a unprivileged database user;

user@host$: mysql -e "GRANT ALL PRIVILEGES ON upsilon.* TO 'upsilon'@'localhost' IDENTIFIED BY 'databasepasswordforsqluser'"

You can do this also using tools my phpMyAdmin.

Run the web installer

Navigate to http://example.com/upsilon-web-1.4.0/upload/ in your browser.

Dialog-information.png Note: If you get a HTTP 403 (Forbidden) then it probably means your webserver does not have permissions on the files inside upsilon-web. Note that if your system is running SELinux then your SELinux context is most likely wrong on the files. Try this;

user@host$: restorecon -Rvv /var/www/

Take the tour!

Once all installed, you can take the upsilon-web tour!