From 4522a9dfe9836d6386037b296005ec5daa4ef0f9 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 10 Nov 2026 10:49:33 -0300 Subject: [PATCH 1/4] build: remove the EL7 install and build paths RHEL 7 and CentOS 7 are past their end of life, and the OpenROAD installer does not accept them. The EL7 package step, the CentOS Linux match, and the rh-python38 and devtoolset-8 activation had no supported user. An EL7 host now stops with the unsupported version error. A CentOS Linux host stops with the unsupported system error. EL8 and EL9 keep their install path and gcc-toolset-13. Signed-off-by: Vitor Bandeira --- build_openroad.sh | 11 -------- etc/DependencyInstaller.sh | 51 +++----------------------------------- 2 files changed, 4 insertions(+), 58 deletions(-) diff --git a/build_openroad.sh b/build_openroad.sh index 0eef046bd5..faa8f63fb1 100755 --- a/build_openroad.sh +++ b/build_openroad.sh @@ -374,17 +374,6 @@ __local_build() export LIBRARY_PATH="${_joined_paths}${LIBRARY_PATH:+:$LIBRARY_PATH}" echo "[INFO] General LIBRARY_PATH=$LIBRARY_PATH" fi - if [[ -f "/opt/rh/rh-python38/enable" ]]; then - set +u - source /opt/rh/rh-python38/enable - set -u - fi - if [[ -f "/opt/rh/devtoolset-8/enable" ]]; then - # the scl script has unbound variables - set +u - source /opt/rh/devtoolset-8/enable - set -u - fi # EL8: the default GCC 8 is too old for kepler-formal. if [[ -f "/opt/rh/gcc-toolset-13/enable" ]]; then set +u diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index d98925a0a3..f95108f3cb 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -146,11 +146,6 @@ _installORDependencies() { } _installPipCommon() { - if [[ -f /opt/rh/rh-python38/enable ]]; then - set +u - source /opt/rh/rh-python38/enable - set -u - fi local lockfile piplock lockfile="${_script_dir}/requirements-common_lock.txt" piplock="${_script_dir}/requirements-pip_lock.txt" @@ -188,43 +183,12 @@ _installPipSystem() { apt-get -y install python3-pandas python3-numpy python3-click python3-yaml python3-yamlfix } -# Enterprise Linux 7 cleanup -_install_EL7_CleanUp() { - yum clean -y all -} - -# Enterprise Linux 7 package installation (EL7 = RHEL 7 or CentOS 7) -_install_EL7_Packages() { - yum -y update - yum -y install \ - time \ - readline \ - ruby \ - ruby-devel \ - tcl-tclreadline \ - tcl-tclreadline-devel - - if ! [ -x "$(command -v klayout)" ]; then - yum -y install https://www.klayout.org/downloads/CentOS_7/klayout-${klayoutVersion}-0.x86_64.rpm - else - currentVersion=$(klayout -v | grep -o '[0-9]\+\.[0-9]\+\.[0-9]\+') - if _versionCompare $currentVersion -ge $klayoutVersion; then - echo "KLayout version greater than or equal to ${klayoutVersion}" - else - echo "KLayout version less than ${klayoutVersion}" - sudo yum remove -y klayout - yum -y install https://www.klayout.org/downloads/CentOS_7/klayout-${klayoutVersion}-0.x86_64.rpm - fi - fi -} - - # Enterprise Linux 8/9 cleanup _install_EL8_EL9_CleanUp() { dnf clean -y all } -# Enterprise Linux 8/9 package installation (EL8/EL9 = RHEL, Rocky Linux, AlmaLinux, or CentOS 8 as no CentOS 9 exists) +# Enterprise Linux 8/9 package installation (EL8/EL9 = RHEL, Rocky Linux, or AlmaLinux) _install_EL8_EL9_Packages() { # Re-detect EL version for appropriate KLayout package if [[ -f /etc/os-release ]]; then @@ -659,7 +623,7 @@ case "${platform}" in esac case "${os}" in - "CentOS Linux" | "Red Hat Enterprise Linux"* | "AlmaLinux" | "Rocky Linux") + "Red Hat Enterprise Linux"* | "AlmaLinux" | "Rocky Linux") # Enterprise Linux support - dispatch based on specific version if [[ ${CI} == "yes" ]]; then echo "WARNING: Installing CI dependencies is only supported on Ubuntu 24.04 and 26.04" >&2 @@ -676,17 +640,10 @@ case "${os}" in # First install OpenROAD base _installORDependencies - # Determine between EL7 vs EL8/9, since yum vs dnf should be used, and different Klayout builds exist + # Only EL8 and EL9 are supported; other versions stop here. case "${elVersion}" in - "7") - # EL7 = RHEL 7 or CentOS 7 - if [[ "${option}" == "base" || "${option}" == "all" ]]; then - _install_EL7_Packages - _install_EL7_CleanUp - fi - ;; "8"|"9") - # EL8/EL9 = RHEL, Rocky Linux, AlmaLinux, or CentOS 8+ + # EL8/EL9 = RHEL, Rocky Linux, or AlmaLinux if [[ "${option}" == "base" || "${option}" == "all" ]]; then _install_EL8_EL9_Packages _install_EL8_EL9_CleanUp From 90ee0b1ec0a250ed059eb420abe3102a7e44752d Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Tue, 10 Nov 2026 10:49:40 -0300 Subject: [PATCH 2/4] docs: name only Ubuntu releases as supported platforms The project tests and publishes binaries only for Ubuntu. The build pages also named RHEL 8, Rocky Linux 9, Debian, and macOS, which gave users a support level that CI does not check. Signed-off-by: Vitor Bandeira --- docs/user/BuildLocally.md | 2 +- docs/user/BuildWithDocker.md | 4 +--- docs/user/BuildWithWSL.md | 2 +- 3 files changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/user/BuildLocally.md b/docs/user/BuildLocally.md index 15ccf7ff9c..6340c2207c 100644 --- a/docs/user/BuildLocally.md +++ b/docs/user/BuildLocally.md @@ -4,7 +4,7 @@ The `setup.sh` script installs all of the dependencies, including OpenROAD dependencies, if they are not already installed. -Supported configurations are: Ubuntu 26.04, Ubuntu 24.04, RHEL 8 and RockyLinux 9. +Supported configurations are: Ubuntu 26.04 and Ubuntu 24.04. ``` shell git clone --recursive https://github.com/The-OpenROAD-Project/OpenROAD-flow-scripts diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index 0b79b8c45f..7b1fdaa106 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -105,7 +105,7 @@ util/docker_shell make To use the GUI feature you will need to start the docker with the following command, -For Ubuntu/Debian OS users: +For Ubuntu users: ``` docker run --rm -it \ @@ -119,8 +119,6 @@ docker run --rm -it \ openroad/orfs ``` -Running GUI with Docker on Mac OS X users, refer [here](https://cntnr.io/running-guis-with-docker-on-mac-os-x-a14df6a76efc). - Then use: ``` diff --git a/docs/user/BuildWithWSL.md b/docs/user/BuildWithWSL.md index 374157946a..35e42526f0 100644 --- a/docs/user/BuildWithWSL.md +++ b/docs/user/BuildWithWSL.md @@ -2,7 +2,7 @@ Windows Subsystem for Linux, or WSL for short is a way for you to mount a Linux-based OS onto your Windows machine, allowing you to build OpenROAD-flow-scripts both locally and via Docker. ## Install WSL -Instructions to install WSL can be found [here](https://learn.microsoft.com/en-us/windows/wsl/install). You may use any kernel supported, such as: Ubuntu 26.04, Ubuntu 24.04, RHEL 8, RockyLinux 9. +Instructions to install WSL can be found [here](https://learn.microsoft.com/en-us/windows/wsl/install). Use a supported Ubuntu release: Ubuntu 26.04 or Ubuntu 24.04. We recommend that users follow the Docker build by continuing onto the guide below. However, if you wish to install locally, you may follow the build locally instructions [here](./BuildLocally.md). From b642145c0c9746b7eda611e0df5b21a0ca2f9f0d Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Sun, 15 Nov 2026 20:16:13 -0300 Subject: [PATCH 3/4] build: stop unsupported EL versions before any install The OpenROAD installer does not check the Enterprise Linux version. On EL7 or EL10, it installed packages and bazelisk before the ORFS version check stopped the run. The script now runs the OpenROAD installer only for EL8 and EL9. Other versions stop with the unsupported version error before any install. Signed-off-by: Vitor Bandeira --- etc/DependencyInstaller.sh | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/etc/DependencyInstaller.sh b/etc/DependencyInstaller.sh index f95108f3cb..6e0b82d140 100755 --- a/etc/DependencyInstaller.sh +++ b/etc/DependencyInstaller.sh @@ -637,13 +637,12 @@ case "${os}" in exit 1 fi - # First install OpenROAD base - _installORDependencies - - # Only EL8 and EL9 are supported; other versions stop here. + # Only EL8 and EL9 are supported; other versions stop before any install. case "${elVersion}" in "8"|"9") # EL8/EL9 = RHEL, Rocky Linux, or AlmaLinux + # First install OpenROAD base + _installORDependencies if [[ "${option}" == "base" || "${option}" == "all" ]]; then _install_EL8_EL9_Packages _install_EL8_EL9_CleanUp From ebe59951f45960fe56db425d60ad7bbc046ea597 Mon Sep 17 00:00:00 2001 From: Vitor Bandeira Date: Sun, 15 Nov 2026 20:16:14 -0300 Subject: [PATCH 4/4] docs: remove the leftover macOS GUI command The "Then use:" command came from the removed macOS GUI tutorial. Its DISPLAY placeholder pointed to that tutorial. Ubuntu users do not need it. Signed-off-by: Vitor Bandeira --- docs/user/BuildWithDocker.md | 6 ------ 1 file changed, 6 deletions(-) diff --git a/docs/user/BuildWithDocker.md b/docs/user/BuildWithDocker.md index 7b1fdaa106..c0fb049284 100644 --- a/docs/user/BuildWithDocker.md +++ b/docs/user/BuildWithDocker.md @@ -119,12 +119,6 @@ docker run --rm -it \ openroad/orfs ``` -Then use: - -``` -docker run --rm -it -e DISPLAY=:0 --network host --privileged -``` - Alternatively, you may also use the `docker_shell` utility for GUI as follows. It is important that you are in the `flow` directory.