|
@@ -7,7 +7,7 @@
|
|
<section>
|
|
<section>
|
|
<title>Overview</title>
|
|
<title>Overview</title>
|
|
<para>
|
|
<para>
|
|
- Flatstore is one of so-called &ser; database modules. It does not
|
|
|
|
|
|
+ Flatstore is one of so-called &openser; database modules. It does not
|
|
export any functions executable from the configuration scripts, but
|
|
export any functions executable from the configuration scripts, but
|
|
it exports a subset of functions from the database API and thus
|
|
it exports a subset of functions from the database API and thus
|
|
other module can use it instead of, for example, mysql module.
|
|
other module can use it instead of, for example, mysql module.
|
|
@@ -38,7 +38,7 @@ modparam("acc", "db_url", "flatstore:/var/log/acc")
|
|
<para>
|
|
<para>
|
|
This configuration options tells acc module that it should use the
|
|
This configuration options tells acc module that it should use the
|
|
flatstore module and the flatstore module should create all files
|
|
flatstore module and the flatstore module should create all files
|
|
- in /var/log/acc directory. The directory must exist and &ser;
|
|
|
|
|
|
+ in /var/log/acc directory. The directory must exist and &openser;
|
|
processes must have permissions to create files in that directory.
|
|
processes must have permissions to create files in that directory.
|
|
</para>
|
|
</para>
|
|
<para>
|
|
<para>
|
|
@@ -48,12 +48,12 @@ modparam("acc", "db_url", "flatstore:/var/log/acc")
|
|
<table_name>_<process_name>.log
|
|
<table_name>_<process_name>.log
|
|
</programlisting>
|
|
</programlisting>
|
|
<para>
|
|
<para>
|
|
- For example, entries writen by &ser; process 8 into acc table would
|
|
|
|
|
|
+ For example, entries writen by &openser; process 8 into acc table would
|
|
be written in file acc_8.log. For each table there will be several
|
|
be written in file acc_8.log. For each table there will be several
|
|
- files, one file for every &ser; process that wrote some data into
|
|
|
|
|
|
+ files, one file for every &openser; process that wrote some data into
|
|
that table. The main reason why there are several files for each
|
|
that table. The main reason why there are several files for each
|
|
table is that it is much faster to have one file per process,
|
|
table is that it is much faster to have one file per process,
|
|
- because it does not require any locking and thus &ser; processes will
|
|
|
|
|
|
+ because it does not require any locking and thus &openser; processes will
|
|
not block each other. To get the complete data for a table you can
|
|
not block each other. To get the complete data for a table you can
|
|
simply concatenate the contents of files with the same table name
|
|
simply concatenate the contents of files with the same table name
|
|
but different process id.
|
|
but different process id.
|
|
@@ -61,9 +61,9 @@ modparam("acc", "db_url", "flatstore:/var/log/acc")
|
|
<section id="rotating">
|
|
<section id="rotating">
|
|
<title>Rotating Log Files</title>
|
|
<title>Rotating Log Files</title>
|
|
<para>
|
|
<para>
|
|
- There is a new &ser; MI (management interface) command called
|
|
|
|
|
|
+ There is a new &openser; MI (management interface) command called
|
|
flat_rotate.
|
|
flat_rotate.
|
|
- When &ser; receives the command then it will close and reopen all
|
|
|
|
|
|
+ When &openser; receives the command then it will close and reopen all
|
|
files used by flatstore module. The rotation itself has to be
|
|
files used by flatstore module. The rotation itself has to be
|
|
done by another application (such as logrotate). Follow these
|
|
done by another application (such as logrotate). Follow these
|
|
steps to rotate files generated by flatstore module:
|
|
steps to rotate files generated by flatstore module:
|
|
@@ -79,21 +79,21 @@ mv acc_2.log acc_2.log.20050605
|
|
mv acc_4.log acc_3.log.20050605
|
|
mv acc_4.log acc_3.log.20050605
|
|
...
|
|
...
|
|
</screen>
|
|
</screen>
|
|
- Note that at this point &ser; will still be writing all
|
|
|
|
|
|
+ Note that at this point &openser; will still be writing all
|
|
data into the renamed files.
|
|
data into the renamed files.
|
|
</para>
|
|
</para>
|
|
</listitem>
|
|
</listitem>
|
|
<listitem>
|
|
<listitem>
|
|
<para>
|
|
<para>
|
|
- Send &ser; the MI command to close and reopen the
|
|
|
|
|
|
+ Send &openser; the MI command to close and reopen the
|
|
renamed files. For example, using FIFO:
|
|
renamed files. For example, using FIFO:
|
|
<screen>
|
|
<screen>
|
|
openserctl fifo flat_rotate
|
|
openserctl fifo flat_rotate
|
|
</screen>
|
|
</screen>
|
|
- This will force &ser; to close the renamed files and open
|
|
|
|
|
|
+ This will force &openser; to close the renamed files and open
|
|
new ones with original names, such as
|
|
new ones with original names, such as
|
|
<filename>acc_1.log</filename>. New files will be open
|
|
<filename>acc_1.log</filename>. New files will be open
|
|
- at the point when &ser; has some data to write. It is
|
|
|
|
|
|
+ at the point when &openser; has some data to write. It is
|
|
normal that the files will be not created immediately
|
|
normal that the files will be not created immediately
|
|
if there is no traffic on the proxy server.
|
|
if there is no traffic on the proxy server.
|
|
</para>
|
|
</para>
|
|
@@ -110,13 +110,13 @@ openserctl fifo flat_rotate
|
|
<section>
|
|
<section>
|
|
<title>Dependencies</title>
|
|
<title>Dependencies</title>
|
|
<section>
|
|
<section>
|
|
- <title>&ser; Modules</title>
|
|
|
|
|
|
+ <title>&openser; Modules</title>
|
|
<para>
|
|
<para>
|
|
The following modules must be loaded before this module:
|
|
The following modules must be loaded before this module:
|
|
<itemizedlist>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<listitem>
|
|
<para>
|
|
<para>
|
|
- <emphasis>No dependencies on other &ser; modules</emphasis>.
|
|
|
|
|
|
+ <emphasis>No dependencies on other &openser; modules</emphasis>.
|
|
</para>
|
|
</para>
|
|
</listitem>
|
|
</listitem>
|
|
</itemizedlist>
|
|
</itemizedlist>
|
|
@@ -126,7 +126,7 @@ openserctl fifo flat_rotate
|
|
<title>External Libraries or Applications</title>
|
|
<title>External Libraries or Applications</title>
|
|
<para>
|
|
<para>
|
|
The following libraries or applications must be installed before running
|
|
The following libraries or applications must be installed before running
|
|
- &ser; with this module loaded:
|
|
|
|
|
|
+ &openser; with this module loaded:
|
|
<itemizedlist>
|
|
<itemizedlist>
|
|
<listitem>
|
|
<listitem>
|
|
<para>
|
|
<para>
|