Allow synonyms for localhost
[spider.git] / gtkconsole / README
1 How to install and use Gtkconsole
2 ---------------------------------
3
4 For Linux users:-
5
6 Please make sure that you have the following perl packages loaded:-
7
8 * Gtk2
9
10 this is best obtained from your distro's packaging system. For
11 Ubuntu/Debian users, something like (as root or via sudo):-
12
13   aptitude install libgtk2-perl
14
15 or for Fedora users:-
16
17   yum install perl-Gtk2 perl-Gtk2-Ex-Simple-List perl-Gtk2-Ex-Utils
18
19 For Windows Users:-
20
21 This is a bit more complicated but you should either follow the instructions
22 on:-
23
24   http://www.lostmind.de/gtk2-perl/
25
26 The important thing is that you should be running an activestate perl
27 in the 5.8 series. It may work with an earlier 5.6.1 build but I now
28 longer have the where withall to test it. Now would be a good time to
29 upgrade to the perl suggested on the webpage. The link points directly
30 to the activestate download site.
31
32 You do need the GTK+ runtime.
33 You don't need Glade.
34
35 Follow the instructions in "Installation instructions" and you are
36 strongly advised to use the method outlined in 2a) and not 2b).
37
38 Don't bother with running gtk-demo.
39
40 You will need to reboot the machine (at least once) even though there
41 isn't a message that says you should. I *think* I had to reboot twice
42 before it worked.
43
44 I am using a slightly earlier activestate perl than build 819, mine is
45 build 815. It still seems to work for me.
46
47            ------------------------------------------------
48
49 Running the program:-
50
51   cd /spider/gtkconsole
52   perl gtkconsole
53
54 This should work if you are running it on the same machine as the
55 cluster.  Otherwise, if you get errors try:-
56
57   perl gtkconsole <your sysop call> localhost 7300
58
59 where localhost and 7300 are the IP address and port of the cluster
60 you want to use.
61
62 The interface is very basic at the moment, but it will improve and get
63 added to as time permits.
64
65 You will notice that various windows will popup automatically as data
66 for those windows arrives. You can't stop any of these at the
67 moment. It is a feature.
68
69 The main window has an entry box at the bottom of the screen. You put
70 your normal sysop commands in there.
71
72 Please report problems and feature requests to the dxspider-support
73 list.
74
75 Dirk G1TLH