From 43dbb437454e1047bbc17cf57d336ace3a3da932 Mon Sep 17 00:00:00 2001 From: nicolargo Date: Sun, 2 May 2021 16:27:52 +0200 Subject: Glances version 3.1.7 --- NEWS.rst | 24 ++++++++++-- README.rst | 111 ++++++++++++++++++++++++---------------------------- docs/man/glances.1 | 2 +- glances/__init__.py | 2 +- 4 files changed, 74 insertions(+), 65 deletions(-) diff --git a/NEWS.rst b/NEWS.rst index df280e33..7565c337 100644 --- a/NEWS.rst +++ b/NEWS.rst @@ -5,9 +5,27 @@ Glances Version 3 Version 3.1.7 ============= -This version is under development. - -Please have a look on the roadmap: https://github.com/nicolargo/glances/milestone/47 +* Security audit - B411 #1025 (by nicolargo) +* GPU temperature not shown in webview #1849 (by nicolargo) +* Remove shell=True for actions (following Bandit issue report) #1851 (by nicolargo) +* Replace Travis by Github action #1850 (by nicolargo) +* '/api/3/processlist/pid/3936'use this api can't get right info,all messy code #1828 (by nicolargo) +* Refactor the way importants stats are displayed #1826 (by nicolargo) +* Reaplly the Add hide option to sensors plugin #1596 PR (by nicolargo) +* Smart plugin error while start glances as root #1806 (by nicolargo) +* Plugin quicklook takes more than one seconds to update #1820 (by nicolargo) +* Replace Pystache by Chevron 2/2 See #1817 (by nicolargo) +* Doc. No SMART screenshot. #1799 (by nicolargo) +* Update docs following PR #1798 (by nicolargo) + +Contributors for this version: +- Nicolargo +- Deosrc +- dependabot[bot] +- Michael J. Cohen +- Rui Chen +- Stefan Eßer +- Tuux Version 3.1.6.2 =============== diff --git a/README.rst b/README.rst index 0a124af6..e518768e 100644 --- a/README.rst +++ b/README.rst @@ -57,9 +57,15 @@ add new plugins or exports modules. Requirements ============ -- ``python 2.7,>=3.4`` +- ``python>=2.7`` or ``python>=3.4`` - ``psutil>=5.3.0`` (better with latest version) +*Note for Python 2.6 users* + +Glances no longer supports Python 2.6. Please upgrade +to a minimum Python version of 2.7/3.4+ or downgrade to Glances 2.6.2 (last version +with Python 2.6 support). + Optional dependencies: - ``bernhard`` (for the Riemann export module) @@ -91,57 +97,27 @@ Optional dependencies: - ``wifi`` (for the wifi plugin) [Linux-only] - ``zeroconf`` (for the autodiscover mode) -*Note for Python 2.6 users* - -Glances no longer supports Python 2.6. Please upgrade -to a minimum Python version of 2.7/3.4+ or downgrade to Glances 2.6.2 (last version -with Python 2.6 support). - -*Note for CentOS Linux 6 and 7 users* - -Python 2.7 and 3.4 are now available via SCL repositories. See: -https://lists.centos.org/pipermail/centos-announce/2015-December/021555.html. - Installation ============ There are several methods to test/install Glances on your system. Choose your weapon! -Glances Auto Install script: the total way ------------------------------------------- - -To install both dependencies and the latest Glances production ready version -(aka *master* branch), just enter the following command line: - -.. code-block:: console - - curl -L https://bit.ly/glances | /bin/bash - -or - -.. code-block:: console - - wget -O- https://bit.ly/glances | /bin/bash - -*Note*: This is only supported on some GNU/Linux distributions and Mac OS X. -If you want to support other distributions, please contribute to `glancesautoinstall`_. - PyPI: The simple way -------------------- Glances is on ``PyPI``. By using PyPI, you will be using the latest stable version. -To install, simply use ``pip``: +To install Glances, simply use ``pip``: .. code-block:: console - pip install glances + pip install --user glances -*Note*: Python headers are required to install `psutil`_. For example, -on Debian/Ubuntu you need to install first the *python-dev* package. -For Fedora/CentOS/RHEL install first *python-devel* package. For Windows, -just install psutil from the binary installation file. +*Note*: Python headers are required to install `psutil`_, a Glances +dependencie. For example, on Debian/Ubuntu you need to install first +the *python-dev* package (*python-devel* on Fedora/CentOS/RHEL). +For Windows, just install psutil from the binary installation file. *Note 2 (for the Wifi plugin)*: If you want to use the Wifi plugin, you need to install the *wireless-tools* package on your system. @@ -151,14 +127,14 @@ features (like the Web interface, exports modules...): .. code-block:: console - pip install 'glances[action,browser,cloud,cpuinfo,docker,export,folders,gpu,graph,ip,raid,snmp,web,wifi]' + pip install --user 'glances[action,browser,cloud,cpuinfo,docker,export,folders,gpu,graph,ip,raid,snmp,web,wifi]' To upgrade Glances to the latest version: .. code-block:: console - pip install --upgrade glances - pip install --upgrade glances[...] + pip install --user --upgrade glances + pip install --user --upgrade glances[...] If you need to install Glances in a specific user location, use: @@ -167,25 +143,50 @@ If you need to install Glances in a specific user location, use: export PYTHONUSERBASE=~/mylocalpath pip install --user glances +If you are administrator and want to install Glances for all users: + +.. code-block:: console + + sudo pip install glances + The current develop branch is also published to the test.pypi.org package index. If you want to test the develop version, enter: .. code-block:: console - pip install -i https://test.pypi.org/simple/ Glances + pip install --user -i https://test.pypi.org/simple/ Glances + + +Glances Auto Install script: the total way +------------------------------------------ + +To install both dependencies and the latest Glances production ready version +(aka *master* branch), just enter the following command line: + +.. code-block:: console + + curl -L https://bit.ly/glances | /bin/bash + +or + +.. code-block:: console + + wget -O- https://bit.ly/glances | /bin/bash + +*Note*: This is only supported on some GNU/Linux distributions and Mac OS X. +If you want to support other distributions, please contribute to `glancesautoinstall`_. Docker: the funny way --------------------- -A Glances container is available. It includes the latest development -HEAD version. You can use it to monitor your server and all your other -containers! +Glances containers are availables. You can use it to monitor your +server and all your other containers! -Get the Glances container (latest develop branch): +Get the Glances container: .. code-block:: console - docker pull nicolargo/glances:dev + docker pull nicolargo/glances:latest Note, you can choose another branch with : @@ -197,14 +198,14 @@ Run the container in *console mode*: .. code-block:: console - docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host --network host -it nicolargo/glances:dev + docker run --rm -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host --network host -it nicolargo/glances:latest Additionally, if you want to use your own glances.conf file, you can create your own Dockerfile: .. code-block:: console - FROM nicolargo/glances:dev + FROM nicolargo/glances:latest COPY glances.conf /glances/conf/glances.conf CMD python -m glances -C /glances/conf/glances.conf $GLANCES_OPT @@ -213,7 +214,7 @@ docker run options: .. code-block:: console - docker run -v `pwd`/glances.conf:/glances/conf/glances.conf -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host -it nicolargo/glances:dev + docker run -v `pwd`/glances.conf:/glances/conf/glances.conf -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host -it nicolargo/glances:latest Where \`pwd\`/glances.conf is a local directory containing your glances.conf file. @@ -222,7 +223,7 @@ variable setting parameters for the glances startup command): .. code-block:: console - docker run -d --restart="always" -p 61208-61209:61208-61209 -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host nicolargo/glances:dev + docker run -d --restart="always" -p 61208-61209:61208-61209 -e GLANCES_OPT="-w" -v /var/run/docker.sock:/var/run/docker.sock:ro --pid host nicolargo/glances:latest GNU/Linux --------- @@ -232,7 +233,6 @@ able to install it using your favorite package manager. Be aware that when you use this method the operating system `package`_ for `Glances` may not be the latest version. - FreeBSD ------- @@ -280,15 +280,6 @@ then run the following command: $ pip install glances -Alternatively, you could clone the repository and install with the following command. - -.. code-block:: console - - $ git clone https://github.com/nicolargo/glances.git - $ cd glances - $ python setup.py install - - Android ------- diff --git a/docs/man/glances.1 b/docs/man/glances.1 index e8a997e0..33426675 100644 --- a/docs/man/glances.1 +++ b/docs/man/glances.1 @@ -1,6 +1,6 @@ .\" Man page generated from reStructuredText. . -.TH "GLANCES" "1" "Apr 25, 2021" "3.1.7b1" "Glances" +.TH "GLANCES" "1" "May 02, 2021" "3.1.7" "Glances" .SH NAME glances \- An eye on your system . diff --git a/glances/__init__.py b/glances/__init__.py index 9d54bace..7ea06ac8 100644 --- a/glances/__init__.py +++ b/glances/__init__.py @@ -29,7 +29,7 @@ import sys # Global name # Version should start and end with a numerical char # See https://packaging.python.org/specifications/core-metadata/#version -__version__ = '3.1.7b1' +__version__ = '3.1.7' __author__ = 'Nicolas Hennion ' __license__ = 'LGPLv3' -- cgit v1.2.3