-*------------------------------------------------------------------------+-
QtSmbstatus
http://qtsmbstatus.free.fr/
Daniel ROCHER
-*------------------------------------------------------------------------+-
This program is licensed to you under the terms of the GNU General Public License version 2
QtSmbstatus is a smbstatus graphical interface (GUI).
It is meant to provide the possibility of administering remote machines.
QtSmbstatus was designed as a client/server system secured with SSL.
A login and password is required to log on to server. The server's application ought to be installed with samba-server.
qtsmbstatus-server provides the server-side application.
qtsmbstatus-client provides the qtsmbtatus client application.
qtsmbstatus-light provides the lightweight application which works only locally and doesn't require qtsmbstatus-server.
Possibilities include:
- view connections
- disconnect user
- send out messages (popupwindows) to one or many users
1/ Compilation from the following sources
2/ Command line options
3/ Start and stop server
4/ Configure server
5/ Client for X11 (Unix/Linux)
6/ Client for Windows
-------------------------------------------------------------
1/ Compilation from the following sources:
-------------------------------------------------------------
To install qtsmbstatus light:
*****************************
Check dependency: qt4-dev>=4.3
cd light
qmake (or qmake-qt4)
make
and as root:
make install
To install qtsmbstatus server:
******************************
Check dependency: pam-dev and qt4-dev>=4.3
cd server
qmake (or qmake-qt4)
make
and as root:
make install
To install qtsmbstatus client:
******************************
Check dependency: qt4-dev>=4.3
cd client
qmake (or qmake-qt4)
make
and as root:
make install
-------------------------------------------------------------
2/ Command line options:
-------------------------------------------------------------
qtsmbstatus (light, client and server) can accept some arguments from the command line, to know them:
qtsmbstatusd --help (for server)
qtsmbstatus --help (for client)
qtsmbstatusl --help (for light)
-------------------------------------------------------------
3/ Start and stop server:
-------------------------------------------------------------
Start server:
/etc/init.d/qtsmbstatusd start
or
service qtsmbstatusd start
Default port: 4443
Stop server:
/etc/init.d/qtsmbstatusd stop
or
service qtsmbstatusd stop
-------------------------------------------------------------
4/ Configure server:
-------------------------------------------------------------
The server's configuration files are found at:
/etc/qtsmbstatusd/
in this directory:
privkey.pem
qtsmbstatusd.conf
qtsmbstatusd.users
server.pem
privkey.pem : private key (warning! Change file access permissions : 640 ! )
To make your own: openssl genrsa -des3 -out privkey.pem 2048
server.pem : selfsigned certificat with key
To make your own: openssl req -new -x509 -key privkey.pem -out server.pem -days 10000
Options are saved into : qtsmbstatusd.conf
port : Port where the server should listen at
private_key : private key
certificat : ssl certificate
ssl_password : password for ssl certificate
permit_disconnect_user : Allow client to disconnect a user
You can authorize a client to disconnect a user. Use Username
or 'all' for all clients.
permit_send_msg : Allow client to send a message
You can authorize a client to Send message. Use Username or 'all' for all clients.
== PAM: ==
PAM configuration file is distribution dependent. If logon failed, change it:
/etc/pam.d/qtsmbstusd
see samples here: ./server/pam.d/samples/
The authorized users (PAM) are registered into: /etc/qtsmbstatusd/qtsmbstatusd.users
(default as root)
-------------------------------------------------------------
5/ Client for X11 (Unix/Linux) :
-------------------------------------------------------------
Execute under X11: qtsmbstatus
Enter server's IP address, connect and log on (login and password).
Right clic on user to send him a message or to disconnect him.
(popupwindows require smbclient)
-------------------------------------------------------------
6/ Client for Windows :
-------------------------------------------------------------
Install qtsmbstatus-client.X.X.X.exe
Execute qtsmbstatus.exe
Enter server's IP address, connect and log on (login and password).
Right clic on user to send him a message or to disconnect him.
(popupwindows require smbclient)
2014-05-02
