Difference between revisions of "PartKeepr on uberspace"

From PartKeepr Wiki
Jump to: navigation, search
m
Line 1: Line 1:
uberspace is a pretty cool hosted provider. Here are some instructions to get PartKeepr running. Note that you'll need ssh access to install PEAR packages.
+
[https://www.uberspace.de Uberspace] is a pretty cool German Hosting Provider.
 
+
This article focuses on PartKeepr '''Version > 0.7x'''. For previous versions look below.
* Download partkeepr to your web root
+
=Prerequisites=
* Configure pear, add include_path, restart PHP interpreter
+
*Uberspace Account and SSH connection
pear config-create ~ ~/.pearrc
+
*Using https connections is '''highly''' recommended!
test -f ~/etc/php.ini || cp -a /package/host/localhost/php-$PHPVERSION/lib/php.ini ~/etc/
+
=Configuring Uberspace=
perl -pi -e "s|^;?include_path.*|include_path=.:$HOME/pear/php:/package/host/localhost/php-$PHPVERSION/lib/php|" ~/etc/php.ini
+
==Install composer==
killall -u `whoami` php-cgi
+
<pre>
 
+
curl -sS https://getcomposer.org/installer | php -- --filename=composer --install-dir=$HOME/bin
* Install imagick
+
</pre>
pear config-set preferred_state beta
+
(source: [https://www.deltatag.at/composer-installation-auf-uberspace/])
uberspace-install-pecl imagick
+
==Install APCu==
 
+
<pre>
* Install PEAR modules (those hints are given by the installer, but here's the complete install line for the lazy people ;))
+
uberspace-install-pecl apcu-4.0.10
pear config-set auto_discover 1
+
killall php-cgi
pear install pear.doctrine-project.org/DoctrineORM pear.doctrine-project.org/DoctrineSymfonyYaml pear.twig-project.org/Twig
+
</pre>
 
+
You have to modify APCu-Version according to your version of PHP.
* Needed fixes for PartKeepr 0.1.8
+
Here 5.3.0 < PHP < 7.0.0-dev
 
+
Also look here: [https://pecl.php.net/package/APCu]
Replace the following line in src/backend/PartKeepr/Setup/Setup.php:
+
==Edit php.ini==
 
+
Set maximal execution time (mandatory, but will otherwise create warning in setup).
$classLoader = new ClassLoader('Symfony', 'Doctrine');
+
<pre>
 
+
max_execution_time=60
with:
+
</pre>
 
+
Changes for PHP5.6 (see: [PHP_5.6]):
$classLoader = new ClassLoader('Symfony');
+
<pre>
 
+
opcache.save_comments=1
* Now proceed with the regular setup
+
opcache.load_comments=1
 +
</pre>
 +
=PartKeepr installation=
 +
==Download Partkeepr==
 +
First change to your preferred installation folder.
 +
Then download the latest PartKeepr version and extract files:
 +
<pre>
 +
wget https://downloads.partkeepr.org/partkeepr-0.76.tbz2
 +
tar -jxvf filename.tar.bz2
 +
</pre>
 +
You can also install and update PartKeepr from git.
 +
Follow these instructions and continue here: [Running_PartKeepr_from_GIT]
 +
==configure .htaccess==
 +
If you are installing PartKeepr on a “Subdomain” you have to add in
 +
<pre>
 +
web/.htaccess
 +
</pre>
 +
the following line
 +
<pre>
 +
RewriteBase /web
 +
</pre>
 +
==create parameters.php==
 +
<pre>
 +
cd PartKeepr
 +
cp app/config/parameters.php.dist app/config/parameters.php
 +
</pre>
 +
==Download PHP Modules and install==
 +
<pre>
 +
composer install
 +
</pre>
 +
=Installation=
 +
The setup will automatically guide you through the installation process.
 +
You can start setup in your Browser:
 +
<pre>
 +
https://YOURDOMAIN/web/setup/
 +
</pre>
 +
After successful setup you can access PartKeepr via
 +
<pre>
 +
https://YOURDOMAIN/web
 +
</pre>
 +
If you wish to have a more comfortable solution you can add a .htaccess file above web folder, with the following content
 +
<pre>
 +
DirectoryIndex /web
 +
</pre>
 +
=Post install=
 +
==Add Runwhen- or Cronjob==
 +
<pre>
 +
0 0,6,12,18 * * * /usr/bin/php <path-to-partkeepr>/app/console partkeepr:cron:run
 +
</pre>
 +
Example for Cron (Runwhen recommended).
 +
=OLDER versions:=
 +
Needed fixes for PartKeepr 0.1.8
 +
Replace the following line in src/backend/PartKeepr/Setup/Setup.php:  
 +
<pre>$classLoader = new ClassLoader('Symfony', 'Doctrine');</pre>
 +
with:  
 +
<pre>$classLoader = new ClassLoader('Symfony');</pre

Revision as of 23:59, 24 February 2016

Uberspace is a pretty cool German Hosting Provider. This article focuses on PartKeepr Version > 0.7x. For previous versions look below.

Prerequisites

  • Uberspace Account and SSH connection
  • Using https connections is highly recommended!

Configuring Uberspace

Install composer

curl -sS https://getcomposer.org/installer | php -- --filename=composer --install-dir=$HOME/bin

(source: [1])

Install APCu

uberspace-install-pecl apcu-4.0.10
killall php-cgi

You have to modify APCu-Version according to your version of PHP. Here 5.3.0 < PHP < 7.0.0-dev Also look here: [2]

Edit php.ini

Set maximal execution time (mandatory, but will otherwise create warning in setup).

max_execution_time=60

Changes for PHP5.6 (see: [PHP_5.6]):

opcache.save_comments=1
opcache.load_comments=1

PartKeepr installation

Download Partkeepr

First change to your preferred installation folder. Then download the latest PartKeepr version and extract files:

wget https://downloads.partkeepr.org/partkeepr-0.76.tbz2
tar -jxvf filename.tar.bz2

You can also install and update PartKeepr from git. Follow these instructions and continue here: [Running_PartKeepr_from_GIT]

configure .htaccess

If you are installing PartKeepr on a “Subdomain” you have to add in

web/.htaccess 

the following line

RewriteBase /web

create parameters.php

cd PartKeepr
cp app/config/parameters.php.dist app/config/parameters.php

Download PHP Modules and install

composer install

Installation

The setup will automatically guide you through the installation process. You can start setup in your Browser:

https://YOURDOMAIN/web/setup/

After successful setup you can access PartKeepr via

https://YOURDOMAIN/web

If you wish to have a more comfortable solution you can add a .htaccess file above web folder, with the following content

DirectoryIndex /web

Post install

Add Runwhen- or Cronjob

0 0,6,12,18 * * * /usr/bin/php <path-to-partkeepr>/app/console partkeepr:cron:run

Example for Cron (Runwhen recommended).

OLDER versions:

Needed fixes for PartKeepr 0.1.8 Replace the following line in src/backend/PartKeepr/Setup/Setup.php:

$classLoader = new ClassLoader('Symfony', 'Doctrine');

with:

$classLoader = new ClassLoader('Symfony');</pre