summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNicolas Hennion <nicolas@nicolargo.com>2012-11-07 21:53:05 +0100
committerNicolas Hennion <nicolas@nicolargo.com>2012-11-07 21:53:05 +0100
commitba8bbb0f8661aebb6822db203848bec0c9a6ae1d (patch)
tree906a506c30a7e10b0a214c3bd2901d15c589fc2c
parentdcd01847a772652bb7d80aabb94f06ff6315b6bf (diff)
version 1.5v1.5
-rw-r--r--Changelog22
-rw-r--r--README10
-rw-r--r--README.md87
-rwxr-xr-xglances/glances.py2
-rwxr-xr-xsetup.py4
5 files changed, 108 insertions, 17 deletions
diff --git a/Changelog b/Changelog
index 217f44db..885684d8 100644
--- a/Changelog
+++ b/Changelog
@@ -1,7 +1,9 @@
-n.n.n / 2012-11-07
-==================
+1.5 / 2012-11-07
+================
+ * Check PsUtil > 0.4.0
+ * Corect a bug on Windows and IO
* Catch timedelta issue on Amazon EC2 server / related to issue #87
* Manage Fs name > 8 chars
* Invert get_nice and nice
@@ -39,6 +41,10 @@ n.n.n / 2012-11-07
* Fixed Portuguese locale name
* Merge pull request #98 from mxjeff/html_issue
* Fixed broken HTML output (issue #97)
+
+1.4
+===
+
* version 1.4.2.1
* Test as_dict()...
* version 1.4.2
@@ -171,6 +177,10 @@ n.n.n / 2012-11-07
* Replace FsGrab by PsUtil
* DISK IO
* First version of the experimental BRANCH PSUtil replace StatGrab for CPU, LOAD and MEM
+
+ 1.3
+ ===
+
* version 1.3.7
* B&W console
* Try for all the init color sequence
@@ -207,11 +217,19 @@ n.n.n / 2012-11-07
* version 1.3
* Docs
* Change the REAME for the 1.2 version
+
+ 1.2
+ ===
+
* version 1.2
* Instructions to install on Ubuntu 10.04 and 10.10
* Ubuntu 10.04 note
* Ubuntu < 11.04 notes
* Change installation procedure
+
+ 1.1
+ ===
+
* version 1.1.3
* v1.1.2
* version 1.1.1
diff --git a/README b/README
index 50a0a737..2659f1aa 100644
--- a/README
+++ b/README
@@ -359,6 +359,16 @@ There is one line per alert with the following information:
Glances displays the current time/date and access to the embedded help screen.
+If you have ran Glances in client mode (-c), you can also see if the client is connected to the server.
+
+If client is connected:
+
+![screenshot](https://github.com/nicolargo/glances/raw/master/doc/client-connected.png)
+
+else:
+
+![screenshot](https://github.com/nicolargo/glances/raw/master/doc/client-disconnected.png)
+
On the left, you can easely seen if you are connected to a Glances server.
## Localisation
diff --git a/README.md b/README.md
index d7ce2160..2659f1aa 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ Pre-requisites (information for packagers):
### From package manager (very easy way)
-Packages exist for Arch, Fedora, Redhat, FreeBSD...
+Packages exist for Debian (SID), Arch, Fedora, Redhat, FreeBSD...
### From PyPi (easy and cross platform way)
@@ -75,9 +75,32 @@ Then install Glances:
$ export PYTHONPATH=$(brew --prefix)/lib/python2.7/site-packages
$ brew pip Glances
+If you have the following error:
+
+ Error: Failed executing: pip install glances==1.X --install-option=--prefix=/usr/local/XXX/glances/1.X (.rb:)
+ This link will help resolve the above errors:
+ https://github.com/mxcl/homebrew/wiki/bug-fixing-checklist
+
+Try to runs:
+
+ $ pip install glances==1.X --install-option=--prefix=/usr/local/XXX/glances/1.X
+ $ brew link Glances
+
+### Concerning Windows operating system
+
+Windows operating system only support the Glances in server mode. So if you ran Glances on Windows, it will be automaticaly running in server mode.
+
+To install Glances on you system:
+
+ * Install [Python for Windows](http://www.python.org/getit/)
+ * Install the [PsUtil lib](https://code.google.com/p/psutil/downloads/list)
+ * Download the latest [Glances version](https://raw.github.com/nicolargo/glances/master/glances/glances.py)
+
+I need contributors to package Glances for Windows (for exemple using [PyInstaller](http://www.pyinstaller.org/)).
+
### From source
-Get the latest version:
+Get the latest version (form GitHub):
$ rm -rf /tmp/nicolargo-glances-*
$ wget -O /tmp/glances-last.tgz https://github.com/nicolargo/glances/tarball/master
@@ -93,9 +116,27 @@ Glances use a standard GNU style installer (for a Debian like system):
## Running
-Easy way (that's all folks !):
+### In standalone mode
+
+If you want to monitor your local machine, just run:
$ glances
+
+### In client/server mode
+
+If you want to remotely monitor a machine (called server) from another one (called client).
+
+Run this command on the server:
+
+ server$ glances -s
+
+and this one on the client:
+
+ client$ glances -c @server
+
+where @server is the IP address or hostname of the server
+
+Glances uses a [XML/RPC](http://docs.python.org/2/library/simplexmlrpcserver.html) server and can be used by another client software.
## User guide
@@ -120,15 +161,26 @@ When Glances is running, you can press:
If MEM > 70%, sort by process "memory size"
-* 'c' to sort the processes list by CPU consumption
-* 'd' Disable or enable the disk IO stats
-* 'f' Disable or enable the file system stats
-* 'l' Disable or enable the logs
-* 'm' to sort the processes list by process MEM
-* 'n' Disable or enable the network interfaces stats
-* 'p' to sort by process name
+* 'b' switch between bit/s or byte/s for network IO
+* 'c' sort the processes list by CPU consumption
+* 'd' disable or enable the disk IO stats
+* 'f' disable or enable the file system stats
+* 'l' disable or enable the logs
+* 'm' sort the processes list by process MEM
+* 'n' disable or enable the network interfaces stats
+* 'p' sort by process name
+* 'w' delete finished warning logs messages
+* 'x' delete finished warning and critical logs messages
+* '1' switch between global CPU and per core stats
* 'q' Exit
+In server mode, you can set the bind address (-B ADDRESS) and listenning TCP port (-p PORT).
+
+In client mode, you can set the TCP port of the server (-p port).
+
+Default binding address is 0.0.0.0 (Glancess will listen on all the networks interfaces).
+ TCP port is 61209.
+
### Header
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/header.png)
@@ -281,11 +333,10 @@ The number of processes in the list is adapted to the screen size.
T - Traced or stopped
Z - Zombie or "hung" process
-* IO READ and WRITE: Per process IO read and write
+* IO_R and IO_W: Per process IO read and write
* TIME+: Cumulative CPU time used
* NAME: Process name or command line
-
### Logs
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/logs.png)
@@ -308,6 +359,18 @@ There is one line per alert with the following information:
Glances displays the current time/date and access to the embedded help screen.
+If you have ran Glances in client mode (-c), you can also see if the client is connected to the server.
+
+If client is connected:
+
+![screenshot](https://github.com/nicolargo/glances/raw/master/doc/client-connected.png)
+
+else:
+
+![screenshot](https://github.com/nicolargo/glances/raw/master/doc/client-disconnected.png)
+
+On the left, you can easely seen if you are connected to a Glances server.
+
## Localisation
Glances localization files exist for:
diff --git a/glances/glances.py b/glances/glances.py
index db21095f..3fa51d03 100755
--- a/glances/glances.py
+++ b/glances/glances.py
@@ -19,7 +19,7 @@
#
__appname__ = 'glances'
-__version__ = "1.5b"
+__version__ = "1.5"
__author__ = "Nicolas Hennion <nicolas@nicolargo.com>"
__licence__ = "LGPL"
diff --git a/setup.py b/setup.py
index 3e6c310b..dbd507cc 100755
--- a/setup.py
+++ b/setup.py
@@ -23,8 +23,8 @@ for mo in glob('i18n/*/LC_MESSAGES/*.mo'):
data_files.append((dirname(mo).replace('i18n/', 'share/locale/'), [mo]))
setup(name='Glances',
- version='1.5b',
- download_url='https://github.com/downloads/nicolargo/glances/glances-1.5b.tar.gz',
+ version='1.5',
+ download_url='https://github.com/downloads/nicolargo/glances/glances-1.5.tar.gz',
url='https://github.com/nicolargo/glances',
description='CLI curses-based monitoring tool',
author='Nicolas Hennion',