├── .devcontainer └── devcontainer.json ├── .dockerignore ├── .github ├── dependabot.yml └── workflows │ └── build_and_publish_docker_image.yml ├── Dell_iDRAC_fan_controller.sh ├── Dockerfile ├── LICENSE ├── README.md ├── functions.sh └── healthcheck.sh /.devcontainer/devcontainer.json: -------------------------------------------------------------------------------- 1 | // For format details, see https://aka.ms/devcontainer.json. For config options, see the 2 | // README at: https://github.com/devcontainers/templates/tree/main/src/docker-existing-dockerfile 3 | { 4 | "name": "Existing Dockerfile", 5 | "image": "mcr.microsoft.com/devcontainers/universal", 6 | "customizations": { 7 | "vscode": { 8 | "extensions": [ 9 | "mhutchie.git-graph", 10 | "ms-azuretools.vscode-docker" 11 | ] 12 | } 13 | } 14 | 15 | // Features to add to the dev container. More info: https://containers.dev/features. 16 | // "features": {}, 17 | 18 | // Use 'forwardPorts' to make a list of ports inside the container available locally. 19 | // "forwardPorts": [], 20 | 21 | // Uncomment the next line to run commands after the container is created. 22 | // "postCreateCommand": "cat /etc/os-release", 23 | 24 | // Configure tool-specific properties. 25 | // "customizations": {}, 26 | 27 | // Uncomment to connect as an existing user other than the container default. More info: https://aka.ms/dev-containers-non-root. 28 | // "remoteUser": "devcontainer" 29 | } 30 | -------------------------------------------------------------------------------- /.dockerignore: -------------------------------------------------------------------------------- 1 | .github 2 | .devcontainer 3 | README.md -------------------------------------------------------------------------------- /.github/dependabot.yml: -------------------------------------------------------------------------------- 1 | # To get started with Dependabot version updates, you'll need to specify which 2 | # package ecosystems to update and where the package manifests are located. 3 | # Please see the documentation for more information: 4 | # https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates 5 | # https://containers.dev/guide/dependabot 6 | 7 | version: 2 8 | updates: 9 | - package-ecosystem: "devcontainers" 10 | directory: "/" 11 | schedule: 12 | interval: weekly 13 | -------------------------------------------------------------------------------- /.github/workflows/build_and_publish_docker_image.yml: -------------------------------------------------------------------------------- 1 | name: Docker image CI 2 | 3 | on: 4 | push: 5 | branches: [ master ] 6 | paths-ignore: 7 | - '**/README.md' 8 | 9 | jobs: 10 | build: 11 | name: Build and publish Docker image to Docker Hub and GitHub Containers Repository 12 | runs-on: ubuntu-latest 13 | steps: 14 | - name: Checkout 15 | uses: actions/checkout@v4 16 | 17 | - name: Remove "_Docker" suffix from GitHub repository name to use it as image name 18 | uses: mad9000/actions-find-and-replace-string@3 19 | id: docker_image_name 20 | with: 21 | source: ${{ github.repository }} 22 | find: '_Docker' 23 | replace: '' 24 | 25 | - name: Docker meta 26 | id: meta 27 | uses: docker/metadata-action@v5 28 | with: 29 | images: | 30 | ${{ steps.docker_image_name.outputs.value }} 31 | ghcr.io/${{ steps.docker_image_name.outputs.value }} 32 | tags: type=raw,value=latest 33 | 34 | - name: Login to Docker Hub 35 | uses: docker/login-action@v3 36 | with: 37 | username: ${{ secrets.DOCKERHUB_USERNAME }} 38 | password: ${{ secrets.DOCKERHUB_TOKEN }} 39 | 40 | - name: Login to GitHub Container Registry 41 | uses: docker/login-action@v3 42 | with: 43 | registry: ghcr.io 44 | username: ${{ github.repository_owner }} 45 | password: ${{ secrets.GITHUB_TOKEN }} 46 | 47 | - name: Set up QEMU 48 | uses: docker/setup-qemu-action@v3 49 | 50 | - name: Set up Docker Buildx 51 | uses: docker/setup-buildx-action@v3 52 | 53 | - name: Build and publish Docker image 54 | uses: docker/build-push-action@v4 55 | with: 56 | context: . 57 | platforms: linux/amd64,linux/arm64 58 | file: ./Dockerfile 59 | push: true 60 | tags: ${{ steps.meta.outputs.tags }} 61 | labels: ${{ steps.meta.outputs.labels }} 62 | -------------------------------------------------------------------------------- /Dell_iDRAC_fan_controller.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | # Enable strict bash mode to stop the script if an uninitialized variable is used, if a command fails, or if a command with a pipe fails 4 | # Not working in some setups : https://github.com/tigerblue77/Dell_iDRAC_fan_controller/issues/48 5 | # set -euo pipefail 6 | 7 | source functions.sh 8 | 9 | # Trap the signals for container exit and run graceful_exit function 10 | trap 'graceful_exit' SIGINT SIGQUIT SIGTERM 11 | 12 | # Prepare, format and define initial variables 13 | 14 | # readonly DELL_FRESH_AIR_COMPLIANCE=45 15 | 16 | # Check if FAN_SPEED variable is in hexadecimal format. If not, convert it to hexadecimal 17 | if [[ $FAN_SPEED == 0x* ]]; then 18 | readonly DECIMAL_FAN_SPEED=$(convert_hexadecimal_value_to_decimal "$FAN_SPEED") 19 | readonly HEXADECIMAL_FAN_SPEED=$FAN_SPEED 20 | else 21 | readonly DECIMAL_FAN_SPEED=$FAN_SPEED 22 | readonly HEXADECIMAL_FAN_SPEED=$(convert_decimal_value_to_hexadecimal "$FAN_SPEED") 23 | fi 24 | 25 | # Check if the iDRAC host is set to 'local' or not then set the IDRAC_LOGIN_STRING accordingly 26 | if [[ $IDRAC_HOST == "local" ]]; then 27 | # Check that the Docker host IPMI device (the iDRAC) has been exposed to the Docker container 28 | if [ ! -e "/dev/ipmi0" ] && [ ! -e "/dev/ipmi/0" ] && [ ! -e "/dev/ipmidev/0" ]; then 29 | print_error_and_exit "Could not open device at /dev/ipmi0 or /dev/ipmi/0 or /dev/ipmidev/0, check that you added the device to your Docker container or stop using local mode" 30 | fi 31 | IDRAC_LOGIN_STRING='open' 32 | else 33 | echo "iDRAC/IPMI username: $IDRAC_USERNAME" 34 | #echo "iDRAC/IPMI password: $IDRAC_PASSWORD" 35 | IDRAC_LOGIN_STRING="lanplus -H $IDRAC_HOST -U $IDRAC_USERNAME -P $IDRAC_PASSWORD" 36 | fi 37 | 38 | get_Dell_server_model 39 | 40 | if [[ ! $SERVER_MANUFACTURER == "DELL" ]]; then 41 | print_error_and_exit "Your server isn't a Dell product" 42 | fi 43 | 44 | # If server model is Gen 14 (*40) or newer 45 | if [[ $SERVER_MODEL =~ .*[RT][[:space:]]?[0-9][4-9]0.* ]]; then 46 | readonly DELL_POWEREDGE_GEN_14_OR_NEWER=true 47 | readonly CPU1_TEMPERATURE_INDEX=2 48 | readonly CPU2_TEMPERATURE_INDEX=4 49 | else 50 | readonly DELL_POWEREDGE_GEN_14_OR_NEWER=false 51 | readonly CPU1_TEMPERATURE_INDEX=1 52 | readonly CPU2_TEMPERATURE_INDEX=2 53 | fi 54 | 55 | # Log main informations 56 | echo "Server model: $SERVER_MANUFACTURER $SERVER_MODEL" 57 | echo "iDRAC/IPMI host: $IDRAC_HOST" 58 | 59 | # Log the fan speed objective, CPU temperature threshold and check interval 60 | echo "Fan speed objective: $DECIMAL_FAN_SPEED%" 61 | echo "CPU temperature threshold: $CPU_TEMPERATURE_THRESHOLD°C" 62 | echo "Check interval: ${CHECK_INTERVAL}s" 63 | echo "" 64 | 65 | # Define the interval for printing 66 | readonly TABLE_HEADER_PRINT_INTERVAL=10 67 | i=$TABLE_HEADER_PRINT_INTERVAL 68 | # Set the flag used to check if the active fan control profile has changed 69 | IS_DELL_FAN_CONTROL_PROFILE_APPLIED=true 70 | 71 | # Check present sensors 72 | IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT=true 73 | IS_CPU2_TEMPERATURE_SENSOR_PRESENT=true 74 | retrieve_temperatures $IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT $IS_CPU2_TEMPERATURE_SENSOR_PRESENT 75 | if [ -z "$EXHAUST_TEMPERATURE" ]; then 76 | echo "No exhaust temperature sensor detected." 77 | IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT=false 78 | fi 79 | if [ -z "$CPU2_TEMPERATURE" ]; then 80 | echo "No CPU2 temperature sensor detected." 81 | IS_CPU2_TEMPERATURE_SENSOR_PRESENT=false 82 | fi 83 | # Output new line to beautify output if one of the previous conditions have echoed 84 | if ! $IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT || ! $IS_CPU2_TEMPERATURE_SENSOR_PRESENT; then 85 | echo "" 86 | fi 87 | 88 | # Start monitoring 89 | while true; do 90 | # Sleep for the specified interval before taking another reading 91 | sleep $CHECK_INTERVAL & 92 | SLEEP_PROCESS_PID=$! 93 | 94 | retrieve_temperatures $IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT $IS_CPU2_TEMPERATURE_SENSOR_PRESENT 95 | 96 | # Initialize a variable to store the comments displayed when the fan control profile changed 97 | COMMENT=" -" 98 | # Check if CPU 1 is overheating then apply Dell default dynamic fan control profile if true 99 | if CPU1_OVERHEATING; then 100 | apply_Dell_fan_control_profile 101 | 102 | if ! $IS_DELL_FAN_CONTROL_PROFILE_APPLIED; then 103 | IS_DELL_FAN_CONTROL_PROFILE_APPLIED=true 104 | 105 | # If CPU 2 temperature sensor is present, check if it is overheating too. 106 | # Do not apply Dell default dynamic fan control profile as it has already been applied before 107 | if $IS_CPU2_TEMPERATURE_SENSOR_PRESENT && CPU2_OVERHEATING; then 108 | COMMENT="CPU 1 and CPU 2 temperatures are too high, Dell default dynamic fan control profile applied for safety" 109 | else 110 | COMMENT="CPU 1 temperature is too high, Dell default dynamic fan control profile applied for safety" 111 | fi 112 | fi 113 | # If CPU 2 temperature sensor is present, check if it is overheating then apply Dell default dynamic fan control profile if true 114 | elif $IS_CPU2_TEMPERATURE_SENSOR_PRESENT && CPU2_OVERHEATING; then 115 | apply_Dell_fan_control_profile 116 | 117 | if ! $IS_DELL_FAN_CONTROL_PROFILE_APPLIED; then 118 | IS_DELL_FAN_CONTROL_PROFILE_APPLIED=true 119 | COMMENT="CPU 2 temperature is too high, Dell default dynamic fan control profile applied for safety" 120 | fi 121 | else 122 | apply_user_fan_control_profile 123 | 124 | # Check if user fan control profile is applied then apply it if not 125 | if $IS_DELL_FAN_CONTROL_PROFILE_APPLIED; then 126 | IS_DELL_FAN_CONTROL_PROFILE_APPLIED=false 127 | COMMENT="CPU temperature decreased and is now OK (<= $CPU_TEMPERATURE_THRESHOLD°C), user's fan control profile applied." 128 | fi 129 | fi 130 | 131 | # If server model is Gen 14 (*40) or newer 132 | if ! $DELL_POWEREDGE_GEN_14_OR_NEWER; then 133 | # Enable or disable, depending on the user's choice, third-party PCIe card Dell default cooling response 134 | # No comment will be displayed on the change of this parameter since it is not related to the temperature of any device (CPU, GPU, etc...) but only to the settings made by the user when launching this Docker container 135 | if $DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE; then 136 | disable_third_party_PCIe_card_Dell_default_cooling_response 137 | THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE_STATUS="Disabled" 138 | else 139 | enable_third_party_PCIe_card_Dell_default_cooling_response 140 | THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE_STATUS="Enabled" 141 | fi 142 | fi 143 | 144 | # Print temperatures, active fan control profile and comment if any change happened during last time interval 145 | if [ $i -eq $TABLE_HEADER_PRINT_INTERVAL ]; then 146 | echo " ------- Temperatures -------" 147 | echo " Date & time Inlet CPU 1 CPU 2 Exhaust Active fan speed profile Third-party PCIe card Dell default cooling response Comment" 148 | i=0 149 | fi 150 | printf "%19s %3d°C %3d°C %3s°C %5s°C %40s %51s %s\n" "$(date +"%d-%m-%Y %T")" $INLET_TEMPERATURE $CPU1_TEMPERATURE "$CPU2_TEMPERATURE" "$EXHAUST_TEMPERATURE" "$CURRENT_FAN_CONTROL_PROFILE" "$THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE_STATUS" "$COMMENT" 151 | ((i++)) 152 | wait $SLEEP_PROCESS_PID 153 | done 154 | -------------------------------------------------------------------------------- /Dockerfile: -------------------------------------------------------------------------------- 1 | FROM ubuntu:latest 2 | 3 | LABEL org.opencontainers.image.authors="tigerblue77" 4 | 5 | RUN apt-get update 6 | 7 | RUN apt-get install ipmitool -y 8 | 9 | ADD functions.sh /app/functions.sh 10 | ADD healthcheck.sh /app/healthcheck.sh 11 | ADD Dell_iDRAC_fan_controller.sh /app/Dell_iDRAC_fan_controller.sh 12 | 13 | RUN chmod 0777 /app/functions.sh /app/healthcheck.sh /app/Dell_iDRAC_fan_controller.sh 14 | 15 | WORKDIR /app 16 | 17 | HEALTHCHECK --interval=30s --timeout=30s --start-period=5s --retries=3 CMD [ "/app/healthcheck.sh" ] 18 | 19 | # you should override these default values when running. See README.md 20 | # ENV IDRAC_HOST 192.168.1.100 21 | ENV IDRAC_HOST local 22 | # ENV IDRAC_USERNAME root 23 | # ENV IDRAC_PASSWORD calvin 24 | ENV FAN_SPEED 5 25 | ENV CPU_TEMPERATURE_THRESHOLD 50 26 | ENV CHECK_INTERVAL 60 27 | ENV DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE false 28 | ENV KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT false 29 | 30 | ENTRYPOINT ["./Dell_iDRAC_fan_controller.sh"] 31 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | Attribution-NonCommercial-ShareAlike 4.0 International 2 | 3 | ======================================================================= 4 | 5 | Creative Commons Corporation ("Creative Commons") is not a law firm and 6 | does not provide legal services or legal advice. Distribution of 7 | Creative Commons public licenses does not create a lawyer-client or 8 | other relationship. Creative Commons makes its licenses and related 9 | information available on an "as-is" basis. Creative Commons gives no 10 | warranties regarding its licenses, any material licensed under their 11 | terms and conditions, or any related information. Creative Commons 12 | disclaims all liability for damages resulting from their use to the 13 | fullest extent possible. 14 | 15 | Using Creative Commons Public Licenses 16 | 17 | Creative Commons public licenses provide a standard set of terms and 18 | conditions that creators and other rights holders may use to share 19 | original works of authorship and other material subject to copyright 20 | and certain other rights specified in the public license below. The 21 | following considerations are for informational purposes only, are not 22 | exhaustive, and do not form part of our licenses. 23 | 24 | Considerations for licensors: Our public licenses are 25 | intended for use by those authorized to give the public 26 | permission to use material in ways otherwise restricted by 27 | copyright and certain other rights. Our licenses are 28 | irrevocable. Licensors should read and understand the terms 29 | and conditions of the license they choose before applying it. 30 | Licensors should also secure all rights necessary before 31 | applying our licenses so that the public can reuse the 32 | material as expected. Licensors should clearly mark any 33 | material not subject to the license. This includes other CC- 34 | licensed material, or material used under an exception or 35 | limitation to copyright. More considerations for licensors: 36 | wiki.creativecommons.org/Considerations_for_licensors 37 | 38 | Considerations for the public: By using one of our public 39 | licenses, a licensor grants the public permission to use the 40 | licensed material under specified terms and conditions. If 41 | the licensor's permission is not necessary for any reason--for 42 | example, because of any applicable exception or limitation to 43 | copyright--then that use is not regulated by the license. Our 44 | licenses grant only permissions under copyright and certain 45 | other rights that a licensor has authority to grant. Use of 46 | the licensed material may still be restricted for other 47 | reasons, including because others have copyright or other 48 | rights in the material. A licensor may make special requests, 49 | such as asking that all changes be marked or described. 50 | Although not required by our licenses, you are encouraged to 51 | respect those requests where reasonable. More considerations 52 | for the public: 53 | wiki.creativecommons.org/Considerations_for_licensees 54 | 55 | ======================================================================= 56 | 57 | Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International 58 | Public License 59 | 60 | By exercising the Licensed Rights (defined below), You accept and agree 61 | to be bound by the terms and conditions of this Creative Commons 62 | Attribution-NonCommercial-ShareAlike 4.0 International Public License 63 | ("Public License"). To the extent this Public License may be 64 | interpreted as a contract, You are granted the Licensed Rights in 65 | consideration of Your acceptance of these terms and conditions, and the 66 | Licensor grants You such rights in consideration of benefits the 67 | Licensor receives from making the Licensed Material available under 68 | these terms and conditions. 69 | 70 | 71 | Section 1 -- Definitions. 72 | 73 | a. Adapted Material means material subject to Copyright and Similar 74 | Rights that is derived from or based upon the Licensed Material 75 | and in which the Licensed Material is translated, altered, 76 | arranged, transformed, or otherwise modified in a manner requiring 77 | permission under the Copyright and Similar Rights held by the 78 | Licensor. For purposes of this Public License, where the Licensed 79 | Material is a musical work, performance, or sound recording, 80 | Adapted Material is always produced where the Licensed Material is 81 | synched in timed relation with a moving image. 82 | 83 | b. Adapter's License means the license You apply to Your Copyright 84 | and Similar Rights in Your contributions to Adapted Material in 85 | accordance with the terms and conditions of this Public License. 86 | 87 | c. BY-NC-SA Compatible License means a license listed at 88 | creativecommons.org/compatiblelicenses, approved by Creative 89 | Commons as essentially the equivalent of this Public License. 90 | 91 | d. Copyright and Similar Rights means copyright and/or similar rights 92 | closely related to copyright including, without limitation, 93 | performance, broadcast, sound recording, and Sui Generis Database 94 | Rights, without regard to how the rights are labeled or 95 | categorized. For purposes of this Public License, the rights 96 | specified in Section 2(b)(1)-(2) are not Copyright and Similar 97 | Rights. 98 | 99 | e. Effective Technological Measures means those measures that, in the 100 | absence of proper authority, may not be circumvented under laws 101 | fulfilling obligations under Article 11 of the WIPO Copyright 102 | Treaty adopted on December 20, 1996, and/or similar international 103 | agreements. 104 | 105 | f. Exceptions and Limitations means fair use, fair dealing, and/or 106 | any other exception or limitation to Copyright and Similar Rights 107 | that applies to Your use of the Licensed Material. 108 | 109 | g. License Elements means the license attributes listed in the name 110 | of a Creative Commons Public License. The License Elements of this 111 | Public License are Attribution, NonCommercial, and ShareAlike. 112 | 113 | h. Licensed Material means the artistic or literary work, database, 114 | or other material to which the Licensor applied this Public 115 | License. 116 | 117 | i. Licensed Rights means the rights granted to You subject to the 118 | terms and conditions of this Public License, which are limited to 119 | all Copyright and Similar Rights that apply to Your use of the 120 | Licensed Material and that the Licensor has authority to license. 121 | 122 | j. Licensor means the individual(s) or entity(ies) granting rights 123 | under this Public License. 124 | 125 | k. NonCommercial means not primarily intended for or directed towards 126 | commercial advantage or monetary compensation. For purposes of 127 | this Public License, the exchange of the Licensed Material for 128 | other material subject to Copyright and Similar Rights by digital 129 | file-sharing or similar means is NonCommercial provided there is 130 | no payment of monetary compensation in connection with the 131 | exchange. 132 | 133 | l. Share means to provide material to the public by any means or 134 | process that requires permission under the Licensed Rights, such 135 | as reproduction, public display, public performance, distribution, 136 | dissemination, communication, or importation, and to make material 137 | available to the public including in ways that members of the 138 | public may access the material from a place and at a time 139 | individually chosen by them. 140 | 141 | m. Sui Generis Database Rights means rights other than copyright 142 | resulting from Directive 96/9/EC of the European Parliament and of 143 | the Council of 11 March 1996 on the legal protection of databases, 144 | as amended and/or succeeded, as well as other essentially 145 | equivalent rights anywhere in the world. 146 | 147 | n. You means the individual or entity exercising the Licensed Rights 148 | under this Public License. Your has a corresponding meaning. 149 | 150 | 151 | Section 2 -- Scope. 152 | 153 | a. License grant. 154 | 155 | 1. Subject to the terms and conditions of this Public License, 156 | the Licensor hereby grants You a worldwide, royalty-free, 157 | non-sublicensable, non-exclusive, irrevocable license to 158 | exercise the Licensed Rights in the Licensed Material to: 159 | 160 | a. reproduce and Share the Licensed Material, in whole or 161 | in part, for NonCommercial purposes only; and 162 | 163 | b. produce, reproduce, and Share Adapted Material for 164 | NonCommercial purposes only. 165 | 166 | 2. Exceptions and Limitations. For the avoidance of doubt, where 167 | Exceptions and Limitations apply to Your use, this Public 168 | License does not apply, and You do not need to comply with 169 | its terms and conditions. 170 | 171 | 3. Term. The term of this Public License is specified in Section 172 | 6(a). 173 | 174 | 4. Media and formats; technical modifications allowed. The 175 | Licensor authorizes You to exercise the Licensed Rights in 176 | all media and formats whether now known or hereafter created, 177 | and to make technical modifications necessary to do so. The 178 | Licensor waives and/or agrees not to assert any right or 179 | authority to forbid You from making technical modifications 180 | necessary to exercise the Licensed Rights, including 181 | technical modifications necessary to circumvent Effective 182 | Technological Measures. For purposes of this Public License, 183 | simply making modifications authorized by this Section 2(a) 184 | (4) never produces Adapted Material. 185 | 186 | 5. Downstream recipients. 187 | 188 | a. Offer from the Licensor -- Licensed Material. Every 189 | recipient of the Licensed Material automatically 190 | receives an offer from the Licensor to exercise the 191 | Licensed Rights under the terms and conditions of this 192 | Public License. 193 | 194 | b. Additional offer from the Licensor -- Adapted Material. 195 | Every recipient of Adapted Material from You 196 | automatically receives an offer from the Licensor to 197 | exercise the Licensed Rights in the Adapted Material 198 | under the conditions of the Adapter's License You apply. 199 | 200 | c. No downstream restrictions. You may not offer or impose 201 | any additional or different terms or conditions on, or 202 | apply any Effective Technological Measures to, the 203 | Licensed Material if doing so restricts exercise of the 204 | Licensed Rights by any recipient of the Licensed 205 | Material. 206 | 207 | 6. No endorsement. Nothing in this Public License constitutes or 208 | may be construed as permission to assert or imply that You 209 | are, or that Your use of the Licensed Material is, connected 210 | with, or sponsored, endorsed, or granted official status by, 211 | the Licensor or others designated to receive attribution as 212 | provided in Section 3(a)(1)(A)(i). 213 | 214 | b. Other rights. 215 | 216 | 1. Moral rights, such as the right of integrity, are not 217 | licensed under this Public License, nor are publicity, 218 | privacy, and/or other similar personality rights; however, to 219 | the extent possible, the Licensor waives and/or agrees not to 220 | assert any such rights held by the Licensor to the limited 221 | extent necessary to allow You to exercise the Licensed 222 | Rights, but not otherwise. 223 | 224 | 2. Patent and trademark rights are not licensed under this 225 | Public License. 226 | 227 | 3. To the extent possible, the Licensor waives any right to 228 | collect royalties from You for the exercise of the Licensed 229 | Rights, whether directly or through a collecting society 230 | under any voluntary or waivable statutory or compulsory 231 | licensing scheme. In all other cases the Licensor expressly 232 | reserves any right to collect such royalties, including when 233 | the Licensed Material is used other than for NonCommercial 234 | purposes. 235 | 236 | 237 | Section 3 -- License Conditions. 238 | 239 | Your exercise of the Licensed Rights is expressly made subject to the 240 | following conditions. 241 | 242 | a. Attribution. 243 | 244 | 1. If You Share the Licensed Material (including in modified 245 | form), You must: 246 | 247 | a. retain the following if it is supplied by the Licensor 248 | with the Licensed Material: 249 | 250 | i. identification of the creator(s) of the Licensed 251 | Material and any others designated to receive 252 | attribution, in any reasonable manner requested by 253 | the Licensor (including by pseudonym if 254 | designated); 255 | 256 | ii. a copyright notice; 257 | 258 | iii. a notice that refers to this Public License; 259 | 260 | iv. a notice that refers to the disclaimer of 261 | warranties; 262 | 263 | v. a URI or hyperlink to the Licensed Material to the 264 | extent reasonably practicable; 265 | 266 | b. indicate if You modified the Licensed Material and 267 | retain an indication of any previous modifications; and 268 | 269 | c. indicate the Licensed Material is licensed under this 270 | Public License, and include the text of, or the URI or 271 | hyperlink to, this Public License. 272 | 273 | 2. You may satisfy the conditions in Section 3(a)(1) in any 274 | reasonable manner based on the medium, means, and context in 275 | which You Share the Licensed Material. For example, it may be 276 | reasonable to satisfy the conditions by providing a URI or 277 | hyperlink to a resource that includes the required 278 | information. 279 | 3. If requested by the Licensor, You must remove any of the 280 | information required by Section 3(a)(1)(A) to the extent 281 | reasonably practicable. 282 | 283 | b. ShareAlike. 284 | 285 | In addition to the conditions in Section 3(a), if You Share 286 | Adapted Material You produce, the following conditions also apply. 287 | 288 | 1. The Adapter's License You apply must be a Creative Commons 289 | license with the same License Elements, this version or 290 | later, or a BY-NC-SA Compatible License. 291 | 292 | 2. You must include the text of, or the URI or hyperlink to, the 293 | Adapter's License You apply. You may satisfy this condition 294 | in any reasonable manner based on the medium, means, and 295 | context in which You Share Adapted Material. 296 | 297 | 3. You may not offer or impose any additional or different terms 298 | or conditions on, or apply any Effective Technological 299 | Measures to, Adapted Material that restrict exercise of the 300 | rights granted under the Adapter's License You apply. 301 | 302 | 303 | Section 4 -- Sui Generis Database Rights. 304 | 305 | Where the Licensed Rights include Sui Generis Database Rights that 306 | apply to Your use of the Licensed Material: 307 | 308 | a. for the avoidance of doubt, Section 2(a)(1) grants You the right 309 | to extract, reuse, reproduce, and Share all or a substantial 310 | portion of the contents of the database for NonCommercial purposes 311 | only; 312 | 313 | b. if You include all or a substantial portion of the database 314 | contents in a database in which You have Sui Generis Database 315 | Rights, then the database in which You have Sui Generis Database 316 | Rights (but not its individual contents) is Adapted Material, 317 | including for purposes of Section 3(b); and 318 | 319 | c. You must comply with the conditions in Section 3(a) if You Share 320 | all or a substantial portion of the contents of the database. 321 | 322 | For the avoidance of doubt, this Section 4 supplements and does not 323 | replace Your obligations under this Public License where the Licensed 324 | Rights include other Copyright and Similar Rights. 325 | 326 | 327 | Section 5 -- Disclaimer of Warranties and Limitation of Liability. 328 | 329 | a. UNLESS OTHERWISE SEPARATELY UNDERTAKEN BY THE LICENSOR, TO THE 330 | EXTENT POSSIBLE, THE LICENSOR OFFERS THE LICENSED MATERIAL AS-IS 331 | AND AS-AVAILABLE, AND MAKES NO REPRESENTATIONS OR WARRANTIES OF 332 | ANY KIND CONCERNING THE LICENSED MATERIAL, WHETHER EXPRESS, 333 | IMPLIED, STATUTORY, OR OTHER. THIS INCLUDES, WITHOUT LIMITATION, 334 | WARRANTIES OF TITLE, MERCHANTABILITY, FITNESS FOR A PARTICULAR 335 | PURPOSE, NON-INFRINGEMENT, ABSENCE OF LATENT OR OTHER DEFECTS, 336 | ACCURACY, OR THE PRESENCE OR ABSENCE OF ERRORS, WHETHER OR NOT 337 | KNOWN OR DISCOVERABLE. WHERE DISCLAIMERS OF WARRANTIES ARE NOT 338 | ALLOWED IN FULL OR IN PART, THIS DISCLAIMER MAY NOT APPLY TO YOU. 339 | 340 | b. TO THE EXTENT POSSIBLE, IN NO EVENT WILL THE LICENSOR BE LIABLE 341 | TO YOU ON ANY LEGAL THEORY (INCLUDING, WITHOUT LIMITATION, 342 | NEGLIGENCE) OR OTHERWISE FOR ANY DIRECT, SPECIAL, INDIRECT, 343 | INCIDENTAL, CONSEQUENTIAL, PUNITIVE, EXEMPLARY, OR OTHER LOSSES, 344 | COSTS, EXPENSES, OR DAMAGES ARISING OUT OF THIS PUBLIC LICENSE OR 345 | USE OF THE LICENSED MATERIAL, EVEN IF THE LICENSOR HAS BEEN 346 | ADVISED OF THE POSSIBILITY OF SUCH LOSSES, COSTS, EXPENSES, OR 347 | DAMAGES. WHERE A LIMITATION OF LIABILITY IS NOT ALLOWED IN FULL OR 348 | IN PART, THIS LIMITATION MAY NOT APPLY TO YOU. 349 | 350 | c. The disclaimer of warranties and limitation of liability provided 351 | above shall be interpreted in a manner that, to the extent 352 | possible, most closely approximates an absolute disclaimer and 353 | waiver of all liability. 354 | 355 | 356 | Section 6 -- Term and Termination. 357 | 358 | a. This Public License applies for the term of the Copyright and 359 | Similar Rights licensed here. However, if You fail to comply with 360 | this Public License, then Your rights under this Public License 361 | terminate automatically. 362 | 363 | b. Where Your right to use the Licensed Material has terminated under 364 | Section 6(a), it reinstates: 365 | 366 | 1. automatically as of the date the violation is cured, provided 367 | it is cured within 30 days of Your discovery of the 368 | violation; or 369 | 370 | 2. upon express reinstatement by the Licensor. 371 | 372 | For the avoidance of doubt, this Section 6(b) does not affect any 373 | right the Licensor may have to seek remedies for Your violations 374 | of this Public License. 375 | 376 | c. For the avoidance of doubt, the Licensor may also offer the 377 | Licensed Material under separate terms or conditions or stop 378 | distributing the Licensed Material at any time; however, doing so 379 | will not terminate this Public License. 380 | 381 | d. Sections 1, 5, 6, 7, and 8 survive termination of this Public 382 | License. 383 | 384 | 385 | Section 7 -- Other Terms and Conditions. 386 | 387 | a. The Licensor shall not be bound by any additional or different 388 | terms or conditions communicated by You unless expressly agreed. 389 | 390 | b. Any arrangements, understandings, or agreements regarding the 391 | Licensed Material not stated herein are separate from and 392 | independent of the terms and conditions of this Public License. 393 | 394 | 395 | Section 8 -- Interpretation. 396 | 397 | a. For the avoidance of doubt, this Public License does not, and 398 | shall not be interpreted to, reduce, limit, restrict, or impose 399 | conditions on any use of the Licensed Material that could lawfully 400 | be made without permission under this Public License. 401 | 402 | b. To the extent possible, if any provision of this Public License is 403 | deemed unenforceable, it shall be automatically reformed to the 404 | minimum extent necessary to make it enforceable. If the provision 405 | cannot be reformed, it shall be severed from this Public License 406 | without affecting the enforceability of the remaining terms and 407 | conditions. 408 | 409 | c. No term or condition of this Public License will be waived and no 410 | failure to comply consented to unless expressly agreed to by the 411 | Licensor. 412 | 413 | d. Nothing in this Public License constitutes or may be interpreted 414 | as a limitation upon, or waiver of, any privileges and immunities 415 | that apply to the Licensor or You, including from the legal 416 | processes of any jurisdiction or authority. 417 | 418 | ======================================================================= 419 | 420 | Creative Commons is not a party to its public 421 | licenses. Notwithstanding, Creative Commons may elect to apply one of 422 | its public licenses to material it publishes and in those instances 423 | will be considered the “Licensor.” The text of the Creative Commons 424 | public licenses is dedicated to the public domain under the CC0 Public 425 | Domain Dedication. Except for the limited purpose of indicating that 426 | material is shared under a Creative Commons public license or as 427 | otherwise permitted by the Creative Commons policies published at 428 | creativecommons.org/policies, Creative Commons does not authorize the 429 | use of the trademark "Creative Commons" or any other trademark or logo 430 | of Creative Commons without its prior written consent including, 431 | without limitation, in connection with any unauthorized modifications 432 | to any of its public licenses or any other arrangements, 433 | understandings, or agreements concerning use of licensed material. For 434 | the avoidance of doubt, this paragraph does not form part of the 435 | public licenses. 436 | 437 | Creative Commons may be contacted at creativecommons.org. -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |
2 | 3 | # Dell iDRAC fan controller Docker image 4 | 5 | ## Table of contents 6 |
    7 |
  1. Container console log example
    2. 8 |
  2. Requirements
    3. 9 |
  3. Supported architectures
    4. 10 |
  4. Download Docker image
    5. 11 |
  5. Usage
    6. 12 |
  6. Parameters
    7. 13 |
  7. Troubleshooting
    8. 14 |
  8. Contributing
    9. 15 |
  9. License
    10. 16 |
17 | 18 | ## Container console log example 19 | 20 | ![image](https://user-images.githubusercontent.com/37409593/216442212-d2ad7ff7-0d6f-443f-b8ac-c67b5f613b83.png) 21 | 22 |

(back to top)

23 | 24 | 25 | ## Requirements 26 | ### iDRAC version 27 | 28 | This Docker container only works on Dell PowerEdge servers that support IPMI commands, i.e. < iDRAC 9 firmware 3.30.30.30. 29 | 30 | ### To access iDRAC over LAN (not needed in "local" mode) : 31 | 32 | 1. Log into your iDRAC web console 33 | 34 | ![001](https://user-images.githubusercontent.com/37409593/210168273-7d760e47-143e-4a6e-aca7-45b483024139.png) 35 | 36 | 2. In the left side menu, expand "iDRAC settings", click "Network" then click "IPMI Settings" link at the top of the web page. 37 | 38 | ![002](https://user-images.githubusercontent.com/37409593/210168249-994f29cc-ac9e-4667-84f7-07f6d9a87522.png) 39 | 40 | 3. Check the "Enable IPMI over LAN" checkbox then click "Apply" button. 41 | 42 | ![003](https://user-images.githubusercontent.com/37409593/210168248-a68982c4-9fe7-40e7-8b2c-b3f06fbfee62.png) 43 | 44 | 4. Test access to IPMI over LAN running the following commands : 45 | ```bash 46 | apt -y install ipmitool 47 | ipmitool -I lanplus \ 48 | -H \ 49 | -U \ 50 | -P \ 51 | sdr elist all 52 | ``` 53 | 54 |

(back to top)

55 | 56 | 57 | ## Supported architectures 58 | 59 | This Docker container is currently built and available for the following CPU architectures : 60 | - AMD64 61 | - ARM64 62 | 63 |

(back to top)

64 | 65 | 66 | ## Download Docker image 67 | 68 | - [Docker Hub](https://hub.docker.com/r/tigerblue77/dell_idrac_fan_controller) 69 | - [GitHub Containers Repository](https://github.com/tigerblue77/Dell_iDRAC_fan_controller_Docker/pkgs/container/dell_idrac_fan_controller) 70 | 71 |

(back to top)

72 | 73 | 74 | ## Usage 75 | 76 | 1. with local iDRAC: 77 | 78 | ```bash 79 | docker run -d \ 80 | --name Dell_iDRAC_fan_controller \ 81 | --restart=unless-stopped \ 82 | -e IDRAC_HOST=local \ 83 | -e FAN_SPEED= \ 84 | -e CPU_TEMPERATURE_THRESHOLD= \ 85 | -e CHECK_INTERVAL= \ 86 | -e DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE= \ 87 | -e KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT= \ 88 | --device=/dev/ipmi0:/dev/ipmi0:rw \ 89 | tigerblue77/dell_idrac_fan_controller:latest 90 | ``` 91 | 92 | 2. with LAN iDRAC: 93 | 94 | ```bash 95 | docker run -d \ 96 | --name Dell_iDRAC_fan_controller \ 97 | --restart=unless-stopped \ 98 | -e IDRAC_HOST= \ 99 | -e IDRAC_USERNAME= \ 100 | -e IDRAC_PASSWORD= \ 101 | -e FAN_SPEED= \ 102 | -e CPU_TEMPERATURE_THRESHOLD= \ 103 | -e CHECK_INTERVAL= \ 104 | -e DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE= \ 105 | -e KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT= \ 106 | tigerblue77/dell_idrac_fan_controller:latest 107 | ``` 108 | 109 | `docker-compose.yml` examples: 110 | 111 | 1. to use with local iDRAC: 112 | 113 | ```yml 114 | version: '3.8' 115 | 116 | services: 117 | Dell_iDRAC_fan_controller: 118 | image: tigerblue77/dell_idrac_fan_controller:latest 119 | container_name: Dell_iDRAC_fan_controller 120 | restart: unless-stopped 121 | environment: 122 | - IDRAC_HOST=local 123 | - FAN_SPEED= 124 | - CPU_TEMPERATURE_THRESHOLD= 125 | - CHECK_INTERVAL= 126 | - DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE= 127 | - KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT= 128 | devices: 129 | - /dev/ipmi0:/dev/ipmi0:rw 130 | ``` 131 | 132 | 2. to use with LAN iDRAC: 133 | 134 | ```yml 135 | version: '3.8' 136 | 137 | services: 138 | Dell_iDRAC_fan_controller: 139 | image: tigerblue77/dell_idrac_fan_controller:latest 140 | container_name: Dell_iDRAC_fan_controller 141 | restart: unless-stopped 142 | environment: 143 | - IDRAC_HOST= 144 | - IDRAC_USERNAME= 145 | - IDRAC_PASSWORD= 146 | - FAN_SPEED= 147 | - CPU_TEMPERATURE_THRESHOLD= 148 | - CHECK_INTERVAL= 149 | - DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE= 150 | - KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT= 151 | ``` 152 | 153 |

(back to top)

154 | 155 | 156 | ## Parameters 157 | 158 | All parameters are optional as they have default values (including default iDRAC username and password). 159 | 160 | - `IDRAC_HOST` parameter can be set to "local" or to your distant iDRAC's IP address. **Default** value is "local". 161 | - `IDRAC_USERNAME` parameter is only necessary if you're adressing a distant iDRAC. **Default** value is "root". 162 | - `IDRAC_PASSWORD` parameter is only necessary if you're adressing a distant iDRAC. **Default** value is "calvin". 163 | - `FAN_SPEED` parameter can be set as a decimal (from 0 to 100%) or hexadecimaladecimal value (from 0x00 to 0x64) you want to set the fans to. **Default** value is 5(%). 164 | - `CPU_TEMPERATURE_THRESHOLD` parameter is the T°junction (junction temperature) threshold beyond which the Dell fan mode defined in your BIOS will become active again (to protect the server hardware against overheat). **Default** value is 50(°C). 165 | - `CHECK_INTERVAL` parameter is the time (in seconds) between each temperature check and potential profile change. **Default** value is 60(s). 166 | - `DISABLE_THIRD_PARTY_PCIE_CARD_DELL_DEFAULT_COOLING_RESPONSE` parameter is a boolean that allows to disable third-party PCIe card Dell default cooling response. **Default** value is false. 167 | - `KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT` parameter is a boolean that allows to keep the third-party PCIe card Dell default cooling response state upon exit. **Default** value is false, so that it resets the third-party PCIe card Dell default cooling response to Dell default. 168 | 169 |

(back to top)

170 | 171 | 172 | ## Troubleshooting 173 | 174 | If your server frequently switches back to the default Dell fan mode: 175 | 1. Check `Tcase` (case temperature) of your CPU on Intel Ark website and then set `CPU_TEMPERATURE_THRESHOLD` to a slightly lower value. Example with my CPUs ([Intel Xeon E5-2630L v2](https://www.intel.com/content/www/us/en/products/sku/75791/intel-xeon-processor-e52630l-v2-15m-cache-2-40-ghz/specifications.html)) : Tcase = 63°C, I set `CPU_TEMPERATURE_THRESHOLD` to 60(°C). 176 | 2. If it's already good, adapt your `FAN_SPEED` value to increase the airflow and thus further decrease the temperature of your CPU(s) 177 | 3. If neither increasing the fan speed nor increasing the threshold solves your problem, then it may be time to replace your thermal paste 178 | 179 |

(back to top)

180 | 181 | 182 | ## Contributing 183 | 184 | Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**. 185 | 186 | If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". 187 | Don't forget to give the project a star! Thanks again! 188 | 189 | 1. Fork the Project 190 | 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) 191 | 3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) 192 | 4. Push to the Branch (`git push origin feature/AmazingFeature`) 193 | 5. Open a Pull Request 194 | 195 |

(back to top)

196 | 197 | 198 | ## License 199 | 200 | Shield: [![CC BY-NC-SA 4.0][cc-by-nc-sa-shield]][cc-by-nc-sa] 201 | 202 | This work is licensed under a 203 | [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License][cc-by-nc-sa]. The full license description can be read [here][link-to-license-file]. 204 | 205 | [![CC BY-NC-SA 4.0][cc-by-nc-sa-image]][cc-by-nc-sa] 206 | 207 | [cc-by-nc-sa]: http://creativecommons.org/licenses/by-nc-sa/4.0/ 208 | [cc-by-nc-sa-image]: https://licensebuttons.net/l/by-nc-sa/4.0/88x31.png 209 | [cc-by-nc-sa-shield]: https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-lightgrey.svg 210 | [link-to-license-file]: ./LICENSE 211 | 212 |

(back to top)

213 | -------------------------------------------------------------------------------- /functions.sh: -------------------------------------------------------------------------------- 1 | # Define global functions 2 | # This function applies Dell's default dynamic fan control profile 3 | function apply_Dell_fan_control_profile() { 4 | # Use ipmitool to send the raw command to set fan control to Dell default 5 | ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0x30 0x01 0x01 > /dev/null 6 | CURRENT_FAN_CONTROL_PROFILE="Dell default dynamic fan control profile" 7 | } 8 | 9 | # This function applies a user-specified static fan control profile 10 | function apply_user_fan_control_profile() { 11 | # Use ipmitool to send the raw command to set fan control to user-specified value 12 | ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0x30 0x01 0x00 > /dev/null 13 | ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0x30 0x02 0xff $HEXADECIMAL_FAN_SPEED > /dev/null 14 | CURRENT_FAN_CONTROL_PROFILE="User static fan control profile ($DECIMAL_FAN_SPEED%)" 15 | } 16 | 17 | # Convert first parameter given ($DECIMAL_NUMBER) to hexadecimal 18 | # Usage : convert_decimal_value_to_hexadecimal $DECIMAL_NUMBER 19 | # Returns : hexadecimal value of DECIMAL_NUMBER 20 | function convert_decimal_value_to_hexadecimal() { 21 | local -r DECIMAL_NUMBER=$1 22 | local -r HEXADECIMAL_NUMBER=$(printf '0x%02x' $DECIMAL_NUMBER) 23 | echo $HEXADECIMAL_NUMBER 24 | } 25 | 26 | # Convert first parameter given ($HEXADECIMAL_NUMBER) to decimal 27 | # Usage : convert_hexadecimal_value_to_decimal "$HEXADECIMAL_NUMBER" 28 | # Returns : decimal value of HEXADECIMAL_NUMBER 29 | function convert_hexadecimal_value_to_decimal() { 30 | local -r HEXADECIMAL_NUMBER=$1 31 | local -r DECIMAL_NUMBER=$(printf '%d' $HEXADECIMAL_NUMBER) 32 | echo $DECIMAL_NUMBER 33 | } 34 | 35 | # Retrieve temperature sensors data using ipmitool 36 | # Usage : retrieve_temperatures $IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT $IS_CPU2_TEMPERATURE_SENSOR_PRESENT 37 | function retrieve_temperatures() { 38 | if (( $# != 2 )); then 39 | print_error "Illegal number of parameters.\nUsage: retrieve_temperatures \$IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT \$IS_CPU2_TEMPERATURE_SENSOR_PRESENT" 40 | return 1 41 | fi 42 | local -r IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT=$1 43 | local -r IS_CPU2_TEMPERATURE_SENSOR_PRESENT=$2 44 | 45 | local -r DATA=$(ipmitool -I $IDRAC_LOGIN_STRING sdr type temperature | grep degrees) 46 | 47 | # Parse CPU data 48 | local -r CPU_DATA=$(echo "$DATA" | grep "3\." | grep -Po '\d{2}') 49 | CPU1_TEMPERATURE=$(echo $CPU_DATA | awk "{print \$$CPU1_TEMPERATURE_INDEX;}") 50 | if $IS_CPU2_TEMPERATURE_SENSOR_PRESENT; then 51 | CPU2_TEMPERATURE=$(echo $CPU_DATA | awk "{print \$$CPU2_TEMPERATURE_INDEX;}") 52 | else 53 | CPU2_TEMPERATURE="-" 54 | fi 55 | 56 | # Parse inlet temperature data 57 | INLET_TEMPERATURE=$(echo "$DATA" | grep Inlet | grep -Po '\d{2}' | tail -1) 58 | 59 | # If exhaust temperature sensor is present, parse its temperature data 60 | if $IS_EXHAUST_TEMPERATURE_SENSOR_PRESENT; then 61 | EXHAUST_TEMPERATURE=$(echo "$DATA" | grep Exhaust | grep -Po '\d{2}' | tail -1) 62 | else 63 | EXHAUST_TEMPERATURE="-" 64 | fi 65 | } 66 | 67 | # /!\ Use this function only for Gen 13 and older generation servers /!\ 68 | function enable_third_party_PCIe_card_Dell_default_cooling_response() { 69 | # We could check the current cooling response before applying but it's not very useful so let's skip the test and apply directly 70 | ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0xce 0x00 0x16 0x05 0x00 0x00 0x00 0x05 0x00 0x00 0x00 0x00 > /dev/null 71 | } 72 | 73 | # /!\ Use this function only for Gen 13 and older generation servers /!\ 74 | function disable_third_party_PCIe_card_Dell_default_cooling_response() { 75 | # We could check the current cooling response before applying but it's not very useful so let's skip the test and apply directly 76 | ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0xce 0x00 0x16 0x05 0x00 0x00 0x00 0x05 0x00 0x01 0x00 0x00 > /dev/null 77 | } 78 | 79 | # Returns : 80 | # - 0 if third-party PCIe card Dell default cooling response is currently DISABLED 81 | # - 1 if third-party PCIe card Dell default cooling response is currently ENABLED 82 | # - 2 if the current status returned by ipmitool command output is unexpected 83 | # function is_third_party_PCIe_card_Dell_default_cooling_response_disabled() { 84 | # THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE=$(ipmitool -I $IDRAC_LOGIN_STRING raw 0x30 0xce 0x01 0x16 0x05 0x00 0x00 0x00) 85 | 86 | # if [ "$THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE" == "16 05 00 00 00 05 00 01 00 00" ]; then 87 | # return 0 88 | # elif [ "$THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE" == "16 05 00 00 00 05 00 00 00 00" ]; then 89 | # return 1 90 | # else 91 | # print_error "Unexpected output: $THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE" 92 | # return 2 93 | # fi 94 | # } 95 | 96 | # Prepare traps in case of container exit 97 | function graceful_exit() { 98 | apply_Dell_fan_control_profile 99 | 100 | # Reset third-party PCIe card cooling response to Dell default depending on the user's choice at startup 101 | if ! $KEEP_THIRD_PARTY_PCIE_CARD_COOLING_RESPONSE_STATE_ON_EXIT; then 102 | enable_third_party_PCIe_card_Dell_default_cooling_response 103 | fi 104 | 105 | print_warning_and_exit "Container stopped, Dell default dynamic fan control profile applied for safety" 106 | } 107 | 108 | # Helps debugging when people are posting their output 109 | function get_Dell_server_model() { 110 | local -r IPMI_FRU_content=$(ipmitool -I $IDRAC_LOGIN_STRING fru 2>/dev/null) # FRU stands for "Field Replaceable Unit" 111 | 112 | SERVER_MANUFACTURER=$(echo "$IPMI_FRU_content" | grep "Product Manufacturer" | awk -F ': ' '{print $2}') 113 | SERVER_MODEL=$(echo "$IPMI_FRU_content" | grep "Product Name" | awk -F ': ' '{print $2}') 114 | 115 | # Check if SERVER_MANUFACTURER is empty, if yes, assign value based on "Board Mfg" 116 | if [ -z "$SERVER_MANUFACTURER" ]; then 117 | SERVER_MANUFACTURER=$(echo "$IPMI_FRU_content" | tr -s ' ' | grep "Board Mfg :" | awk -F ': ' '{print $2}') 118 | fi 119 | 120 | # Check if SERVER_MODEL is empty, if yes, assign value based on "Board Product" 121 | if [ -z "$SERVER_MODEL" ]; then 122 | SERVER_MODEL=$(echo "$IPMI_FRU_content" | tr -s ' ' | grep "Board Product :" | awk -F ': ' '{print $2}') 123 | fi 124 | } 125 | 126 | # Define functions to check if CPU 1 and CPU 2 temperatures are above the threshold 127 | function CPU1_OVERHEATING() { [ $CPU1_TEMPERATURE -gt $CPU_TEMPERATURE_THRESHOLD ]; } 128 | function CPU2_OVERHEATING() { [ $CPU2_TEMPERATURE -gt $CPU_TEMPERATURE_THRESHOLD ]; } 129 | 130 | function print_error() { 131 | local -r ERROR_MESSAGE="$1" 132 | printf "/!\ Error /!\ %s." "$ERROR_MESSAGE" >&2 133 | } 134 | 135 | function print_error_and_exit() { 136 | local -r ERROR_MESSAGE="$1" 137 | print_error "$ERROR_MESSAGE" 138 | printf " Exiting.\n" >&2 139 | exit 1 140 | } 141 | 142 | function print_warning() { 143 | local -r WARNING_MESSAGE="$1" 144 | printf "/!\ Warning /!\ %s." "$WARNING_MESSAGE" 145 | } 146 | 147 | function print_warning_and_exit() { 148 | local -r WARNING_MESSAGE="$1" 149 | print_warning "$WARNING_MESSAGE" 150 | printf " Exiting.\n" 151 | exit 0 152 | } 153 | -------------------------------------------------------------------------------- /healthcheck.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | # Enable strict bash mode to stop the script if an uninitialized variable is used, if a command fails, or if a command with a pipe fails 4 | # Not working in some setups : https://github.com/tigerblue77/Dell_iDRAC_fan_controller/issues/48 5 | # set -euo pipefail 6 | 7 | source functions.sh 8 | 9 | # Check if the iDRAC host is set to 'local' or not then set the IDRAC_LOGIN_STRING accordingly 10 | if [[ $IDRAC_HOST == "local" ]]; then 11 | # Check that the Docker host IPMI device (the iDRAC) has been exposed to the Docker container 12 | if [ ! -e "/dev/ipmi0" ] && [ ! -e "/dev/ipmi/0" ] && [ ! -e "/dev/ipmidev/0" ]; then 13 | print_error_and_exit "Could not open device at /dev/ipmi0 or /dev/ipmi/0 or /dev/ipmidev/0, check that you added the device to your Docker container or stop using local mode" 14 | fi 15 | IDRAC_LOGIN_STRING='open' 16 | else 17 | echo "iDRAC/IPMI username: $IDRAC_USERNAME" 18 | #echo "iDRAC/IPMI password: $IDRAC_PASSWORD" 19 | IDRAC_LOGIN_STRING="lanplus -H $IDRAC_HOST -U $IDRAC_USERNAME -P $IDRAC_PASSWORD" 20 | fi 21 | 22 | ipmitool -I $IDRAC_LOGIN_STRING sdr type temperature 23 | --------------------------------------------------------------------------------