http://documentation.actionapps.org/index.php?title=Installation_of_ActionApps&feed=atom&action=historyInstallation of ActionApps - Revision history2024-03-29T10:36:11ZRevision history for this page on the wikiMediaWiki 1.27.4http://documentation.actionapps.org/documentation/index.php?title=Installation_of_ActionApps&diff=3248&oldid=prevMilhaus at 21:09, 18 September 20082008-09-18T21:09:23Z<p></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;' lang='en'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 21:09, 18 September 2008</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l86" >Line 86:</td>
<td colspan="2" class="diff-lineno">Line 86:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Your first test slice ==</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>== Your first test slice ==</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>After creating the superadmin you will be thanked and either directed to the Slice addition page http://localhost/apc-aa/admin/sliceadd.php3 or direct to the Administration front end [http://localhost/apc-aa/admin/index.php3 http://localhost/apc-aa/admin]. You should be able to log in now with the superadmin account you created above. Refer to the [http://www.apc.org/actionapps/english/manual/wmguide.html APC ActionApps User Manual Webmaster's guide].</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>After creating the superadmin you will be thanked and either directed to the Slice addition page http://localhost/apc-aa/admin/sliceadd.php3 or direct to the Administration front end [http://localhost/apc-aa/admin/index.php3 http://localhost/apc-aa/admin]. You should be able to log in now with the superadmin account you created above. Refer to the [http://www.apc.org/actionapps/english/manual/wmguide.html APC ActionApps User Manual Webmaster's guide].</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;"></ins></div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div><ins style="font-weight: bold; text-decoration: none;">[[Category:Installation]]</ins></div></td></tr>
</table>Milhaushttp://documentation.actionapps.org/documentation/index.php?title=Installation_of_ActionApps&diff=3207&oldid=prevRadek: /* Installing via CVS for developers */ fixed link2008-08-01T16:09:03Z<p><span dir="auto"><span class="autocomment">Installing via CVS for developers: </span> fixed link</span></p>
<table class="diff diff-contentalign-left" data-mw="interface">
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr style='vertical-align: top;' lang='en'>
<td colspan='2' style="background-color: white; color:black; text-align: center;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black; text-align: center;">Revision as of 16:09, 1 August 2008</td>
</tr><tr><td colspan="2" class="diff-lineno" id="mw-diff-left-l7" >Line 7:</td>
<td colspan="2" class="diff-lineno">Line 7:</td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>ActionApps can be installed either in some common location, or inside one of the Virtual Hosts, the example below assumes that ActionApps is installed in a common location, "/home/httpd/"</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>ActionApps can be installed either in some common location, or inside one of the Virtual Hosts, the example below assumes that ActionApps is installed in a common location, "/home/httpd/"</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Installing via CVS for developers ===</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Installing via CVS for developers ===</div></td></tr>
<tr><td class='diff-marker'>−</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;"><div>Developers should check the [http:<del class="diffchange diffchange-inline">//http</del>//apc-aa.sourceforge.net/faq/#234 FAQ item] for an alternative.</div></td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div>Developers should check the [http://apc-aa.sourceforge.net/faq/#234 FAQ item] for an alternative.</div></td></tr>
<tr><td colspan="2"> </td><td class='diff-marker'>+</td><td style="color:black; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;"><div> </div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Installing via CVS for non-developers ===</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>=== Installing via CVS for non-developers ===</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>If you are installing from CVS repository, you must have cvs utility installed on your machine. Check:</div></td><td class='diff-marker'> </td><td style="background-color: #f9f9f9; color: #333333; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #e6e6e6; vertical-align: top; white-space: pre-wrap;"><div>If you are installing from CVS repository, you must have cvs utility installed on your machine. Check:</div></td></tr>
</table>Radekhttp://documentation.actionapps.org/documentation/index.php?title=Installation_of_ActionApps&diff=3113&oldid=prevMilhaus at 08:44, 25 July 20082008-07-25T08:44:26Z<p></p>
<a href="http://documentation.actionapps.org/documentation/index.php?title=Installation_of_ActionApps&diff=3113&oldid=3112">Show changes</a>Milhaushttp://documentation.actionapps.org/documentation/index.php?title=Installation_of_ActionApps&diff=3112&oldid=prevMilhaus: New page: == Installation == APC-AA software is just a bunch of php scripts - human (though php savvy) readable files. There no binaries or anything else to be worried about. The whole installation...2008-07-24T22:07:44Z<p>New page: == Installation == APC-AA software is just a bunch of php scripts - human (though php savvy) readable files. There no binaries or anything else to be worried about. The whole installation...</p>
<p><b>New page</b></p><div>== Installation ==<br />
<br />
APC-AA software is just a bunch of php scripts - human (though php savvy) readable files. There no binaries or anything else to be worried about. The whole installation task means getting the files and copy them into some directory. There are two options how to install APC-AA. You can either:<br />
* download latest CVS version via cvs<br />
* download the latest stable version in zipped format<br />
<br />
Installing the ActionApps via CVS makes it easy to update later. The problem is that CVS repository is mainly intended for developers and thus always contains latest development version, which doesn't always have to be stable, and may contain bugs. On the other hand, you will get latest features and known bug fixes. The rule-of-thumb is if you need fetures that are currently being developed, than use CVS. If it's quite unlikely that you will need to update APC-AA very often, than stick on stable releases.<br />
<br />
The exact details will depend on whether your machine is serving multiple Virtual Domains and if so, whether ActionApps is to be made available to all the domains or not.<br />
<br />
ActionApps can be installed either in some common location, or inside one of the Virtual Hosts, the example below assumes that ActionApps is installed in a common location, "/home/httpd/"<br />
<br />
=== Installing via CVS for developers ===<br />
<br />
Developers should check the [http://http//apc-aa.sourceforge.net/faq/#234 FAQ item] for an alternative.<br />
<br />
=== Installing via CVS for non-developers ===<br />
<br />
If you are installing from CVS repository, you must have cvs utility installed on your machine. Check:<br />
<nowiki><br />
# rpm -q cvs<br />
# cvs-1.11.2-8<br />
</nowiki><br />
<br />
CVS will automatically create the installation directory for you named APC-AA.<br />
<br />
<blockquote><br />
----<br />
<br />
<code><nowiki># cd /home/httpd/</nowiki><br /><nowiki># cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/apc-aa login </nowiki><br /><nowiki># press enter at the password prompt </nowiki><br /><nowiki># cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/apc-aa co apc-aa</nowiki></code><br />
<br />
----<br />
</blockquote><br />
<br />
''There was a [http://www.mail-archive.com/bug-cvs@gnu.org/msg01322.html bug] in the current version of CVS 1.11, if you see the error "failed to open ~/.cvspass for reading: No such file or directory" when doing the login, then "touch ~/.cvspass" and try again.''<br />
<br />
===4.1.3 Installing the stable release via FTP===<br />
<br />
If you want to install the latest stable version rather than the one from CVS, download it from http://sourceforge.net/projects/apc-aa/ to the hard drive (let's say to <code>/tmp</code>) and than untar<br />
<br />
<blockquote><br />
----<br />
<br />
<code> # cd /home/httpd/<br /> # tar -xvzf /tmp/apc-aa-2.6.0.tgz </code><br />
<br />
----<br />
</blockquote><br />
<br />
This will create directory /home/httpd/apc-aa-2.6.0, which you can rename to apc-aa or whatever is convenient for you.<br />
<br />
If you have no shell access on the machine, then you can download this code, and FTP it into a directory on your web site<br />
<br />
If you want ActionApps available to all domains, then add this line in the global context with the other Aliases, otherwise you can add it to each Virtual domain where you want to make ActionApps available.<br />
<br />
Note that you do NOT need to do this for a virtual domain IF ActionApps is installed directly in that domains web site.<br />
<br />
<blockquote><br />
----<br />
<br />
<code>Alias /apc-aa/ /home/httpd/apc-aa/</code><br />
<br />
----<br />
</blockquote><br />
<br />
===4.1.4 Configuring ActionApps===<br />
<br />
Edit <code>/home/httpd/html/apc-aa/include/config.php3</code>.<br />
<br />
This is the main ActionApps configuration file. It contains comments which explain everything there. Note that this file may not contain anything before the <code><?php</code> line at the top and after the <code>?></code> line at the bottom.<br />
<br />
'''The file <code>/home/httpd/html/apc-aa/include/config.php3</code> now contains passwords. It should therefore not be world readable. On the other hand, the http server must be able to read it. Read the chapter on [install-6.html#security security] for a possible solution for this problem.'''<br />
<br />
==4.2 Creating the database==<br />
<br />
There are two options depending on whether you have shell access, or are running on an ISP's setup.<br />
<br />
===4.2.1 No shell access: Asking the ISP===<br />
<br />
Ask the ISP to:<br />
<br />
<blockquote> Create a mysql database called "aadb", and a mysql user with permission to CREATE,DROP,ALTER,SELECT,INSERT,UPDATE,DELETE on this database. They should know what this means, and understand it presents no security implications. </blockquote><br />
<br />
===4.2.2 Shell access: creating it yourself===<br />
<br />
Then create your initial ActionApps database. When queried for a password, use the mysql root password.<br />
<br />
<blockquote><br />
----<br />
<br />
<code><nowiki># mysql -u root -p</nowiki><br />Enter password:<br />mysql> CREATE DATABASE aadb;<br />Query OK, 1 row affected (0.03 sec)<br /><br />mysql> QUIT<br />Bye<br /></code><br />
<br />
----<br />
</blockquote><br />
<br />
Create a user in MySQL that will be able to access the new aadb database. Note that the instructions below assumed you used "localhost" as the MySQL server, if you set something else, then it will typically be something like "aadbuser@machinename". This username and password should match that set in config.php3 above. We will refer to this password as the ''aadbuser password''.<br />
<br />
<blockquote><br />
----<br />
<br />
<code><nowiki># mysql -u root -p</nowiki><br />mysql> USE mysql;<br />mysql> GRANT CREATE,DROP,ALTER,SELECT,INSERT,UPDATE,DELETE<br />ON aadb.*<br />TO aadbuser@localhost<br />IDENTIFIED BY 'password2';<br />Query OK, 0 rows affected (0.05 sec)<br /><br />mysql> FLUSH PRIVILEGES;<br />mysql> quit<br /></code><br />
<br />
</blockquote><br />
<br />
==4.3 Initializing the database and creating a superadmin account==<br />
<br />
Once the database and account are created, point your Web browser to http://localhost/apc-aa/sql_update.php3. If there are any error messages (which will show up in bold) these are typically because the ISP has failed to give you one of the database permissions requested above, or has set up authentication for the database wrongly.<br />
<br />
Point your Web browser to http://localhost/apc-aa/admin/setup.php3. You should see a page with two buttons "Init" and "Recover", click "Init" and you should receive a form where you can enter the information for the SuperAdmin account.<br />
<br />
If you don't get the form, just the same screen again, then check your php settings if "register_globals = On" as described in [install-3.html#ss3.7 3.7].<br />
<br />
There is just one question open: What is login name and password of the initial superadmin account (which you need to create the first slice)? The answer depends on the permission system you use.<br />
<br />
* If you are using the LDAP based permission system, the superadmin account is the one you created when you edited the initial LDIF data file. At that time, you have also set a password for this account.<br />
* If you are using the sql based permission system, there is no initial superadmin account so far. To create one, follow the instructions below.<br />
<br />
ActionApps users who have the superadmin privilege may create new slices in addition to the rights any slice administrator has.<br />
<br />
Creating a superadmin account will be necessary whenever you don't have one left. This is the case at installation time if you are using the sql based permission system, and in case you have accidently deleted the last superadmin account or accidently revoked the superadmin privilege from the last superadmin account. To create a superadmin account, follow these steps.<br />
<br />
* rename the file apc-aa/admin/setup.php.txt to apc-aa/admin/setup.php<br />
* go to [http://localhost/apc-aa/admin/sliceadd.php3 http://localhost/apc-aa/admin/setup.php3] and press "Recover"<br />
* rename the file apc-aa/admin/setup.php back to apc-aa/admin/setup.php.txt for safety.<br />
<br />
==4.4 File uploads and cron==<br />
<br />
If you want people to be able to use file uploads, you have to create a directory where apache server can store uploaded files, and which will accessible via the webserver. To do this, create the directory under one of your sites, or create it somewhere else and create an alias in httpd.conf to point at it. Make sure this directory is the apache web server has write permissions for this directory. Look for lines like <br /><br />
<br />
<code><br />
<br />
User apache<br />
Group apache<br />
<br />
</code><br />
<br />
in your httpd.conf file in order to find out under which identity is your web server running. Than set the right permisions. Example:<br />
<br />
<blockquote><br />
----<br />
<br />
<code><br />
# mkdir /var/www/uploads<br />
# chown apache:apache /var/www/uploads<br />
# chmod 775 /var/www/uploads/<br />
</code><br />
<br />
----<br />
</blockquote><br />
<br />
Edit apc-aa/include/config.php3, edit the defines IMG_UPLOAD_PATH and IMG_UPLOAD_URL to point to this directory. Note the trailing "/".<br />
<br />
To stop someone uploading a PHP file and then executing it, edit your httpd.conf file and add<br />
<br />
<blockquote><br />
----<br />
<br />
<code><br />
<br />
Options None<br />
php_flag engine off<br />
<br />
</code><br />
<br />
----<br />
</blockquote><br />
<br />
For installing cron, please refer to the [http://apc-aa.sourceforge.net/faq/ FAQ] page.<br />
<br />
==4.5 Your first test slice==<br />
<br />
After creating the superadmin you will be thanked and either directed to the Slice addition page http://localhost/apc-aa/admin/sliceadd.php3 or direct to the Administration front end [http://localhost/apc-aa/admin/index.php3 http://localhost/apc-aa/admin]. You should be able to log in now with the superadmin account you created above. Refer to the [http://www.apc.org/actionapps/english/manual/wmguide.html APC ActionApps User Manual Webmaster's guide].</div>Milhaus