Create pkg_root/metadata/package.ini with:
[Package] Version = 16.12.03 Platform = ISRv Type = system Maintainer = Cisco Systems Description = ISR virtual package from BIN conversion [Filesystem] Format = squashfs Compression = lz4
# Create working directory mkdir ~/cisco_conversion && cd ~/cisco_conversion binwalk -e target_image.bin Navigate to extracted squashfs or cpio archive cd _target_image.bin.extracted cisco convert bin to pkg
mkdir -p pkg_root/contents pkg_root/metadata cp -r /mnt/cisco_fs/* pkg_root/contents/
bin2pkg -i input.bin -o output.pkg --platform ISRv --version 16.12.03 This tool is typically embedded in Cisco NFVIS or vManage installations. Contact Cisco TAC for access if required for your contract. 4. Verification After conversion, validate the .pkg file: Create pkg_root/metadata/package
mkdir -p "$TMP_DIR/pkg/contents" cp -r "$FS_DIR/"* "$TMP_DIR/pkg/contents/" cat > "$TMP_DIR/pkg/metadata/package.ini" <<EOF [Package] Version = unknown Platform = generic Type = converted EOF
TMP_DIR=$(mktemp -d) echo "Extracting $BIN_FILE..." binwalk -e "$BIN_FILE" -C "$TMP_DIR" >/dev/null 2>&1 Verification After conversion, validate the
Document Version: 1.0 Applicable Products: Cisco IOS-XE, Cisco vManage, Cisco ISRv (KVM), Cisco Cloud Services Router (CSR) Purpose: This document provides a standard operating procedure (SOP) for converting a raw binary ( .bin ) software image into a deployable package ( .pkg ) format. 1. Introduction Cisco distributes operating system images primarily as .bin files (e.g., isrv-universalk9.16.12.03.bin ). However, certain deployment platforms—particularly those utilizing application hosting, Cisco vManage software upgrades, or KVM-based virtualized environments—require a .pkg (Package) format. The .pkg format includes additional metadata and a structured filesystem that the hypervisor or orchestrator can validate and unpack. 2. Prerequisites Before conversion, ensure the following: