Readme.md 1.4 KB
Newer Older
Dmitry Volodin's avatar
Dmitry Volodin committed
1
2
3
# NOC Tower
NOC Tower is the tool for deployment and maintaining multiple
NOC (http://nocproject.org/) installations.
Aleksey Shirokih's avatar
Aleksey Shirokih committed
4

Aleksey Shirokih's avatar
Aleksey Shirokih committed
5
[![build status](https://code.getnoc.com/noc/tower/badges/master/build.svg)](https://code.getnoc.com/noc/tower/commits/master)
Dmitry Volodin's avatar
Dmitry Volodin committed
6

Aleksey Shirokih's avatar
Aleksey Shirokih committed
7
## Install 
Aleksey Shirokih's avatar
Fix doc    
Aleksey Shirokih committed
8

Aleksey Shirokih's avatar
Aleksey Shirokih committed
9
The easiest method of installation and update is to use docker and docker-compose.yml 
Aleksey Shirokih's avatar
Fix doc    
Aleksey Shirokih committed
10

Aleksey Shirokih's avatar
Aleksey Shirokih committed
11
### Docker install
Dmitry Volodin's avatar
Dmitry Volodin committed
12
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
13
14
15
curl https://get.docker.com | sudo sh 
pip install docker-compose
mkdir /etc/docker-compose/tower -p
Dmitry Volodin's avatar
Dmitry Volodin committed
16
17
```

Aleksey Shirokih's avatar
Aleksey Shirokih committed
18
19
### Setup tower 
Place `docker-compose.yml` from project root to `/etc/docker-compose/tower`
20
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
21
22
cd /etc/docker-compose/tower
docker-compose up -d 
23
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
24
That it. 
Dmitry Volodin's avatar
Dmitry Volodin committed
25

Aleksey Shirokih's avatar
Aleksey Shirokih committed
26
27
28
29
30
31
Also you can choose the loong way of manual installation 
* [Debian](docs/Debian.md)
* [Centos](docs/CentOS.md)
* [Ubuntu](docs/Ubuntu.md)
* [Red Hat](docs/RHEL.md)
* [FreeBSD](docs/FreeBSD.md)
Dmitry Lukhtionov's avatar
Dmitry Lukhtionov committed
32

Dmitry Volodin's avatar
Dmitry Volodin committed
33

Aleksey Shirokih's avatar
Aleksey Shirokih committed
34
35
36
37
38
## Prepare nodes
On each node 
* double check that python2.7 is installed on nodes
* create ansible user (*ansible* by default),
* grant it passwordless `sudo` privileges and copy Tower's public ssh key (*/opt/tower/var/tower/data/deploy_keys/id_rsa.pub*) to *ansible's*
Dmitry Lukhtionov's avatar
Dmitry Lukhtionov committed
39

40
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
41
/opt/tower# docker-compose exec tower ssh-copy-id -i /opt/tower/var/tower/data/deploy_keys/id_rsa.pub ansible@192.168.1.88
42
```
Dmitry Volodin's avatar
Dmitry Volodin committed
43

44
## Deploying
45

Aleksey Shirokih's avatar
Aleksey Shirokih committed
46
 - Enter noc control tower.
Dmitry Volodin's avatar
Dmitry Volodin committed
47
48
49
50
   Open http://<IP>:8888/ in your browser. Login as admin/admin

 Do not forget to change tower's admin password
 (Upper right menu > Change Password)