File: install.html

package info (click to toggle)
sporum 1.8b1-3.1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 1,108 kB
  • ctags: 676
  • sloc: perl: 14,300; makefile: 52
file content (164 lines) | stat: -rw-r--r-- 10,423 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
<HTML>
<HEAD>
   <META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
   <META NAME="GENERATOR" CONTENT="Mozilla/4.04 [en] (X11; I; Linux 2.0.32 i586) [Netscape]">
   <META NAME="Author" CONTENT="SmallPig">
   <TITLE>Installation</TITLE>
</HEAD>
<BODY TEXT="#000000" BGCOLOR="#FFFFFF" LINK="#333333" VLINK="#000000" ALINK="#666666">
&nbsp;
<BR>&nbsp;
<CENTER><TABLE BORDER=0 CELLSPACING=0 CELLPADDING=6 WIDTH="70%" NOSAVE >
<TR NOSAVE>
<TD NOSAVE>
<TABLE BORDER=0 CELLSPACING=0 COLS=2 WIDTH="100%" NOSAVE >
<TR BGCOLOR="#FFCC00" NOSAVE>
<TD WIDTH="120" NOSAVE><A HREF="http://smallpig.net/sporum"><IMG SRC="http://smallpig.net/sporum/images/sporumlogo.png" BORDER=0 HEIGHT=21 WIDTH=119></A></TD>

<TD VALIGN=BOTTOM NOSAVE><FONT FACE="Arial,Helvetica"><FONT COLOR="#FFFFFF">&nbsp;</FONT></FONT></TD>
</TR>

<TR NOSAVE>
<TD ALIGN=RIGHT COLSPAN="2" NOSAVE><FONT FACE="Arial,Helvetica"><FONT COLOR="#000000"><FONT SIZE=-1><A HREF="http://smallpig.net/sporum/info.html">Sporum
info</A> | <A HREF="http://smallpig.net/sporum/download.html">Dowload</A>
| <A HREF="http://smallpig.net/cgi-sys/cgiwrap/smallpig/sporum/index.cgi">Demo</A>
| <A HREF="http://smallpig.net/cgi-sys/cgiwrap/smallpig/sporum/order.cgi">Order</A>
| <A HREF="mailto:smallpig@smallpig.net">Contact</A></FONT></FONT></FONT></TD>
</TR>
</TABLE>
&nbsp;</TD>
</TR>
</TABLE></CENTER>
&nbsp;
<CENTER><TABLE BORDER=0 CELLSPACING=0 CELLPADDING=5 COLS=1 WIDTH="70%" NOSAVE >
<TR VALIGN=TOP NOSAVE>
<TD NOSAVE>
<TABLE BORDER=0 CELLSPACING=0 COLS=1 WIDTH="100%" BGCOLOR="#FFCC00" NOSAVE >
<TR NOSAVE>
<TD NOSAVE>
<CENTER><B><FONT FACE="Arial,Helvetica">Installation</FONT></B></CENTER>

<TABLE BORDER=0 CELLSPACING=0 COLS=1 WIDTH="100%" BGCOLOR="#FFFFFF" NOSAVE >
<TR NOSAVE>
<TD NOSAVE><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Before you can install
Sporum, you need to know the requirements described in <A HREF="http://smallpig.net/sporum/info.html">Sporum
info</A>.&nbsp; If you finished installing the requirements, it is time
to start building the main Sporum package:&nbsp;</FONT></FONT>&nbsp;

<P><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Uncompressed Sporum:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Untar and uncompress the
sporum compressed file using a program like 'tar' into your CGI directory.&nbsp;</FONT></FONT>&nbsp;

<P><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Set Permission:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Set the file permission
of all the cgi file to 755.&nbsp;</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1><B>Verify Perl Path:</B>&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>The first line of the cgi
#!/usr/bin/perl is the absolute path location of Perl. Most servers follow
this path for Perl. But your server may be configured differently. If so,
you have to replace a correct path with the path on each of the cgi file
in order to run Sporum properly.&nbsp;</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1><B>Configure Sporum:</B>&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Manually edit the variables
in ./SmallPigVars.pm and ./Themes/default/theme.pm to suit your configuration needs.&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT></FONT>&nbsp;
<BR><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Create Database:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Once you have changed the
values and saved SmallPigVars.pm, you can create the database for Sporum.
Its name should correspond to the default name you use in SmallPigVars.pm.
Also, make sure you know the database names are case sensitive under UNIX
system.&nbsp;</FONT></FONT>&nbsp;

<P><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Grant Privilege:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Be sure that you have a
user for that database which has the rights to select, insert, update,
delete, create, alter and drop. A MySQL Grant statment for this user would
look like this:</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
GRANT select, insert, update, create, alter, delete, drop</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
ON database.*</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
TO user@localhost</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
IDENTIFIED BY 'password';</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>where database is the name
of the database you created, user is the name you specified in SmallPigVars.pm
and password is the password you specified in SmallPigVars.pm.&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT></FONT>&nbsp;
<BR><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Create Tables:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Sporum has a variety of
tables it must access in order to function properly. To import the tables
file into the Sporum database on the local machine, simply run:</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./mysql/createtables.pl</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1><B>Create Administrator:</B>&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Access this page
<B>http://sporum-directory/default.cgi?dpage=createadmin</B>, and enter the account information to create a new administrator.  After creating the first user(administrator), remember to delete the "createadmin.temp" file located in "templates" directory and "createadmin.cgi".</FONT></FONT>

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1><B>Administration Menu:</B>&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Once you have registered
a username you can go to the administration page(eg. admin.cgi) to create
new boards, assign moderator and the like:</FONT></FONT>&nbsp;
<LI>
<FONT FACE="Arial,Helvetica"><FONT SIZE=-1><I>Create new categories and
boards:</I> you will see the "Create Category" and "Create a New Board"
options.&nbsp; Think about what boards you want and begin adding them.&nbsp;</FONT></FONT></LI>

<LI>
<FONT FACE="Arial,Helvetica"><FONT SIZE=-1><I>Choose Moderators and add
group members: </I>After the boards are created, you can assign anyone
who have a user account as a moderator.&nbsp; A group private board is
not open to public.&nbsp; You can tell Sporum who can enter the board,
and only those users are allowed in.&nbsp; You can let the moderators to
take on this task, or do it by yourself.&nbsp;</FONT></FONT></LI>

<BR>&nbsp;
<BR><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Customize the Layout:</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>You can customize the layout
by editing the inc files in includes directory.&nbsp; If you are familiar
with perl, you can also embed some perl script within those files.&nbsp;&nbsp;</FONT></FONT>&nbsp;

<P><B><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Adding Crontab Entries:&nbsp;</FONT></FONT></B>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>Sporum uses UNIX cron facility
to expire the outdated threads, delete the unused file attachments and
inactive users, and send forums subscription messages periodically. First,
you need to edit four files (deletefiles.pl, deleteusers.pl, delivermessages.pl,
expirethreads.pl) by changing the path that will be inserted to @INC:</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
unshift(@INC, "/usr/local/apache/perl/sporum");</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>And then create a crontab
entries using the crontab command. Before adding crontab entries, you need
to modify the path to reflect the correct location of those four scripts
*.pl mentioned above. You can executes the command as below, the file expirethreads.cron
will be installed as /var/spool/cron/crontabs/username:</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
crontab sporumcron</FONT></FONT>&nbsp;

<P><FONT FACE="Arial,Helvetica"><FONT SIZE=-1><B>Congratulation:</B>&nbsp;</FONT></FONT>&nbsp;
<BR><FONT FACE="Arial,Helvetica"><FONT SIZE=-1>If everthing is working,
your Sporum installation is complete.&nbsp;</FONT></FONT></TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE>
</TD>
</TR>
</TABLE></CENTER>

<CENTER><FONT FACE="Arial,Helvetica"><FONT SIZE=-2>All content&nbsp; ncluding
graphics by <A HREF="mailto:smallpig@smallpig.net">smallpig</A> on this
site is copyright 1999.</FONT></FONT></CENTER>

</BODY>
</HTML>