Install and configure for Ubuntu

This section describes how to install and configure the freecell service for Ubuntu 14.04 (LTS).

Prerequisites

Before you install and configure the freecell service, you must create a database, service credentials, and API endpoints.

  1. To create the database, complete these steps:

    • Use the database access client to connect to the database server as the root user:

      $ mysql -u root -p
      
    • Create the freecell_solver database:

      CREATE DATABASE freecell_solver;
      
    • Grant proper access to the freecell_solver database:

      GRANT ALL PRIVILEGES ON freecell_solver.* TO 'freecell_solver'@'localhost' \
        IDENTIFIED BY 'FREECELL_SOLVER_DBPASS';
      GRANT ALL PRIVILEGES ON freecell_solver.* TO 'freecell_solver'@'%' \
        IDENTIFIED BY 'FREECELL_SOLVER_DBPASS';
      

      Replace FREECELL_SOLVER_DBPASS with a suitable password.

    • Exit the database access client.

      exit;
      
  2. Source the admin credentials to gain access to admin-only CLI commands:

    $ . admin-openrc
    
  3. To create the service credentials, complete these steps:

    • Create the freecell_solver user:

      $ openstack user create --domain default --password-prompt freecell_solver
      
    • Add the admin role to the freecell_solver user:

      $ openstack role add --project service --user freecell_solver admin
      
    • Create the freecell_solver service entities:

      $ openstack service create --name freecell_solver --description "freecell" freecell
      
  4. Create the freecell service API endpoints:

    $ openstack endpoint create --region RegionOne \
      freecell public http://controller:XXXX/vY/%\(tenant_id\)s
    $ openstack endpoint create --region RegionOne \
      freecell internal http://controller:XXXX/vY/%\(tenant_id\)s
    $ openstack endpoint create --region RegionOne \
      freecell admin http://controller:XXXX/vY/%\(tenant_id\)s
    

Install and configure components

  1. Install the packages:

    # apt-get update
    
    # apt-get install
    
  1. Edit the /etc/freecell_solver/freecell_solver.conf file and complete the following actions:

    • In the [database] section, configure database access:

      [database]
      ...
      connection = mysql+pymysql://freecell_solver:FREECELL_SOLVER_DBPASS@controller/freecell_solver
      

Finalize installation

Restart the freecell services:

# service openstack-freecell_solver-api restart