Improve error reporting in astakos
[kamaki] / docs / overview.rst
1 Overview
2 ========
3
4 History
5 -------
6
7 Here, at the `Greek Research and Technology Network <http://grnet.gr/default.asp?pid=1&la=2>`_, we have been developing an IaaS
8 cloud management software called **synnefo** (or **+nefo**) that is accessed and managed 
9 via the OpenStack Compute API v1.1. We have also recently deployed synnefo in one of our
10 datacenters to provide the `~okeanos <http://okeanos.grnet.gr/>`_ IaaS service to the Greek Research and Academic 
11 Community (currenty in alpha testing phase).
12
13 From the early start, we needed a simple command-line tool to test the OpenStack API.
14 That's why we developed ./kamaki, which proved to be powerful and intuitive enough,
15 to be used not only for testing purposes but also as a complete Openstack Compute API v1.1
16 client, able to manage our cloud from the command line.
17
18 Once it proved so useful to us, we decided to open the source, so the community can benefit
19 from it, and ./kamaki can benefit from the community too.
20
21
22 Who uses ./kamaki?
23 ------------------
24
25 ./kamaki is currently used internally in GRNET by the development team to test the synnefo
26 software, by the deployment team who operates the ~okeanos service and by all the alpha 
27 testers using the ~okeanos service and want to access the service from the command line.
28
29
30 Contributing and helping out
31 ----------------------------
32
33 For the ./kamaki to improve and be useful to others too, your help is very important.
34 Any contributions and bug reports will be highly appreciated. Using ./kamaki and sending
35 us feedback is also a good start.
36
37
38 Community & Support
39 -------------------
40
41 For any problems you may bump into while using ./kamaki or for help from the development
42 team please refer to the following links:
43
44 * Feedback: kamaki-feedback@lists.grnet.gr
45 * Bug-reports: kamaki-bugs@lists.grnet.gr
46 * Support: kamaki-support@lists.grnet.gr
47 * Appear on the ./kamaki users section: kamaki-users@lists.grnet.gr
48
49 Please be sure to have read the Documentation and check the known `issues <https://code.grnet.gr/projects/kamaki/issues>`_ before
50 contacting the team.
51