Skip to main content

No project description provided

Project description

Extreme Flash

This tool allows flashing Enterasys / Extreme Networks access points fully automatically, using OpenWRT's initramfs image.

Installation

Install the tool:

pipx install extremeflash

or

pip install extremeflash

Usage

Prerequisites

  1. connect a USB serial device to the local machine and to the serial port of the Enterasys AP
  2. identify the IP configured on the local machine that will be used to connect to the Enterasys AP
  3. download an OpenWRT initramfs-kernel image, e.g. for the WS-AP3710i
  4. download an OpenWRT-based squashfs-sysupgrade, e.g. for the WS-AP3710i

Note: While it is generally recommended to use the same version for initramfs-kernel and squashfs-sysupgrade, the process can work with different versions. This is especially important if a downstream OpenWRT firmware (e.g. Gluon) with a different version should be installed on the router.

Run the tool

  1. Make sure that the serial cable is connected to the access point, but it is not powered on yet

  2. Run the tool

    • let it autodetect the serial port:

      extremeflash --local-ip 192.168.1.70/24 \
      --model AP3710 \
      -i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \
      -j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin
      
    • or manually specify the serial port:

      extremeflash  --port /dev/ttyUSB0 --local-ip 192.168.1.70/24 \
      --model AP3710 \
      -i ~/Downloads/openwrt-23.05.0-mpc85xx-p1020-enterasys_ws-ap3710i-initramfs-kernel.bin \
      -j ~/Downloads/openwrt-22.03.3-mpc85xx-p1020-enterasys_ws-ap3710i-squashfs-sysupgrade.bin
      
    • For more information run:

      extremeflash --help
      
  3. Power the access point and connect the LAN cable to power the AP.
    Note: for APs with two or more LAN ports, make sure the local machine is connected to port 2, not port 1.

  4. The tool will flash the access point automatically. When it finishes, the access point can be reached via 192.168.1.1 (OpenWRT's default IP).

Contributing

Install dependencies

If the dependencies are not already installed, run poetry install followed by a poetry shell to get an environment with all necessary dependencies.

Running modified code

After modifying the code, run the tool by executing python -m extremeflash inside the repository's folder. For example:

python3 -m extremeflash --help

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

extremeflash-0.3.1.tar.gz (22.9 kB view details)

Uploaded Source

Built Distribution

extremeflash-0.3.1-py3-none-any.whl (29.3 kB view details)

Uploaded Python 3

File details

Details for the file extremeflash-0.3.1.tar.gz.

File metadata

  • Download URL: extremeflash-0.3.1.tar.gz
  • Upload date:
  • Size: 22.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.7

File hashes

Hashes for extremeflash-0.3.1.tar.gz
Algorithm Hash digest
SHA256 badac7e8f5894e3e1a788a88742c19ad65c9367d7c059c685e40572131a051ac
MD5 dd4f4f379637abbfa1928684920f084e
BLAKE2b-256 1de30f1243f9b27908e932fede62a6391adf4e03541e72295e11fc37fa71d7ec

See more details on using hashes here.

Provenance

File details

Details for the file extremeflash-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: extremeflash-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 29.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.11.7

File hashes

Hashes for extremeflash-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9c59093290d3fd4ffa182c3ede7e5d9bbe7429df7fb0d58a8e09750507a786ec
MD5 a759f31e895bf1a41d36ccb1ffcf6fe1
BLAKE2b-256 78fc366245fbaeac39426d1e7057f6f3b8bbc3c35a111decea39460d2a4cadc5

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page