Changes between Version 12 and Version 13 of FactoryManual/StandardFactory

Timestamp:

07/07/10 09:20:55 (11 years ago)

Author:

sander

Comment:

--

FactoryManual/StandardFactory

@@ -98 +98 @@
 == Running the standard factory == #Running
 
-To run the standard factory, execute the `src/factory.py` script. There are a couple of extra commandline arguments that you can pass to this script.
+To run the standard factory, execute the `src/factory.py` script with one of the commands {{{start}}}, {{{stop}}} or {{{restart}}}.
+
+ start::
+    Start the factory.
+ stop::
+    If the factory is running as a daemon, stop it.
+ restart::
+    If the factory is running as a daemon, restart it.
+
+There are a couple of extra commandline arguments that you can pass to this script.
 
  --?, --h, --help::
     Show the help on the commandline options. 
- -c, --condig::
+ -c, --config::
     Full path to the configuration file to use. By default conf/config.ini is used. 
  -d, --debug::
-    Turn on debugging. When debugging is on the `log_level` will be set to debug, all log messages will appear on the console
+    Turn on debugging. When debugging is on the factory will not run as a daemon, `log_level` will be set to debug, all log messages will appear on the console
     and all XML-RPC requests and responses will be echoed.
 
@@ -112 +121 @@
 [[NoteBox(note, Please install some extra fonts on the machine that you are running the factory. Fonts itself are not part of the ODF specification but are part of the system that the application is running on. Officeshots serves an international audience. If someone uploads a document with Chinese characters but you do not have such a font installed, the result will not look good and the user could assume that the application does not work correctly, even though it does. So, please make sure that you have Western, Cyrillic and basic Asian fonts installed. Linux users, please consider installing the MSFT core font package, or install the free Liberation replacement fonts from Red Hat.)]]
 
+== Running as a service ==
+
+There is an init script for running the factory as a system service in Debian and derivative Linux distributions. You can find this init script in {{{utils/officeshots-factory}}}. Note that this init script depends on the {{{oooserver}}} init script for running !OpenOffice.org as a service. If you do not run !OpenOffice.org in your factory, remove the dependency on {{{oooserver}}} from the top of the init script.
+
+To use the script, copy it to {{{/etc/init.d/officeshots-factory}}} and edit the configuration settings in the file. Then execute the following command to install it to the proper runlevels:
+
+{{{# update-rc.d officeshots-factory defaults}}}
+
+[[NoteBox(warn, Make sure that you are using non-encrypted SSL client certificates when you run the factory as a service. If you use encrypted certificates then the factory will promt for your password every time you boot, shutdown, etcetera.)]]
+
 [../Setup << Previous: Setting up your account] | [./OOOServer Next: OOOServer backend >>]