{ "info": { "author": "Mike Timm", "author_email": "mtimm@cisco.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Natural Language :: English", "Programming Language :: Python", "Programming Language :: Python :: 2.7" ], "description": "wiper\n=====\n\nWipe and reprovision a Cisco ACI APIC over CIMC Serial Over LAN.\n\nOptions for config arguments\n----------------------------\n\nOptions can be set via the CLI as command line arguments or in an ini file that is specified with\nthe -i/--ini-file option. The order of precedence is as follows:\n\n1. CLI options override all options set elsewhere.\n2. INI file options for a specific APIC override default options specified in the INI file.\n3. INI file options in a DEFAULT section will be used as a last resort if that option is not\n specified elsewhere.\n4. Any missing options will result in the script not running.\n\nBecause there are so many required options it is highly recommended that options be set in an INI\nfile.\n\nThe following is a table of required config arguments:\n\n +--------------------------+---------------+-----------------------+\n | **Long CLI** | **Short CLI** | **INI File** |\n | **Option** | **Option** | **Option** |\n +--------------------------+---------------+-----------------------+\n | --controller-number | -cnu | controller_number |\n +--------------------------+---------------+-----------------------+\n | --strong-passwords | -sp | strong_passwords |\n +--------------------------+---------------+-----------------------+\n | --infra-vlan-id | -iv | infra_vlan_id |\n +--------------------------+---------------+-----------------------+\n | --fabric-name | -f | fabric_name |\n +--------------------------+---------------+-----------------------+\n | --cimc-username | -cu | cimc_username |\n +--------------------------+---------------+-----------------------+\n | --controller-name | -cna | controller_name |\n +--------------------------+---------------+-----------------------+\n | --apic-admin-password | -ap | apic_admin_password |\n +--------------------------+---------------+-----------------------+\n | --bd-mc-addresses | -b | bd_mc_addresses |\n +--------------------------+---------------+-----------------------+\n | --cimc-password | -cp | cimc_password |\n +--------------------------+---------------+-----------------------+\n | --oob-default-gateway | -od | oob_default_gateway |\n +--------------------------+---------------+-----------------------+\n | --int-speed | -is | int_speed |\n +--------------------------+---------------+-----------------------+\n | --oob-ip-address | -oi | oob_ip_address |\n +--------------------------+---------------+-----------------------+\n | --tep-address-pool | -t | tep_address_pool |\n +--------------------------+---------------+-----------------------+\n | --number-of-controllers | -nc | number_of_controllers |\n +--------------------------+---------------+-----------------------+\n\nCLI Options\n-----------\n\nThe only required CLI option is the CIMC IP address which is used to log into CIMC. All other\noptions can also be set via an INI file. CLI options override the same option set in an INI file.\n\nWiper has the following CLI options::\n\n $ wiper -h\n usage: Provision APICs via CIMC Serial Over LAN [-h] [-ap APIC_ADMIN_PASSWORD]\n [-b BD_MC_ADDRESSES]\n [-cna CONTROLLER_NAME]\n [-cnu CONTROLLER_NUMBER]\n [-cp CIMC_PASSWORD]\n [-cu CIMC_USERNAME]\n [-i INI_FILE]\n [-is {auto,10baseT/Half,10baseT/Full,100baseT/Half,100baseT/Full,1000baseT/Full}]\n [-iv INFRA_VLAN_ID]\n [-f FABRIC_NAME]\n [-nc NUMBER_OF_CONTROLLERS]\n [-od OOB_DEFAULT_GATEWAY]\n [-oi OOB_IP_ADDRESS] [-sim]\n [-sp {Y,n}]\n [-t TEP_ADDRESS_POOL] [-v]\n cimc_ip\n \n positional arguments:\n cimc_ip CIMC hostname or IP address used to ssh to CIMC\n\n optional arguments:\n -h, --help show this help message and exit\n -ap APIC_ADMIN_PASSWORD, --apic_admin_password APIC_ADMIN_PASSWORD\n The APIC admin user password to enter into the APIC\n setup script.\n -b BD_MC_ADDRESSES, --bd-mc-addresses BD_MC_ADDRESSES\n The Bridge Domain Multicast address range to enter\n into the APIC setup script.\n -cna CONTROLLER_NAME, --controller-name CONTROLLER_NAME\n The controller name to enter into the APIC setup\n script.\n -cnu CONTROLLER_NUMBER, --controller_number CONTROLLER_NUMBER\n The controller number (id) to enter into the APIC\n setup script.\n -cp CIMC_PASSWORD, --cimc_password CIMC_PASSWORD\n CIMC password\n -cu CIMC_USERNAME, --cimc_username CIMC_USERNAME\n CIMC username\n -i INI_FILE, --ini-file INI_FILE\n Use an ini file to find parameters to provision an\n APIC.\n -is {auto,10baseT/Half,10baseT/Full,100baseT/Half,100baseT/Full,1000baseT/Full}, --int-speed {auto,10baseT/Half,10baseT/Full,100baseT/Half,100baseT/Full,1000baseT/Full}\n -iv INFRA_VLAN_ID, --infra-vlan-id INFRA_VLAN_ID\n The infra vlan id to enter into the APIC setup script.\n -f FABRIC_NAME, --fabric-name FABRIC_NAME\n The fabric name to enter into the APIC setup script.\n -nc NUMBER_OF_CONTROLLERS, --number-of-controllers NUMBER_OF_CONTROLLERS\n The number of controllers to enter into the APIC setup\n script.\n -od OOB_DEFAULT_GATEWAY, --oob-default-gateway OOB_DEFAULT_GATEWAY\n The APIC Out-Of-Band default gateway to enter into the\n APIC setup script.\n -oi OOB_IP_ADDRESS, --oob-ip-address OOB_IP_ADDRESS\n The APIC Out-Of-Band IP address to enter into the APIC\n setup script.\n -sim, --simulator This flag identifies the APIC as a simulator.\n -sp {Y,n}, --strong-passwords {Y,n}\n Strong password option to enter into the APIC setup\n script.\n -t TEP_ADDRESS_POOL, --tep-address-pool TEP_ADDRESS_POOL\n The TEP address pool to enter into the APIC setup\n script.\n -v, --verbose Enable debugging and be verbose.\n\nINI file options\n----------------\n\nThe following is a **recommended** ini file::\n\n ; These default settings can be modified to allow for different defaults for your environment.\n ; You can override these defaults in sections for specific controllers.\n [DEFAULT]\n ; Simulators are not currently supported but the plan is to eventually support them if possible\n ; So this is in preparation of that.\n simulator = False\n ; A default cimc user to access the Serial Over LAN with\n cimc_username = admin\n ; A default cimc password\n cimc_password = password\n ; The default fabric name.\n fabric_name = ACI Fabric1\n ; The default controller number.\n controller_number = 1\n ; The default number of controllers for all clusters.\n number_of_controllers = 3\n ; The default controller name is 'apic' + the controller id. So for controller 1, the default\n ; name is apic1. For controller 2 the default name is apic2, etc.\n controller_name = apic%(controller_number)s\n ; The default tep address pool.\n tep_address_pool = 10.0.0.0/16\n ; The default infra vlan id.\n infra_vlan_id = 4093\n ; The default BD Multicast Address pool\n bd_mc_addresses = 225.0.0.0/15\n ; The default oob ip address and netmask in the firm x.x.x.x/y\n oob_ip_address = 192.168.10.1/24\n ; The default oob default gateway ip address.\n oob_default_gateway = 192.168.10.254\n ; The default interface speed and duplex, we default to auto\n int_speed = auto\n ; By default we require strong passwords\n strong_passwords = Y\n ; A default admin password. Usually the individual apic configs will override this.\n apic_admin_password = p@s$w0rd\n \n ; Sections are defined by the cimc ip address, items defined in sections override the default items\n [172.16.176.191]\n fabric_name = 176_fabric3\n cimc_password = Cisco123!\n controller_number = 1\n oob_ip_address = 172.16.176.192/24\n oob_default_gateway = 172.16.176.1\n apic_admin_password = Cisco321!\n \n ; Multiple CIMC's can be defined in the ini file\n [172.16.176.193]\n fabric_name = 176_fabric3\n cimc_password = Cisco123!\n controller_number = 2\n oob_ip_address = 172.16.176.194/24\n oob_default_gateway = 172.16.176.1\n ; apic password is not needed for controllers 2 and 3\n \n ; Multiple CIMC's can be defined in the ini file\n [172.16.176.195]\n fabric_name = 176_fabric3\n cimc_password = Cisco123!\n controller_number = 3\n oob_ip_address = 172.16.176.196/24\n oob_default_gateway = 172.16.176.1\n ; apic password is not needed for controllers 2 and 3\n\nIt is nice to have a default section that holds default settings so all the required settings are\nnot needed for each controller.\n\nWiper only runs against one CIMC at a time though so in order to wipe/provision three APIC's you\nwould need to run wiper three times and each time provide which CIMC you are running against. For\nexample::\n\n wiper -i sample.ini 172.16.176.191\n wiper -i sample.ini 172.16.176.193\n wiper -i sample.ini 172.16.176.195", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/datacenter/wiper/releases/tag/v1.0.1", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/datacenter/wiper", "keywords": null, "license": "UNKNOWN", "maintainer": null, "maintainer_email": null, "name": "wiper", "package_url": "https://pypi.org/project/wiper/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/wiper/", "project_urls": { "Download": "https://github.com/datacenter/wiper/releases/tag/v1.0.1", "Homepage": "https://github.com/datacenter/wiper" }, "release_url": "https://pypi.org/project/wiper/1.0.1/", "requires_dist": null, "requires_python": null, "summary": "Wipe the APIC config and reprovision APICs.", "version": "1.0.1" }, "last_serial": 1718505, "releases": { "1.0.0": [], "1.0.1": [ { "comment_text": "", "digests": { "md5": "ef311694caf0fb55c03f6a604eea33e6", "sha256": "9a19748f369ac14b3d6f3efc6b00c714eb64a4588267d59ec9d281867b5bd20c" }, "downloads": -1, "filename": "wiper-1.0.1-py2.7.egg", "has_sig": false, "md5_digest": "ef311694caf0fb55c03f6a604eea33e6", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 33151, "upload_time": "2015-09-11T05:02:46", "url": "https://files.pythonhosted.org/packages/fa/06/b8b9fe9b34ec1cb27c3b3ef0906157852c844287cd721453485974e249b6/wiper-1.0.1-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "fb56e78d169a4ffa654869a2a22f8b91", "sha256": "b1eb716b899f1b5e95a6a21305eeb8c2516ecdf99b59441757db176ea8e78be3" }, "downloads": -1, "filename": "wiper-1.0.1.tar.gz", "has_sig": false, "md5_digest": "fb56e78d169a4ffa654869a2a22f8b91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15460, "upload_time": "2015-09-11T05:02:35", "url": "https://files.pythonhosted.org/packages/f0/f8/346a0025a91c4292a7a7323bc89edfca54b93b2c46c455cc3d9292327c10/wiper-1.0.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ef311694caf0fb55c03f6a604eea33e6", "sha256": "9a19748f369ac14b3d6f3efc6b00c714eb64a4588267d59ec9d281867b5bd20c" }, "downloads": -1, "filename": "wiper-1.0.1-py2.7.egg", "has_sig": false, "md5_digest": "ef311694caf0fb55c03f6a604eea33e6", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 33151, "upload_time": "2015-09-11T05:02:46", "url": "https://files.pythonhosted.org/packages/fa/06/b8b9fe9b34ec1cb27c3b3ef0906157852c844287cd721453485974e249b6/wiper-1.0.1-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "fb56e78d169a4ffa654869a2a22f8b91", "sha256": "b1eb716b899f1b5e95a6a21305eeb8c2516ecdf99b59441757db176ea8e78be3" }, "downloads": -1, "filename": "wiper-1.0.1.tar.gz", "has_sig": false, "md5_digest": "fb56e78d169a4ffa654869a2a22f8b91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15460, "upload_time": "2015-09-11T05:02:35", "url": "https://files.pythonhosted.org/packages/f0/f8/346a0025a91c4292a7a7323bc89edfca54b93b2c46c455cc3d9292327c10/wiper-1.0.1.tar.gz" } ] }