nedimredzovic/ignite

Fire up your network with built-in poap on your Cisco Nexus switches and Ignite.

----

Description

Ignite is a tool to bootstrap your network. It supports Cisco Nexus switches leveraging Power-On Auto Provisioning (POAP) capabilities.

Ignite provides bootstrapping with the following capabilities:

• Topology design
• Configuration design
• Image and configuration store for POAP
• POAP request handler

Getting Started

Option 1: Download OVA from link below:

https://cisco.box.com/s/f7xdzs6mnltsbdccdr1uamda0txrr5w0

Username/password: ignite/ignite

Follow steps below

a. Deploy OVA
b. Login with ignite/ignite
c. Change directory to ~/ignite/ignite (cd ~/ignite/ignite)
d. Change to sudo (sudo su)
e. Edit configure.sh to edit parameter values of following parameters
   	ignite_ip :  IP address on which to run the server
    ignite_port: port on which to run the server
    vmusername: username for the server
    vmpassword: password for the server
f. Run configure.sh (sh configure.sh)
g. Run ignite server (python manage.py runserver ip:port ) where IP is the address provided in ignite_ip and port is value provided in ignite_port.
h. To launch UI use http://<ipaddress>:<port>/ui/index.html
i. Use New User registration link in the UI to create a new user credential. Login to the page using this credential.

Option 2: Create a new Ignite VM/Server with code from git

1.Install postgresql

apt-get install postgresql-9.3 postgresql-common

2.Set up database

psql  –U postgres
create database  DATABASE_NAME;
\q

Edit following section in ~/ignite/ignite/prod.py

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2', # Add 'postgresql_psycopg2', 'mysql', 'sqlite3' or 'oracle'.
        'NAME': ‘DATABASE_NAME’,                  #Name of database created
        'USER': 'postgres',                       #Database User
        'PASSWORD': 'PASSWORD',                   #password for Database user
        'HOST': 'localhost',                      # Empty for localhost through domain sockets or           '127.0.0.1' for localhost through TCP.
        'PORT': '',                      # Set to empty string for default.
    }
}

3.Create tables in database

python ~ignite/ignite/manage.py makemigrations
python ~ignite/ignite/manage.py migrate

4.Edit following line ~ignite/ignite/dist/scripts/utils/settings.*.js to ignite server ip and port (8000).

"baseURL" : "http://localhost:9010"

to

"baseURL" : "http://<ignite_vm_ip>:<port>"

5.Run server

python manage.py runserver <ip:port>

6.Run UI on web browser To launch UI use http://:/ui/index.html Use New User registration link in the UI to create a new user credential. Login to the page using this credential.

Installing poap.py in the script server

1.Ignite_poap.py – sample poap.py script is available in github

2.Modify ignite_poap.py to assign ip address and port number of the ignite server (see the ip address and port number used while executing manage.py run server)

	a. Search for “ignite server� in poap.py and change the following values
		#ignite server
		hostname = "172.31.219.76"
		port = "8001"
	b. Save the changes
	c. Copy and rename the file to “poap.py� in the script server directory /var/lib/tftpboot

3.Please note, poap.py should be installed in the script server whose address is returned in the DHCP OFFER during the dhcp discover process

Image Profiles

Image profiles specify details of the software images available for download to the switch during POAP process. Following atttributes define an image profile: {

"image_profile_name": "spine_image", 
"image": "n9000-dk9.6.1.2.I3.2.bin",
"imageserver_ip": "172.31.216.138",
"username": "root",
"password": "cisco123",
"access_protocol": "scp"

}

image_profile_name - uniquely identifies the profile

image - filename where the image is stored

imageserver_ip : server where the image is stored

username - username to login to the image server

password - password to login to the image server

access_protocol - ftp/http/scp/tftp protocol used to transfer files from server

Image profiles are stored in ignite/fabric/image_profile.py. The profiles should be modified to match your image needs and environment. New profiles can be added similar to the pre-defined ones. spine_image, leaf_image and default_image are example profiles. An image profile is applied to spine tier or leaf tier of the fabric using "Set Defaults" in "Fabrics" view. Once applied, this image profile will be sent to the switch during the POAP boot process along with start up config details. If image profile is not applied, profile named "default_image" is sent to the switch during POAP boot process.

License

Copyright 2015 Cisco Systems, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.