60 lines
1.8 KiB
Text
60 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.
|