This guide instructs you on how to install OpenPhoto on a Fedora server.
You'll need to provide credentials for a MySql database. If the database doesn't already exist it will be created. If the user doesn't have CREATE DATABASE
permissions then make sure to create the database.
If you're going to use AWS S3 then you'll need to be signed up for it.
Once you've confirmed that your cloud account is set up, you can get started on your server. For that you'll need to have Apache, PHP and curl installed with a few modules.
yum groupinstall 'Development Tools'
yum groupinstall 'Development Libraries'
yum install httpd httpd-devel php php-devel php-common php-curl php-gd php-mcrypt pcre pcre-devel ImageMagick php-magickwand php-pecl-imagick ImageMagick-devel php-pear php-mysql fbida
pecl channel-update pecl.php.net
pecl install imagick
echo "extension=imagick.so" > /etc/php.d/imagick.so.ini
pecl install apc
echo "extension=apc.so" > /etc/php.d/apc.ini
pecl install oauth
echo "extension=oauth.so" > /etc/php.d/oauth.ini
# start apache
/etc/init.d/httpd start
# make sure it starts on boot
chkconfig --add httpd
If you're going to be using MySql you need to install it.
yum install mysql-server
# start mysql
/etc/init.d/mysqld start
# make sure it starts on boot
chkconfig --add mysqld
You may have to manually add the PHP mcrypt library if php-mcrypt
isn't installed.
# run this to see if mcrypt is enabled
php -i | grep 'mcrypt support => enabled'
# if you don't see mcrypt you can do the following
# taken from http://stackoverflow.com/a/18553415
wget http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
sudo rpm -Uvh epel-release-6-8.rpm
yum install php-mcrypt
# restart apache
/etc/init.d/httpd restart
Download and install the source code. We recommend /var/www/yourdomain.com
but you can use any directory you'd like.
The Apache 2 user in Fedora 16 is apache
so run the following commands to take ownership of the web files.
yum install git
git clone git://github.com/photo/frontend.git /var/www/yourdomain.com
chown -R apache: /var/www/yourdomain.com
Assuming that this is a development machine you only need to make the config writable by the user Apache runs as. This user is likely apache
.
mkdir /var/www/yourdomain.com/src/userdata
mkdir /var/www/yourdomain.com/src/html/photos
mkdir /var/www/yourdomain.com/src/html/assets/cache
chown apache: /var/www/yourdomain.com/src/userdata
chown apache: /var/www/yourdomain.com/src/html/photos
chown apache: /var/www/yourdomain.com/src/html/assets/cache
You'll need to copy the sample virtual host configuration file from the source to /etc/httpd/conf.d/
.
cp /var/www/yourdomain.com/src/configs/openphoto-vhost.conf /etc/httpd/conf.d/openphoto.conf
You'll need to replace instances of /path/to/openphoto/html/directory
with /var/www/yourdomain.com/src/html
or wherever you placed the code.
Edit /etc/httpd/conf/httpd.conf
and ensure the following modules are enabled: rewrite, deflate, expires, headers. Here are the corresponding lines to the enabled apache modules in httpd.conf
.
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule deflate_module modules/mod_deflate.so
LoadModule expires_module modules/mod_expires.so
LoadModule headers_module modules/mod_headers.so
By default, any access to ini files is denied with a "Not Found" 404 HTTP code. To enable a 404, or Forbidden return code, change the following lines in the virtual host file.
Uncomment:
# 403 Forbidden for ini files
#RewriteRule \.ini$ - [F,NC]
Comment:
# 404 Not Found for ini files
AliasMatch \.ini$ /404
You should also verify that your php.ini
file has a few important values set correctly.
vi /etc/php.ini
Search for the following values and make sure they're correct.
file_uploads = On
upload_max_filesize = 16M
post_max_size = 16M
Ensure that /etc/php.d/apc.ini
and /etc/php.d/oauth.ini
exist and that the php extensions are enabled.
Now you're ready to restart apache and visit the site in your browser.
service httpd restart
Now you're ready to launch your OpenPhoto site. Point your browser to your host and you'll be taken to a setup screen. You'll need your cloud account credentials to continue.
Once you complete the 3 steps your site will be up and running and you'll be redirected there. The setup screen won't show up anymore. If for any reason you want to go through the setup again you will need to delete the generated config file and refresh your browser.
rm /var/www/yourdomain.com/src/userdata/configs/yourdomain.com.ini
ENJOY!