Icon

    This is the documentation for for an older version of Qube.

    Documentation for the latest release is available here.

    System Requirements

    QubeMobileServer as a pre-compiled binary: 

    None. All required packages are included.

    QubeMobileServer as a python script (in interpreted mode):

    1. Python 2.6 or newer to run with SSL. Python 2.4 or newer is required if not running over ssl. The server is 100% python.

    Windows only: QubeMobile Server requires Python (no older than v2.5, 2.7 recommended) be installed. We recommend ActiveState Python on Windows, since it will add itself to the registry and system search PATH.  Please read the requirements for SSL further down this page

    2. PyOpenSSL [optional]: QubeMobileServer can be run over SSL for added security. If the user does not already have a signed SSL certificate, QubeMobileServer will create a self-signed certficate for its own use. Doing so requires PyOpenSSL. PyOpenSSL is compiled into the pre-built binary for Linux and OS X, but not Windows. Regardless of the OS, you can generate your own certficate and key file outside of qubeMobileServer with the following command:

    openssl req -new -x509 -days 365 -nodes -out qubeMobileServer.crt -keyout qubeMobileServer.key

    Doing so will be necessary for those who are running the server on Windows, choose to run the server over ssl, and do not already have a signed certificate. Running the above command will prompt you for several questions -- answer them accordingly as they pertain to you/your company (there are no right or wrong answers).  When the command completes, you will have two files: qubeMobileServer.crt and qubeMobileServer.key.  Move those files into a directory called "certs" that lives next to qubeMobileServer[.py].  Now you can start start with --ssl (or --force-ssl on Windows)

    3. Mako Templates [supplied]. The actual web pages are rendered with Mako templates.

    Additional Requirements for SSL Support

    OS X and Linux: 

    No additional requirements

    Windows

    PyOpenSSL is not included with the Windows binary, so Windows machines cannot generate their own self-signed certificates.  Windows machines may generate their own certficates outside of qubeMobileServer if they choose.

    Python versions and SSL support on Windows

    Python versions prior to 2.6 on Windows provide no SSL support at all

    Python versions 2.6  and later on Windows:

      • provides SSL for the server
      • cannot generate certificates; the cert must be generated outside of the server as outlined in the PyOpenSSL note at the top of this page.

     

    • No labels