{"id":37906728,"url":"https://github.com/vesposito/easyucs","last_synced_at":"2026-01-16T17:12:28.059Z","repository":{"id":56309351,"uuid":"184340083","full_name":"vesposito/easyucs","owner":"vesposito","description":"EasyUCS is a toolbox to help deploy, manage and document Cisco UCS/Intersight devices","archived":false,"fork":false,"pushed_at":"2026-01-13T07:57:38.000Z","size":49016,"stargazers_count":45,"open_issues_count":5,"forks_count":16,"subscribers_count":11,"default_branch":"master","last_synced_at":"2026-01-13T10:37:01.178Z","etag":null,"topics":["cisco","intersight","python3","ucs","ucs-central","ucs-device","ucs-imc","ucs-manager"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vesposito.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-04-30T22:30:28.000Z","updated_at":"2026-01-13T07:56:07.000Z","dependencies_parsed_at":"2022-08-15T16:30:35.517Z","dependency_job_id":"ab55a653-1c88-47d5-8ec2-ea29281b7e12","html_url":"https://github.com/vesposito/easyucs","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/vesposito/easyucs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vesposito%2Feasyucs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vesposito%2Feasyucs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vesposito%2Feasyucs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vesposito%2Feasyucs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vesposito","download_url":"https://codeload.github.com/vesposito/easyucs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vesposito%2Feasyucs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28480082,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T11:59:17.896Z","status":"ssl_error","status_checked_at":"2026-01-16T11:55:55.838Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cisco","intersight","python3","ucs","ucs-central","ucs-device","ucs-imc","ucs-manager"],"created_at":"2026-01-16T17:12:27.415Z","updated_at":"2026-01-16T17:12:28.049Z","avatar_url":"https://github.com/vesposito.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EasyUCS [![published](https://static.production.devnetcloud.com/codeexchange/assets/images/devnet-published.svg)](https://developer.cisco.com/codeexchange/github/repo/vesposito/easyucs)\n\nEasyUCS is a toolbox to help deploy and manage Cisco UCS/Intersight devices.\n\nIt can :\n\n* [deploy a configuration](docs/CONFIG.md) on a running UCS device / Intersight instance:\n    - UCS system (UCS Manager)\n    - UCS IMC (Integrated Management Controller) for standalone servers\n    - UCS Central\n    - Intersight (SaaS or Appliance)\n    - IMM Domain (Fabric Interconnects running in Intersight mode)\n* perform the initial setup of an \"out of the box\" UCS device (UCSM, IMM or CIMC)\n* reset the configuration of a UCS device before configuring it\n* [fetch a configuration](docs/CONFIG.md) and export it in JSON format\n* [fetch an inventory](docs/INVENTORY.md) and export it in JSON format\n* [perform maintenance actions](docs/ACTIONS.md) on a UCS device (regenerate self-signed certificate, clear user sessions, clear SEL logs)\n* claim/unclaim UCS devices to/from Intersight\n* create pictures of equipment and infrastructure [schemas](docs/SCHEMAS.md)\n* create [Technical Architecture Documentation (TAD)](docs/REPORT.md) in Word/PDF formats\n\n## Getting Started\n\nThese instructions will get you a copy of the project up and running on your local machine.\n\n### Prerequisites\n\nMinimum versions of UCS devices :\n\n* UCS Manager: ***3.2(1d)*** or above\n* UCS IMC: ***3.0(1c)*** or above\n* UCS Central: ***2.0(1a)*** or above\n* Intersight SaaS ***(no prerequisite)*** \u0026 Appliance: ***1.1.5-0*** or above\n\nThis tool requires ***Python 3.9+*** to work. *Python 2.x* is not supported.\n\nPython can be used on Windows, Linux/Unix, Mac OS X and more.\n\nYou can download the latest version of *Python 3* on the [official website](https://www.python.org/downloads/).\n\n### Installing\nEasyUCS can be installed using any of ways below:\n\n#### From GitHub\nClick *\"Clone or Download\"* and *\"Download ZIP\"* on the GitHub website to download the whole project. \n\nUncompress the zip and put the folder on your system. \n\n#### From Git command line\n\nYou need to have Git on your system (not necessarily installed by default on all types of system).\n\nNavigate to your desired path where you want EasyUCS to be placed on and clone it through your command-line console,\n\n```\ngit clone https://github.com/vesposito/easyucs.git\n```\n\n## Requirements\n\nEasyUCS requires some Python modules dependencies. The file **[requirements.txt](./requirements.txt)** contains all of these requirements.\n\nUse Python Pip to install all of them.\n\n- for Max OS X, Unix, Linux:\n```\npip install -r requirements.txt\n```\n\n- for Windows:\n```\npython -m pip install -r requirements.txt\n```\n\n## Running EasyUCS\n\nEasyUCS can be used with command line interface or via a Web GUI.\n\n\n### Using the Web Graphical User Interface (GUI) / the API\n\nThe Web GUI is hosted by your machine, in order to launch it you need to use the file **[easyucs_api.py](./easyucs_api.py)**.\n\n```\npython easyucs_api.py\n```\n\n\n### Using the Command-Line Interface (CLI)\n\nPush config file config_ucsm.json to UCS system\n```\npython easyucs.py config push -t ucsm -i 192.168.0.1 -u admin -p password -f configs/config_ucsm.json\n```\n\nPush config file config_cimc.json to UCS IMC\n```\npython easyucs.py config push -t cimc -i 192.168.0.2 -u admin -p password -f configs/config_cimc.json\n```\n\nPerform initial setup of UCS system using DHCP IP addresses 192.168.0.11 \u0026 192.168.0.12 and push config file config_ucsm.json\n```\npython easyucs.py config push -t ucsm -f configs/config_ucsm.json -s 192.168.0.11 192.168.0.12\n```\n\nReset UCS system, perform initial setup using DHCP IP addresses 192.168.0.11 \u0026 192.168.0.12 and push config file config_ucsm.json\n```\npython easyucs.py config push -t ucsm -i 192.168.0.1 -u admin -p password -f configs/config_ucsm.json -r -s 192.168.0.11 192.168.0.12\n```\n\nFetch config from UCS system and save it to output/configs/config_ucsm.json\n```\npython easyucs.py config fetch -t ucsm -i 192.168.0.1 -u admin -p password -o output/configs/config_ucsm.json\n```\n\nFetch inventory from UCS IMC and save it to output/inventories/inventory_cimc.json\n```\npython easyucs.py inventory fetch -t cimc -i 192.168.0.2 -u admin -p password -o output/inventories/inventory_cimc.json\n```\n\nCreate schemas from UCS system and save them to output/schemas folder\n```\npython easyucs.py schemas create -t ucsm -i 192.168.0.1 -u admin -p password -o output/schemas\n```\n\nCreate report from UCS system and save it to output/reports folder (also creates schemas)\n```\npython easyucs.py report generate -t ucsm -i 192.168.0.1 -u admin -p password -o output/reports\n```\n\nRegenerate expired Self-signed Certificate of UCS system\n```\npython easyucs.py device regenerate_certificate -t ucsm -i 192.168.0.1 -u admin -p password\n```\n\nClear SEL Logs of all discovered servers of UCS system\n```\npython easyucs.py device clear_sel_logs -t ucsm -i 192.168.0.1 -u admin -p password\n```\n\nReset Device Connector for UCS system\n```\npython easyucs.py device reset_device_connector -t ucsm -i 192.168.0.1 -u admin -p password\n```\n\n\n## Built With\n\n* [ucsmsdk](https://github.com/CiscoUcs/ucsmsdk) - The UCS Manager Python SDK\n* [imcsdk](https://github.com/CiscoUcs/imcsdk) - The UCS IMC Python SDK\n* [ucscsdk](https://github.com/CiscoUcs/ucscsdk) - The UCS Central Python SDK\n* [intersight-python](https://github.com/CiscoDevNet/intersight-python) - The Intersight Python SDK\n\n\n## Versioning\n\n### 1.0.5\n* Bump up minimum Intersight Appliance required version to 1.1.5-0\n* Miscellaneous bug fixes and improvements\n\n### 1.0.4\n* Add support for Fabric Interconnect 6664\n* Add support for iSCSI Boot with IPv6 in UCSM \u0026 Intersight config\n* Add support for User Labels on FI ports in Intersight config\n* Add support for UCS Manager 6.0(1)\n* Bump up minimum Intersight Appliance required version to 1.1.4-0\n* Miscellaneous bug fixes and improvements\n\n### 1.0.3\n* Add support for UCS C240 M8, C220 M8 and X210c M8 in catalog\n* Add support for X-Series front mezzanine adapters in inventory \u0026 draw\n* Add support for MACsec in UCSM config\n* Add support for NetFlow in UCSM config\n* Add support for MACsec Policies in Intersight config\n* Add support for LDAP configuration of Intersight Appliance\n* Add support for LDAP configuration of UCS Central\n* Add support for UCS Manager 4.3(6) and UCS Central 2.1(1)\n* Bump up minimum Intersight Appliance required version to 1.1.3-0\n* Miscellaneous bug fixes and improvements\n\n### 1.0.2\n* Add support for Memory Policies in Intersight config\n* Add support for Server Pool Qualification Policies in Intersight config\n* Add support for Scrub Policies in Intersight config\n* Add support for equipment (FI, FEX, Chassis, Blade, Rack) User Labels \u0026 Tags in Intersight config\n* Add support for attaching multiple Ethernet Network Group Policies to vNICs/Uplink Ports/Port-Channels in Intersight config\n* Bump up minimum Intersight Appliance required version to 1.1.2-0\n* Miscellaneous bug fixes and improvements\n\n### 1.0.1\n* Miscellaneous bug fixes and improvements\n\n### 1.0.0\n* Add support for Intersight device inventory fetch\n* Add initial support for Intersight report (inventory \u0026 config)\n* Add support for IMM Domain device\n* Add support for IMM Domain fetch/push config\n* Add support for initial setup of IMM Domain device\n* Bump up minimum Intersight Appliance required version to 1.1.1-0\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.11\n* Add support for UCS X-Direct in UCSM config/inventory/report\n* Add support for assigning user label to devices\n* Add GUI support for Intersight SaaS/Appliance and SaaS regions\n* Renamed clear_intersight_claim_status action to reset_device_connector\n* Bump up minimum Intersight Appliance required version to 1.1.0-1\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.10\n\n* Add support for a new Software Repository feature in EasyUCS UI, with ability to serve as an HTTP repo for ISO/firmware updates\n* Add support for Chassis Profile Template \u0026 Domain Profile Template in Intersight config\n* Add support for vNIC \u0026 vHBA Template in Intersight config\n* Add support for new config features in UCS Manager 4.3(4): ERSPAN, Hybrid Slot, BIOS Tokens\n* Add support for Power Groups in UCS Manager config\n* Add support for UCS C245 M8, C225 M8 and X215c M8 in catalog\n* Bump up minimum Intersight Appliance required version to 1.1.0-0\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.9\n\n* Add support for subnet-level configuration for IP Pools in Intersight config\n* Add support for User Labels on Chassis \u0026 Domain Profiles in Intersight config\n* Add support for Physical NIC mode in Adapter Config Policy in Intersight config\n* Add support for Hybrid Slots configuration in Storage Policy in Intersight config\n* Add support for FlexMMC in Boot Policy in Intersight config\n* Bump up minimum Intersight Appliance required version to 1.0.9-675\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.8\n\n* Add support for regenerating SSL certificates for UCSM \u0026 CIMC devices in CLI \u0026 GUI\n* Add support for cleaning an Intersight account (removes all pools, policies, profiles \u0026 templates) in GUI\n* Add support for UCS M7 servers with Emerald Rapids CPUs\n* Add support for VIC QinQ \u0026 SRIOV in Intersight config\n* Add support for UCSM custom OUI for FC configuration\n* Bump up minimum Intersight Appliance required version to 1.0.9-655\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.7\n\n* Add support for Organization Sharing in Intersight config\n* Add support for X410c M7 \u0026 new VIC 15000 series adapters\n* Bump up minimum Intersight Appliance required version to 1.0.9-631\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.6\n\n* Add support for HTTP boot, Simple Placement mode for VIC 1300 in Intersight config\n* Add support for Fabric Port-Channel vHBA Reset in UCSM \u0026 Intersight config\n* Add support for BIOS Tokens up to UCS Central 2.0(1t)\n* Add support for XFM inventory/draw \u0026 Server Personality in UCSM inventory\n* Bump up minimum Intersight Appliance required version to 1.0.9-615\n* Prevent fetching Intersight config with Shared Orgs (not yet supported)\n* Miscellaneous bug fixes and improvements\n\n### 0.9.8.5\n\nSorry for the delay in updating this tool! We were busy working on the [**IMM Transition Tool**](https://www.cisco.com/c/en/us/td/docs/unified_computing/Intersight/IMM-Transition-Tool/b_imm_tt_rn.html) which uses EasyUCS as its backend.\n* HUGE rework of many parts of EasyUCS. It would be too long to list them all here!  \nThis also means that there are a few **breaking changes** in the JSON format for UCSM files. Sorry about this!\n* **Fully redesigned \u0026 dynamic GUI**\n* **Repository backend** for multi-device management (used by the GUI)\n* EasyUCS also now has an **OpenAPI-based API** (used by the GUI) to easily automate your tasks\n* Add support for **UCS Central config fetch/push** of most policies/profiles/templates/pools. UCS Central is now a first class citizen in EasyUCS.\n* Add support for **Intersight config fetch/push** of all Server/Chassis/Domain policies/profiles/templates/pools. You can now use EasyUCS for Intersight Managed servers! (Standalone \u0026 FI-Attached)\n* Add support for M6, M7 \u0026 X-Series (UCSM) in the schemas generation as well as the report.\n* Add support for generating reports in PDF format (on top of Word format)\n* Add support for BIOS Tokens up to UCSM 4.3(2b)\n* Add support for (un)claiming CIMC/UCSM devices to Intersight using the API/GUI\n* Add support for taking backups using the API/GUI (for UCSM and UCS Central)\n\n### 0.9.7.6\n\n* Fix CIMC push of Admin Networking config section\n\n### 0.9.7.5\n\n* Add support for SNMP users/traps \u0026 Syslog in CIMC config\n* Update SDK requirements to fix compatibility issues\n\n### 0.9.7.4\n\n* Add inventory of PCIe risers for rack servers\n* Cleanup of all catalog files\n* Add flag for Intersight Managed Mode support status per equipment in UCSM inventory\n* Add support for UCS C240 M5SD\n* Add support for BIOS Tokens up to UCSM 4.1(3a)\n* Add inventory of memory errors per DIMM in UCSM inventory\n* Miscellaneous bug fixes and improvements\n\n### 0.9.7.3\n\n* Add support for Authentication (Native \u0026 Authentication Domains) in UCSM config\n* Move Intersight Device Connector config to common structure between UCSM \u0026 IMC\n* Add missing \"Storage Config. Deployment Policy\" attribute in Maintenance Policies in UCSM config\n* Other small bug fixes and improvements\n\n### 0.9.7.2\n\n* Add support for Intersight Device Connector in inventory \u0026 config for UCSM \u0026 IMC\n* Add Device Connector section in UCSM \u0026 IMC report\n* Add support for resetting UCSM \u0026 IMC Device Connector\n* Miscellaneous bug fixes\n\n### 0.9.7\n\n* Add device actions in CLI (\"regenerate_certificate\", \"clear_sel_logs\", \"clear_user_sessions\")\n* Add \"Policies\" section in UCSM report with Server Policies (Boot, BIOS, Local Disk Config, Scrub, etc.)\n* Add support for System Profile \u0026 Policies settings in UCS Central config (Interfaces, DNS, Date\u0026Time, Remote Access, Syslog)\n* Add support for System Profile \u0026 Policies settings in Domain Groups in UCS Central config (DNS, Date\u0026Time, Remote Access, Equipment Policies, Syslog)\n* Add support for User Settings in UCS Central config (Password Profile, Local Users, Roles \u0026 Locales)\n* Add support for User Settings in Domain Groups in UCS Central config (Roles \u0026 Locales)\n* Add support for SNMP settings in UCS Central config \u0026 Domain Groups\n* Add support for Syslog \u0026 Global Fault Policy settings in UCSM config\n* Add support for Azure Stack environments\n* Add support for C4200 in UCSM report\n* Add inventory of HBA adapters in IMC inventory\n* Major reorganization of report code\n* Multiple bug fixes and improvements\n\n### 0.9.6\n\n* Add support for UCSM 4.1(1) specific features (FI 64108 \u0026 Unified Ports, Fan Control Policy, new BIOS Tokens, Writable vMedia Mount)\n* Add support for fetching Reserved VLAN Start ID for FI 6400 (push is planned for a future release)\n* Add VLAN Port Count information in inventory and report\n* Add IMC S3260 I/O Expander in inventory\n* Add SSD stats in inventory when available\n* Memory consumption optimization for schemas generation\n* Multiple bug fixes and improvements\n\n\n### 0.9.5\n\n* Add support for UCSM 4.0(4) specific features (M.2 HWRAID, Persistent Memory Policies, Alternate KVM Port)\n* Add support for configuring up to 16 Unified Ports on FI 6454\n* Add support for VSANs on UCS Central\n* Add preliminary support for upcoming FI 64108\n* Reorganization of device, config and inventory folders to clean up files\n* Bump up requirements packages versions\n* Miscellaneous bug fixes and improvements (including fix for missing dependency on tkinter package)\n\n\n### 0.9.4\n\n* Add support for \"comment\" field in all sections of a configuration file for easily add comments to specific items of a configuration\n* Add support for Fabric Interconnect port licenses in inventory and report\n* Add support for 1st Gen Fabric Interconnects 6120XP/6140XP\n* Add support for UCS Central inventory fetch (will fetch inventories of all registered domains)\n* Support up to 32 Service Profile Templates when generating schemas\n* Bump up requirements packages versions\n* Miscellaneous bug fixes and improvements\n\n\n### 0.9.3\n\n* Include Storage Enclosures \u0026 drives of S3260 in report\n* Add support for UEFI Boot Parameters in SAN Boot (Boot Policies)\n* Remove admin password from report (for security reasons)\n* Change \"generate report\" command argument to specify directory instead of report file name. All required files will be written in that directory\n* Automatically export config \u0026 inventory to JSON files when generating report\n* Lots of bug fixes and improvements\n\n\n### 0.9.2\n\n* Include portions of Logical Configuration in Technical Architecture Documentation, including Networking, Organizations, Identities and Service Profiles\n* Add support for Dynamic vNIC Connection Policies in UCS Manager\n* Add preliminary support for S3260 in IMC for config fetch/push - works for single server node only for now\n* Add support for C4200 and C125 server node\n* Various bug fixes and improvements\n\n### 0.9.1\n\n* Add automatic Technical Architecture Documentation creation (containing detailed inventory and architecture schemas)\n* Add support for LAN \u0026 SAN Global Policies in UCS Manager (VLAN Port Count Optimization, VLAN Org Permissions, Inband Profile)\n* Rework of NVMe drives support in inventory (now displayed in its own nvme_drives section instead of being in storage_controllers)\n* Add support for IOM 2408, HXAF220C All NVMe, C480 M5 ML\n* Various bug fixes and improvements\n\n### 0.9.0\n\nInitial release\n\n## Authors\n\n* **Marc Abu El Ghait** - *Initial work* - [GitHub account link](https://github.com/mabuelgh)\n* **Franck Bonneau** - *Initial work* - [GitHub account link](https://github.com/Franck-Bonneau)\n* **Vincent Esposito** - *Initial work* - [GitHub account link](https://github.com/vesposito)\n\n## Contributors\n* **Shashank Pandey** - *Repository, DB, API, Intersight, ...* - [GitHub account link](https://github.com/Shashank-Pandey-ML)\n* **Valentin Pereira** - *Redesigned GUI* - [GitHub account link](https://github.com/Valisback)\n* **Mohamed Ismayil** - *Intersight support*\n* **Syeda Mehar Naseer** - *UCS Central/Manager \u0026 Intersight support*\n* **Anjana Devi Chilukuri** - *UCS Central/Manager \u0026 Intersight support*\n* **Ananta Surendra Babu** - *UCS Central/Manager \u0026 Intersight support*\n* **Simon Mathai** - *UCS Central/Manager \u0026 Intersight support*\n* **Kistareddy Gari Sreelatha** - *UCS Central/Manager \u0026 Intersight support*\n* **Tony Frank** - *PDF reporting*\n* **Prabhu Ganesh** - *Various enhancements*\n* **Rushab Mohanlal Jain** - *Various enhancements*\n* **Abhinav Sinha** - *Various enhancements*\n* **Jayasree Vulavala** - *Various enhancements*\n* **Ivan Ivanov** - *GUI enhancements*\n* **Jyoti Chahal** - *QA \u0026 Testing*\n* **Alpana Kumari** - *QA \u0026 Testing*\n* **Alekya Gudise** - *QA \u0026 Testing*\n* **Varshitha GN** - *QA \u0026 Testing*\n\n## License\n\nThis project is licensed under the GPLv2 License - see the [LICENSE](LICENSE) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvesposito%2Feasyucs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvesposito%2Feasyucs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvesposito%2Feasyucs/lists"}