Unable to render {include} The included page could not be found.

PhotArk Developer Guide

Prerequisites

Getting the source code

PhotArk subversion repository is located at http://svn.apache.org/repos/asf/incubator/photark/trunk/

The repository can also be viewed online at http://svn.apache.org/viewvc/incubator/photark/trunk/

Checking out code from subversion

Server

svn checkout http://svn.apache.org/repos/asf/incubator/photark/server/trunk/

Mobile

svn checkout http://svn.apache.org/repos/asf/incubator/photark/mobile/trunk/

Building the source code

mvn clean install

Importing PhotArk modules into Eclipse

If this is the first time you are using your workspace with maven m2 local repository, you will need to tell your Eclipse workspace the location of the directory, and you can do this with the following command :

mvn -Declipse.workspace=[path-to-eclipse-workspace] eclipse:add-maven-repo

To generate the necessary eclipse project files to import PhotArk modules into Eclipse, you can use the maven eclipse plugin:

mvn eclipse:eclipse

Deploying PhotArk in Web Application

After building the source code, deploy photoArk-webapp/target/photark.war in your favorite web application server (e.g Apache Tomcat)

Point your browser to :

http://localhost:8080/photark/

Automating PhotArk deployment to Apache Tomcat

If you are using Apache Tomcat, you can configure your maven settings.xml to point to your Tomcat installation and then use mvn tomcat:deploy to have PhotArk deployed to the application server

Edit your maven settings.xml (e.g ~/.m2/settings.xml)

  <servers>
    <server>
      <id>tomcat</id>
      <username>username</username>
      <password>password</password>
    </server>
  </servers>

Deploying PhotArk

   mvn tomcat:deploy

Re-deploying PhotArk

   mvn tomcat:undeploy tomcat:deploy

Configuring Tomcat Security

Access to PhotArk admin area is currently configured under a "secured resource" and require users to be in the "photark-admin" role. With the basic tomcat deployment, edit %TOMCAT_HOME%/conf/tomcat-users.xml and configure a new/existent user with the proper role (see example below)

<?xml version='1.0' encoding='utf-8'?>
<tomcat-users>
  <role rolename="photark-admin"/>
  <user username="photark-admin" password="password" roles="photark-admin"/>
</tomcat-users>
Copyright © 2009-2011, The Apache Software Foundation Apache PhotArk is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Incubator PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF.
  • No labels