You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
156 lines
4.5 KiB
156 lines
4.5 KiB
!!! Warning: Read this through to the end. These tools can be dangerous. !!!
|
|
|
|
Guidance 0.8.0
|
|
~~~~~~~~~~~~~~
|
|
by Simon Edwards <simon@simonzone.com>, Sebastian Kügler <sebas@vizzzion.org>
|
|
& Yuriy Kozlov <yuriy.kozlov@gmail.com>, Martin Böhm <martin.bohm@kubuntu.org>
|
|
|
|
|
|
Introduction
|
|
------------
|
|
Guidance is a collection of system administration tools for Linux/TDE systems
|
|
that is designed to be:
|
|
|
|
* Update to date
|
|
* High quality, designed with user friendliness as high priority. (That is
|
|
to say that the tools should get the job done quickly, accurately and with
|
|
as little effort as possible.)
|
|
* Use TDE and "fit in" with TDE.
|
|
* Maintainable.
|
|
* Free Software
|
|
|
|
|
|
Warning
|
|
-------
|
|
These tools often require root access and modify important system files in
|
|
order to do their job. There is a very real chance that these tools can
|
|
destroy your computer and your data. Backup your data! Also especially
|
|
backup up /etc/passwd, /etc/shadow and /etc/fstab. If you don't know what
|
|
I'm talking about now then you probably shouldn't try using Guidance yet.
|
|
You should have some idea how to fix
|
|
|
|
We accept no responsibility in the event that something goes terribly wrong.
|
|
You have been warned.
|
|
|
|
|
|
Status
|
|
------
|
|
The tools that make up Guidance are in different stages of development and
|
|
have only been tested on Mandrake.
|
|
|
|
* userconfig - User & Group configuration. Supports /etc/passwd and
|
|
/etc/shadow right now.
|
|
|
|
* serviceconfig - System services configuration utility. Feature complete.
|
|
Works on Mandrake, Debian, (K)ubuntu Gentoo and maybe Red Hat out of the box.
|
|
|
|
* mountconfig - Mount point configuration utility. Feature complete and
|
|
stable.
|
|
|
|
* wineconfig - Wine configuration utility.
|
|
|
|
* grubconfig - Grub boot loader configuration utility. beta quality now.
|
|
|
|
|
|
Requirements
|
|
------------
|
|
* Linux.
|
|
|
|
* Python. 2.4 recommended. You probably already have Python installed, and if
|
|
not then it will most definately be available for you distribution of choice.
|
|
|
|
* PyQt / PyKDE. Version 3.7 or higher. PyQt and PyKDE are distributed with
|
|
TDE as part of kde-bindings since version 3.3.
|
|
|
|
For versions of KDE before 3.3 it is possible to install PyQt/PyKDE
|
|
directly. The homepage for PyQt and PyKDE is:
|
|
|
|
http://www.riverbankcomputing.co.uk/pytde/index.php
|
|
|
|
Packages for most popular distributions are available here:
|
|
|
|
http://sourceforge.net/project/showfiles.php?group_id=61057
|
|
|
|
* KDE 3.
|
|
|
|
* "PyKDE Extensions" is needed for installation. It is available here:
|
|
http://www.simonzone.com/software/pytdeextensions/
|
|
This is also a runtime requirement!
|
|
|
|
* libpythonize. If you don't want the tools to appear on the TDE Control
|
|
Center of you just don't want to bother with libpythonize, then you can
|
|
build Guidance with this command:
|
|
|
|
python setup.py install build_kcm --no-kcontrol
|
|
|
|
libpythonize is only needed for the Trinity Control Center.
|
|
|
|
* You also need to have the development files from your X-server installed,
|
|
XFree86 or Xorg. Most distributions package these files up in a package
|
|
called XFree86-devel, or Xorg-devel, or libxorg-X11-devel or some similar.
|
|
|
|
* Specifically, the following packages are needed on Kubuntu:
|
|
|
|
build-essential
|
|
python-sip4-dev
|
|
libxxf86vm-dev
|
|
libxrender-dev
|
|
libxrandr-dev
|
|
libpythonize0-dev
|
|
pyqt-tools
|
|
libtool
|
|
kde-devel
|
|
|
|
|
|
Installation
|
|
------------
|
|
As root run:
|
|
|
|
./setup.py install
|
|
|
|
This will test for a working installation of PyQt/PyKDE and automatically
|
|
install the files using the same installation prefix as TDE. You will need
|
|
to have a working Python install before you can even run the setup.py script.
|
|
|
|
Running
|
|
-------
|
|
Installation should add a couple of entries to the Trinity Control Center in the
|
|
System section. It is also possible
|
|
to run the commands outside of the Trinity Control Center from the shell as root:
|
|
|
|
* serviceconfig
|
|
* userconfig
|
|
* mountconfig
|
|
* wineconfig
|
|
* grubconfig
|
|
|
|
Reporting Bugs
|
|
--------------
|
|
Bug reports and feedback can be sent to simon@simonzone.com . Do make sure
|
|
that say which version of Guidance you are using and also what Linux
|
|
distribution you are using, and also how you installed SIP, PyQt, PyKDE. Also
|
|
if any error messages are printing to the console, email those too. By
|
|
running these tools from the command line you can often get useful (to me)
|
|
debug information. That kind of information is valuable.
|
|
|
|
|
|
Deinstallation
|
|
--------------
|
|
As root run:
|
|
|
|
./setup.py uninstall
|
|
|
|
|
|
Thanks go to
|
|
------------
|
|
Jim Bublitz
|
|
David Boddie
|
|
Sebastian Kügler
|
|
Theo Houtman
|
|
Pete Andrews (gamma correction system)
|
|
|
|
|
|
--
|
|
Simon Edwards
|
|
<simon@simonzone.com>
|