d3919ba1b9
following features: * simple and logical user interface : aims at conciseness like LaTeX * high accessibility : XHTML 1.0 compliant and considering WCAG 1.0 * hybrid data structure : available as BBS, blog, and Wiki * sufficient functionality : supports user management and file management * high performance : uses an embedded database, Tokyo Cabinet * lightweight : implemented by C99 and without any dependency on other libraries WWW: http://1978th.net/tokyopromenade/ PR: ports/143211 Submitted by: Qing Feng <qingfeng at me.com> Feature safe: yes
59 lines
1.8 KiB
Text
59 lines
1.8 KiB
Text
POST-INSTALL CONFIGURATION FOR Tokyo Promenade
|
|
==============================================
|
|
|
|
1) Install an arbitrary web server which supports the CGI mechanism.
|
|
Then, create a directory where CGI scripts can be executed. We call
|
|
it the base directory, which contains some files of Tokyo Promenade.
|
|
|
|
mkdir -p /path/to/the/base/directory
|
|
cd /path/to/the/base/directory
|
|
|
|
2) Copy the CGI script and some configuration files into the base
|
|
directory.
|
|
|
|
cp %%PREFIX%%/libexec/promenade.fcgi .
|
|
cp %%DATADIR%%/promenade.* .
|
|
cp %%DATADIR%%/passwd.txt .
|
|
|
|
3) Create the database file where articles are stored.
|
|
|
|
prommgr create promenade.tct
|
|
|
|
4) Import the help articles into the database.
|
|
|
|
prommgr import promenade.tct %%DATADIR%%/misc/help-*.tpw
|
|
|
|
5) Create a directory where uploaded files are stored.
|
|
|
|
mkdir upload
|
|
|
|
6) The CGI script should have permissions to read/write the database
|
|
file, the upload directory and the password file. To achieve the
|
|
purpose, one of the following is suggested.
|
|
|
|
Change the owner:
|
|
sudo chown -R www:nobody /path/to/the/base/directory
|
|
|
|
Forget the security:
|
|
chmod -R 777 /path/to/the/base/directory
|
|
|
|
Run the web server by the same user of the owner of the base
|
|
directory.
|
|
|
|
Change the user ID of the CGI script by using a feature of the
|
|
web server like suExec.
|
|
|
|
7) Run the FastCGI script.
|
|
|
|
%%LOCALBASE%%/bin/spawn-fcgi -a 127.0.0.1 -p 8889 \
|
|
-d /path/to/the/base/directory \
|
|
-f /path/to/the/base/directory/promenade.fcgi
|
|
|
|
8) Configure your web browser with FastCGI-specific directives. For
|
|
Apache, this might look like:
|
|
|
|
FastCgiExternalServer /path/to/the/base/directory/promenade.fcgi \
|
|
-host 127.0.0.1:8889
|
|
|
|
When all steps above are finished, access the CGI script with a Web
|
|
browser.
|