Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 2.85 KB

README.md

File metadata and controls

87 lines (62 loc) · 2.85 KB

Hatohol Client

Hatohol Client is a frontend part of Hatohol and provides a web UI based on Django.

Table of Contents

Required software and settings

  • Python 2.6
  • Django 1.5
  • JavaScript enabled (web browser side)

Containing modules

This application contains following foreign modules. Thanks a lot!

How to setup

See also this page to setup Hatohol for CentOS with the binary packages.

Install Hatohol Client

Hatohol Client is written as PATH FREE. So you can place it anywhere.

Install Required Libraries

The following shows examples to install Required Packages.

On CentOS 7

# yum install python-pip python-devel django gettext
# pip install mysql-python

On Ubuntu 12.04 and 14.04

$ sudo apt-get install python-pip python-dev python-django gettext
$ sudo pip install mysql-python

Create the database

$ mysql -u root -p
Enter password:(input password)

mysql> CREATE DATABASE hatohol_client DEFAULT CHARACTER SET utf8;
mysql> GRANT ALL PRIVILEGES ON hatohol_client.* TO hatohol@localhost IDENTIFIED BY 'hatohol';

Create the database and the tables

You must change the current directory to "client" under the top directory.

$ ./manage.py syncdb

How to run

Hatohol Client is a standard Django project. So you can run it on any WSGI compliant application server.

You must change the current directory to "client" under the top directory.

Alternatively you can run with a runserver sub-command of Django's manage.py.

$ ./manage.py runserver

If you allow to access from the outside, you need specifying the address like

$ ./manage.py runserver 0.0.0.0:8000

Hints

How to set a Hatohol server address and the port

Edit hatohol/hatoholserver.py and update the following lines.

DEFAULT_SERVER_ADDR = 'localhost'
DEFAULT_SERVER_PORT = 33194