Changes between Version 1 and Version 2 of FactoryManual/Setup


Ignore:
Timestamp:
06/26/09 15:07:32 (8 years ago)
Author:
sander
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • FactoryManual/Setup

    v1 v2  
    99SSL certificates are optional for using the central Officeshots.org website but mandatory if you want to use the [wiki:XMLRPC 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. 
    1010 
     11[[NoteBox(note,  Due to a bug in Apache mod_gnutls, the development server currently only accepts client certificates that are signed by CACert.)]] 
     12 
     13=== Get an SSL Certificate from CACert === #CACert 
     14 
     15If you do not have an SSL client certificate then you can easily get one for free from [http://www.cacert.org 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. 
     16 
     17Your certificate is now in your browser. If you want, you can use it to automatically login to the officeshots website. To do that, visit https://www.officeshots.org.  
     18 
     19=== Export your SSL Certificate from your browser === 
     20 
     21If 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 [https://search.thawte.com/support/ssl-digital-certificates/index?page=content&id=SO552 instructions for Internet Explorer]. 
     22 
     23You 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: 
     24 
     25{{{ 
     26$> openssl pkcs12 -in certificate.p12 -out certificate.pem -clcerts 
     27}}} 
     28 
     29You 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.  
     30 
     31{{{ 
     32$> openssl pkcs12 -in certificate.p12 -out certificate.pem -clcerts -nodes 
     33}}} 
     34 
     35Using 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.  
     36 
     37== Configuring your factory == 
     38 
     39After the Officeshots.org 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 Officeshots.org. 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. 
     40 
     41Next 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 !OpenOffice.org and Gnumeric installed then you would add four factories: ''!OpenOffice.org Writer'', ''!OpenOffice.org Calc'', ''!OpenOffice.org 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''.  
     42 
     43[[NoteBox(note, If you run !OpenOffice.org on Linux then you need to be careful which one you pick. Many distributions of Linux do not ship !OpenOffice.org but Go-OO. Go-OO is a version of !OpenOffice.org that is built by Novell and it is different from the standard !OpenOffice.org. If you are running Ubuntu, Debian, Frugalware or Gentoo then you are running Go-OO and not !OpenOffice.org. Please pick Go-OO in the application dropdown.)]] 
     44 
     45[[NoteBox(note, 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 Officeshots.org 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.)]] 
     46 
    1147[../Quickstart << Previous: Quickstart] | [../StandardFactory Next: Using the standard factory >>]