Skip to content
This repository was archived by the owner on Oct 16, 2020. It is now read-only.

Commit a871899

Browse files
jaywcarmanjaywcarman
committed
feat: Add support for RHEL 7 deployer
Running RHEL 7 on the deployer node is fully supported. Change-Id: Iaaea23314b9f8b7ea8facd053ac07c48aa00ba88
1 parent d8dd62c commit a871899

15 files changed

+901
-877
lines changed

‎.gitignore

+1
Original file line numberDiff line numberDiff line change
@@ -15,3 +15,4 @@ playbooks/.facts
1515
config-backup.yml
1616
playbooks/known_hosts
1717
debug_data/
18+
playbooks/lxc.conf

‎README.rst

-1
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,6 @@ Deployer Node Installation
6161

6262
::
6363

64-
$ sudo apt update; sudo apt install git
6564
$ git clone https://github.com/open-power-ref-design/cluster-genesis.git
6665
$ cd cluster-genesis
6766
$ ./scripts/install.sh

‎docs/Appendix-A.rst

+138-126
Original file line numberDiff line numberDiff line change
@@ -1,126 +1,138 @@
1-
.. highlight:: none
2-
3-
Appendix - A Cheat Sheet
4-
========================
5-
6-
**Setting up the Deployer Node**
7-
8-
- Install Ununtu 14.04LTS or 16.04LTS to the deployer node. Insure SSH
9-
login is enabled.
10-
- Install the vim, vlan and bridge-utils packages::
11-
12-
$ apt-get update
13-
$ apt-get install vim vlan bridge-utils
14-
15-
16-
**Installing the OpenPOWER Cluster Genesis Software**::
17-
18-
$ export GIT_SSL_NO_VERIFY=1
19-
20-
- Change the root password to passw0rd::
21-
22-
$ sudo passwd root (set to passw0rd)
23-
24-
- If the root account does not exist (is not unlocked)::
25-
26-
$ sudo passwd root (then enter passw0rd twice)
27-
$ sudo -u root (to unlock the root passwd) (to lock again after running genesis: sudo passwd -l root)
28-
29-
- Install git::
30-
31-
$ sudo apt-get install git
32-
$ git clone https://github.com/open-power-ref-design/cluster-genesis
33-
34-
**Running the OpenPOWER Cluster Genesis Software**::
35-
36-
$ cd cluster-genesis
37-
$ ./scripts/install.sh (this will take a few minutes to complete)
38-
$ source scripts/setup-env (if you restart your shell session, you need to re-execute this and the next line.
39-
$ export ANSIBLE_HOST_KEY_CHECKING=False
40-
41-
- copy your config.yml file to the /cluster-genesis directory
42-
- create the Genesis container::
43-
44-
$ cd playbooks
45-
$ ansible-playbook -i hosts lxc-create.yml -K (create container. Verify container networks)
46-
47-
To begin cluster genesis::
48-
49-
$ ansible-playbook -i hosts install.yml -K (begins cluster genesis)
50-
Allow several minutes to run.
51-
52-
53-
After the command prompt returns, run the following to see the status/progress of
54-
operating system load for each cluster node::
55-
56-
sudo cobbler status (from within container at /home/deployer/cluster-genesis)
57-
58-
**Configuring networking on the cluster nodes**::
59-
60-
$ ansible-playbook -i ../scripts/python/cluster-genesis/inventory.py gather_mac_addresses.yml -u root --private-key=~/.ssh/id\_rsa\_ansible-generated
61-
$ ansible-playbook -i ../scripts/python/cluster-genesis/inventory.py configure\_operating\_systems.yml -u root --private-key=~/.ssh/id\_rsa\_ansible-generated
62-
63-
**Accessing the deployment container**
64-
65-
- To see a list of containers on the deployer::
66-
67-
$ sudo lxc-ls
68-
69-
- To access the container as root::
70-
71-
$ sudo lxc-attach -n yourcontainername
72-
73-
alternately, you can ssh into the container;
74-
75-
To get the login information::
76-
77-
$ grep "^deployer" ~/cluster-genesis/playbooks/hosts
78-
79-
deployer ansible_user=deployer ansible_ssh_private_key_file=/home/ubuntu/.ssh/id_rsa_ansible-generated ansible_host=192.168.0.2
80-
81-
Logging into the container as user "deployer"::
82-
83-
$ ssh -i ~/.ssh/id\_rsa\_ansible-generated [email protected]
84-
85-
Notes:
86-
87-
- if you change the ip address of the container, (ie if you recreate
88-
the container) you may need to replace the cached ECDSA host key in
89-
the .ssh/known\_hosts file::
90-
91-
$ ssh-keygen -R container-ip-address
92-
93-
- if you reboot the deployer node you need to restart the deployment
94-
container::
95-
96-
$ lxc-start -d -n <container name>
97-
98-
Checking the Genesis Log
99-
100-
Genesis writes status and error messages to;
101-
/home/deployer/cluster-genesis/log.txt
102-
103-
You can display this file::
104-
105-
$ cat /home/deployer/cluster-genesis/log.txt
106-
107-
**Checking the DHCP lease table**
108-
109-
From within the container::
110-
111-
$ cat /var/lib/misc/dnsmasq.leases
112-
113-
**Logging into the cluster nodes**
114-
115-
from the deployer node (host namespace)::
116-
117-
$ ssh -i ~/.ssh/id_rsa_ansible-generated [email protected]
118-
119-
or as root::
120-
121-
$ ssh -i ~/.ssh/id_rsa_ansible-generated [email protected] #(as root -i not needed from cluster nodes)
122-
123-
with password; from deployer or cluster node::
124-
125-
$ ssh [email protected] # password: password-default (from config.yml)
126-
1+
.. highlight:: none
2+
3+
Appendix - A Cheat Sheet
4+
========================
5+
6+
**Setting up the Deployer Node**
7+
8+
- Deployer OS Requirements:
9+
- Ubuntu
10+
- Release 14.04LTS or 16.04LTS
11+
- SSH login enabled
12+
- sudo priviledges
13+
- RHEL
14+
- Release 7.x
15+
- Extra Packages for Enterprise Linux (EPEL) repository enabled
16+
(https://fedoraproject.org/wiki/EPEL)
17+
- SSH login enabled
18+
- sudo priviledges
19+
20+
**Installing the OpenPOWER Cluster Genesis Software**::
21+
22+
$ export GIT_SSL_NO_VERIFY=1
23+
24+
- Change the root password to passw0rd::
25+
26+
$ sudo passwd root (set to passw0rd)
27+
28+
- If the root account does not exist (is not unlocked)::
29+
30+
$ sudo passwd root (then enter passw0rd twice)
31+
$ sudo -u root (to unlock the root passwd) (to lock again after running genesis: sudo passwd -l root)
32+
33+
- Install git
34+
- Ubuntu::
35+
36+
$ sudo apt-get install git
37+
38+
- RHEL::
39+
40+
$ sudo yum install git
41+
42+
- From your home directory, clone Cluster Genesis::
43+
44+
$ git clone https://github.com/open-power-ref-design/cluster-genesis
45+
46+
**Running the OpenPOWER Cluster Genesis Software**::
47+
48+
$ cd cluster-genesis
49+
$ ./scripts/install.sh (this will take a few minutes to complete)
50+
$ source scripts/setup-env (if you restart your shell session, you need to re-execute this and the next line.
51+
$ export ANSIBLE_HOST_KEY_CHECKING=False
52+
53+
- copy your config.yml file to the /cluster-genesis directory
54+
- create the Genesis container::
55+
56+
$ cd playbooks
57+
$ ansible-playbook -i hosts lxc-create.yml -K (create container. Verify container networks)
58+
59+
To begin cluster genesis::
60+
61+
$ ansible-playbook -i hosts install.yml -K (begins cluster genesis)
62+
Allow several minutes to run.
63+
64+
65+
After the command prompt returns, run the following to see the status/progress of
66+
operating system load for each cluster node::
67+
68+
sudo cobbler status (from within container at /home/deployer/cluster-genesis)
69+
70+
**Configuring networking on the cluster nodes**::
71+
72+
$ ansible-playbook -i ../scripts/python/cluster-genesis/inventory.py gather_mac_addresses.yml -u root --private-key=~/.ssh/id\_rsa\_ansible-generated
73+
$ ansible-playbook -i ../scripts/python/cluster-genesis/inventory.py configure\_operating\_systems.yml -u root --private-key=~/.ssh/id\_rsa\_ansible-generated
74+
75+
**Accessing the deployment container**
76+
77+
- To see a list of containers on the deployer::
78+
79+
$ sudo lxc-ls
80+
81+
- To access the container as root::
82+
83+
$ sudo lxc-attach -n yourcontainername
84+
85+
alternately, you can ssh into the container;
86+
87+
To get the login information::
88+
89+
$ grep "^deployer" ~/cluster-genesis/playbooks/hosts
90+
91+
deployer ansible_user=deployer ansible_ssh_private_key_file=/home/ubuntu/.ssh/id_rsa_ansible-generated ansible_host=192.168.0.2
92+
93+
Logging into the container as user "deployer"::
94+
95+
$ ssh -i ~/.ssh/id\_rsa\_ansible-generated [email protected]
96+
97+
Notes:
98+
99+
- if you change the ip address of the container, (ie if you recreate
100+
the container) you may need to replace the cached ECDSA host key in
101+
the .ssh/known\_hosts file::
102+
103+
$ ssh-keygen -R container-ip-address
104+
105+
- if you reboot the deployer node you need to restart the deployment
106+
container::
107+
108+
$ lxc-start -d -n <container name>
109+
110+
Checking the Genesis Log
111+
112+
Genesis writes status and error messages to;
113+
/home/deployer/cluster-genesis/log.txt
114+
115+
You can display this file::
116+
117+
$ cat /home/deployer/cluster-genesis/log.txt
118+
119+
**Checking the DHCP lease table**
120+
121+
From within the container::
122+
123+
$ cat /var/lib/misc/dnsmasq.leases
124+
125+
**Logging into the cluster nodes**
126+
127+
from the deployer node (host namespace)::
128+
129+
$ ssh -i ~/.ssh/id_rsa_ansible-generated [email protected]
130+
131+
or as root::
132+
133+
$ ssh -i ~/.ssh/id_rsa_ansible-generated [email protected] #(as root -i not needed from cluster nodes)
134+
135+
with password; from deployer or cluster node::
136+
137+
$ ssh [email protected] # password: password-default (from config.yml)
138+

0 commit comments

Comments
 (0)