Readme.md 1.77 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
curl https://get.docker.com | sudo sh 
14
15
16
17
18
19
20
21
22
23
24

```
#### 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
25
apt install --no-install-recommends python-pip curl
26
27
28
29
30
```


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

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

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

Dmitry Volodin's avatar
Dmitry Volodin committed
52

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

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

63
## Deploying
64

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