Readme.md 1.8 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
12
13
14
15
16
17
18
19
20
21

#### Install python-pip for Centos/RHEL

```
yum install python-setuptools
easy_install pip
```

#### How to install python-pip for Debian/Ubuntu
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
22
apt update; apt install --no-install-recommends python-pip curl
23
24
```

Aleksey Shirokih's avatar
Aleksey Shirokih committed
25
26
27
28
29
Install docker daemon
```
curl https://get.docker.com | sudo sh 
systemctl start docker 
```
30
31
32

Install docker compose 
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
33
34
pip install docker-compose
mkdir /etc/docker-compose/tower -p
Dmitry Volodin's avatar
Dmitry Volodin committed
35
36
```

Aleksey Shirokih's avatar
Aleksey Shirokih committed
37
38
### Setup tower 
Place `docker-compose.yml` from project root to `/etc/docker-compose/tower`
39
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
40
cd /etc/docker-compose/tower
Aleksey Shirokih's avatar
Aleksey Shirokih committed
41
curl https://code.getnoc.com/noc/tower/raw/master/docker-compose.yml > /etc/docker-compose/tower/docker-compose.yml
Aleksey Shirokih's avatar
Aleksey Shirokih committed
42
docker-compose up -d 
43
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
44
That it. 
Dmitry Volodin's avatar
Dmitry Volodin committed
45

Aleksey Shirokih's avatar
Aleksey Shirokih committed
46
47
48
49
50
51
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
52

Dmitry Volodin's avatar
Dmitry Volodin committed
53

Aleksey Shirokih's avatar
Aleksey Shirokih committed
54
55
56
57
58
## 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
59

60
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
61
/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
62
```
Dmitry Volodin's avatar
Dmitry Volodin committed
63

64
## Deploying
65

Aleksey Shirokih's avatar
Aleksey Shirokih committed
66
 - Enter noc control tower.
Dmitry Volodin's avatar
Dmitry Volodin committed
67
68
69
70
   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)