wiki:FactoryManual/Quickstart

Version 2 (modified by sander, 8 years ago) (diff)

--

Factory Manual: Quickstart

<< Previous: Factory Manual | Next: Setting up your account >>

For the impatient, here follows a quick rundown of the steps that you need to do in order to run your own Officeshots factory for OpenOffice?.org on Linux or Windows.

  1. Register for an account on the Officeshots website, activate your acount and let us know that you want to run a factory. See Setting up your account.

  2. Get an SSL client certificate if you do not have one yet. See Get an SSL Certificate from CACert.

  3. Log in on the Officeshots website, create a new factory, give it a nice name and add application workers to it. Add OpenOffice.org Calc, Impress and Writer separately. See Configuring your factory. Linux users, please check if you need to add OpenOffice.org or Go-OO. Ubuntu and Debian ship with Go-OO and not with OpenOffice.org

  4. Install OpenOffice.org, Python and the Python UNO bridge. Windows users need Python 2.6 and can find the UNO bridge when the choose Custom install when installing OpenOffice.org. Linux users will want to install the Python M2Crypto library as well.

  5. Download the latest Officeshots factory using Subversion. If you do not have Subversion then you can download a tar.gz package, but Subversion is better.
    $> svn checkout http://code.officeshots.org/officeshots/trunk/factory
    
  6. Copy conf/config.default.ini to conf/config.ini. Set the correct path for your SSL key and certificate file. Linux users should make sure that log_file is writeable or change the path. Windows users should set transport to pyssl and set correct paths for log_file and tmp_files. See Configuring backends.

  7. In the oooserver- sections, check that the version number is correct. Windows users should also remove the ooo_host and ooo_port options and uncomment the ooo_pipe option. See OOOServer.

  8. Start OpenOffice.org in headless mode. Linux users can execute:
    $> soffice -headless -nologo -norestore \
       -accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager
    
    Windows users should edit utils/oooserver.bat and run that file. See Running OpenOffice.org in headless mode.

  9. Start the factory. On Linux, simply run the src/factory.py script. On windows, edit utils/ooofactory.bat and execute it. See Running the standard factory.

After all that, your factory should be up and running. If it does not, please read the remaining chapters of this manual or ask us for help on the Officeshots mailinglist.

<< Previous: Factory Manual | Next: Setting up your account >>