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


Factory Manual: Setting up your account

<< Previous: Quickstart | Next: Using the standard factory >>

If you want to run a factory then you will first need to create an account on the CentralServer and set it up properly. You can register yourself at the website. Once you have done so you can either login using the login form or you can use an SSL client certificate and use the secure website. After your registration you will need to contact the staff and tell them that you want to run a factory. They will probably ask you a couple of questions to verify a few things and then enable your account to use factories.

About SSL certificates

SSL certificates are optional for using the central website but mandatory if you want to use the XML-RPC API. You can use any client SSL certificate signed by any well known Certificate Authority as long as your certificate's Common Name contains the same e-mail address as you have used to register your account with. If necessary you can change your account e-mail address to match the one on your certificate.

Due to a bug in Apache mod_gnutls

Get an SSL Certificate from CACert

If you do not have an SSL client certificate then you can easily get one for free from CACert. Go to the website of CACert and register for an account. When you have an account, login and in the menu go to Client Certificates. Create a new certificate and make sure you add your e-mail address to it. When CACert has created a certificate for you then you can import it in your browser by clicking a link.

Your certificate is now in your browser. If you want, you can use it to automatically login to the officeshots website. To do that, visit

Export your SSL Certificate from your browser

If you want to run a factory then you need to export your certificate from your browser and convert it into PEM format which our factory understands. In Firefox, go to Preferences => Advanced => View Certificates => Your Certificates. Click on your certificate and click Backup. You will be asked to create a password to protect your certificate. Thawte has instructions for Internet Explorer.

You now have a .p12 or a .pfx file with your certificate. The last step is to convert this to PEM format. You can do this with OpenSSL. Linux systems usually have this installed. Windows users will need to install OpenSSL themselves or ask a friend who uses Linux to convert the certificate for them. The command to convert the certificate is:

$> openssl pkcs12 -in certificate.p12 -out certificate.pem -clcerts

You will be asked to enter your backup password to read the .p12 or .pfx file and create a new password to encrypt the PEM file. Alternatively, if you do not want to encrypt the PEM file then you can use the following command.

$> openssl pkcs12 -in certificate.p12 -out certificate.pem -clcerts -nodes

Using an unencrypted PEM file is not as safe. If you have the M2Crypto python library on your computer then you can use an encrypted PEM file. If you do not have M2Crypto then you will need an unencrypted PEM file because the standard Python SSL library cannot remember your password for you.

Configuring your factory

After the staff have enabled your account for factory usage you can add factories to your account. A factory is a single computer that you have that participates in If you want to supply a Windows XP machine, a Linux machine and a smartphone then you would create three factories. To create a new factory, go to the Officeshots website and in the menu click Factories and then Add another factory. Then pick a name for it and fill in the hardware and operatingsystem fields.

Next you can start adding workers to your factory. A worker is a specific office application that runs on your factory. If your Linux machine has and Gnumeric installed then you would add four factories: Writer, Calc, Impress and Gnumeric. For every worker you need to select which office application it provides and the version number. The version number can be any string, such as 2.4 or 2003 SP2.

If you run on Linux then you need to be careful which one you pick. Many distributions of Linux do not ship but Go-OO. Go-OO is a version of that is built by Novell and it is different from the standard If you are running Ubuntu

In the future it will be possible to automatically configure your workers based on the local configuration file of your factory. For the moment you will need to create your workers manually on the website. Make sure that the worker configuration on the website matches the worker configuration on your system or you will be given jobs by the central server that your factory cannot handle.

<< Previous: Quickstart | Next: Using the standard factory >>