Readme.md 1.65 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
25
26
27
28
29
30

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

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

#### How to install python-pip for Debian/Ubuntu
```
apt install --no-install-recommends python-pip
```


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
39
systemctl start docker 
Aleksey Shirokih's avatar
Aleksey Shirokih committed
40
docker-compose up -d 
41
```
Aleksey Shirokih's avatar
Aleksey Shirokih committed
42
That it. 
Dmitry Volodin's avatar
Dmitry Volodin committed
43

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

Dmitry Volodin's avatar
Dmitry Volodin committed
51

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

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

62
## Deploying
63

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