GxSNMP prototype-FAQ/HOWTO (version 0.0.15.1) 0. Version Information Q: Information on this FAQ/HOWTO? 1. Introduction and General Information Q: What is GxSNMP? Q: What platforms are supported by GxSNMP? Q: How much hard disk space/memory does GxSNMP need? Q: Is GxSNMP public domain? Copyrighted? Q: What SNMP agents has this been tested against. 2. Network sources and resources. Q: Where can I get the HOWTO's and other documentation? Q: Where should I look on the World Wide Web for GxSNMP stuff? Q: Where can I get GxSNMP material by FTP? Q: What newsgroups/mailing-lists are there for GxSNMP? Q: Are the newsgroups/mailing-lists archived anywhere? 3. HOWTO Section Q: What software/sources/rpms should i get to run GxSNMP? Q: Is a database needed to install GxSNMP? Q: How do i build GxSNMP from sources? Q: Must GxSNMP be installed to work. Q: I try to configure the Database but the whole thing core-dumps! Q: The database is running but it seems that gxsnmp can't connect to the database. How could I trace ? Q: Menu configure->Database is greyed out. Q: when going into menu configure->Properties pull down list in SQL tab contains nothing. Q: After GxSNMP is installed, do I need to create a database in MySQL or does itself create the DB ? 4. UNRESOLVED Section Q: GxSNMP living in its own directory? Q: No symbols appear on my map. Do i need the database running correctly to show the symbols ? Q: Doing something on data-collection and reporting? ===================================================================== 0. Version Information Q: Information on this FAQ/HOWTO? A1: Version Information: 1999-09-22/0.0.15.1 -- Updated to GxSNMP 0.0.15 1999-09-22/0.0.13.4 -- Collected some more issues from the mailing-list. 1999-09-13/0.0.13.3 -- Added UNRESOLVED Section 1999-09-07/0.0.13.2 -- Added compiled/supported platforms 1999-09-02/0.0.13.1 -- Changed versioning to match release of GxSNMP (GxSNMP 0.0.13) 1999-08-31/0.1.2 -- Corrected some errors (GxSNMP 0.0.12) 1999-08-31/0.1.1 -- Update of various essential parts (GxSNMP 0.0.12) 1999-08-31/0.1.0 -- First release (GxSNMP 0.0.12) A2: Maintainer: Alfred Reibenschuh . A3: Where to get: http://www.gxsnmp.org/gxsnmp.faq.txt 1. Introduction and General Information Q: What is GxSNMP? A: Our plan is to create a network managenemt application under the GNU public license (GPL). Planned Features: (*) Generic poller with various supported protocols. MIB editor (*) SNMP explorer (*) Network topology editor (*) Network discovery (*) Plugins Distributed network management Interface to network status monitor Script language Performance and health reporting (*) SNMPv3 compliance Implementation of features marked with (*) have been started in GxSNMP. The most current version of GxSNMP should be 0.0.15. Q: What platforms are supported by GxSNMP? A1: GxSNMP is developed on Linux. Though it should build and work on any posix-compliant unix system which supports TCP/IP and GNOME/Gtk+ (which implies a newer version of C/C++ compiler such as egcs-1.1.x or gcc-2.95). A2: GxSNMP has been known to successfully compile and run on the following unix/cc/gnome-gtk combinations: unix-version c-compiler gtk/glib/gnome-version note ---------------------------------------------------------------------------- i686-redhat 5.2 (2.0.36) egcs-1.1.1 gtk/glib >=1.2.0 (#1) i686-redhat 6.0 (2.2.5) gcc-2.95 gtk/glib >=1.2.0 (#2) BSD unknown unknown HP-UX unknown unknown Solaris unknown unknown sparc5-debian linux 2.1 (2.2.9) egcs-2.91.60 1.2/1.2.1/1.0.10 Q: How much hard disk space/memory does GxSNMP need? A1: the reported installation sizes (apart for gnome/gtk, mysql): note size ------------------------ #1 6622k #2 7865k A2: Memory -- minimum 64, recommended 128 megs. Q: Is GxSNMP public domain? Copyrighted? A: It is covered under the GNU Public License. Details in the COPYING file in the distribution. Q: What SNMP agents has this been tested against. A1: The file AGENTS in the source lists the ones that are known to work. if you find one that isn't listed please let us know and we will update it as needed. A2: As of 0.0.12 this includes ... Livingston (Lucent) Pormasters (all variations of this thing). IBM (aix, os/400) Linux (cmu/ucd) WellFleet/Synoptics (Baynetworks) Cisco - 3000 Software (IGS-K), Version 9.1(10) - IOS (tm) 5200 Software (C5200-I-L), Version 11.2(8)P - IOS (tm) 1000 Software (C1000-Y-M), Version 11.2(6) 3com Visual Networks (HP WanProbes) NBase ADC Kentrox -- Pacesetter PRO Ascend Gandalf 2. Network sources and resources. Q: Where can I get the HOWTO's and other documentation? A: See section 0. Q: Where should I look on the World Wide Web for GxSNMP stuff? A: Look at http://www.GxSNMP.org Q: Where can I get GxSNMP material by FTP? A: Look at ftp://coco.comstar.net/pub/GxSNMP Q: What newsgroups/mailing-lists are there for GxSNMP? A1: There is a mailing list for discussion about the GxSNMP project. The subscription address is "majordomo@scram.de". To subscribe use [god@host]/> echo "subscribe GxSNMP" | mailx -s "subscribe" majordomo@scram.de The list address is GxSNMP@scram.de. It will not allow postings from unsubscribed persons. Bugs to GxSNMP-bugs@GxSNMP.org Q: Are the newsgroups/mailing-lists archived anywhere? A: currently not. 3. HOWTO Section Q: What software/sources/rpms should i get to run GxSNMP? A1: The official recommendation ... The SMI Library. http://www.ibr.cs.tu-bs.de/projects/libsmi/ ftp://ftp.ibr.cs.tu-bs.de/pub/local/libsmi/ + One of the supported Databases (MySQL, Informix). A2: What you can do is ... (by Alfred Reibenschuh) -) install any linux distribution with at least kernel 2.x and egcs-1.1.x or gcc-2.95 as well as a working x-server and window-manager ( redhat-linux 5.2/6.0 would be best ) -) grab all current gnome-rpms and install them with the following command [god@host]/> rpm -i -) OR grab all current gnome-tar.gzs and install each with the following command [god@host]/> ./configure --prefix=/usr --exec-prefix=/usr [god@host]/> make all install -) grab the current (3.22.x) rpms of mysql OR the current (3.22.x) tar.gz and install them as above Due to some libtool/ld.so issues mysql _must_ have the shared library versions of client libs built and installed. -) install the the smi-library from source. Q: Is a database needed to install GxSNMP? A: Yes. One of the supported databases _must_ be installed, and the client libraries must be accessable during the compile. Q: How do i build GxSNMP from sources? A1: (by Alfred Reibenschuh) gunzip, untar & build the GxSNMP sources [god@host]/> gzip -d GxSNMP-0.0.15.tar.gz [god@host]/> tar xvf GxSNMP-0.0.15.tar [god@host]/> cd GxSNMP-0.0.1% [god@host]/> ./configure recommened to ./configure --prefix= [god@host]/> make all [god@host]/> make install this should build it all Q: Must GxSNMP be installed for it to work? A: Yes it must be installed for it to work properly, GxSNMP is a complex package with many parts that need to all be in a standardized place for the application to find all its bits. Q: I try to configure the Database but the whole thing core-dumps! A1: (by Robert Dahlem [Robert.Dahlem@ffm2.siemens.de]) Try this: you should have (or create) a file ~/.GxSNMP/GxSNMP.config Insert these statements: def_sql_engine = "MySQL" def_sql_host = "localhost" def_sql_port = your_mysql_port def_sql_user = "your_user" def_sql_pass = "your_password" def_sql_db = "your_database" A2: As of 0.0.13 this should be fixed. Also with 0.0.13 an improved debugging infrastructure is in place so one will be able to 'GxSNMP --debug-level=xx' and provide some as to where its dying. Q: The database is running but it seems that gxsnmp can't connect to the database. How could I trace ? A: gxsnmp --debug-level=1 (Very spam intensive) gxsnmp --debug-level=2 (reduced spam) Q: Menu configure->Database is greyed out. A: Not implemented at this time. Q: when going into menu configure->Properties pull down list in SQL tab contains nothing. A: Usually caused by gxsnmp failing to load any of the database plugins. 1. You did install it? 2. There were no errors on startup? Q: After GxSNMP is installed, do I need to create a database in MySQL or does itself create the DB ? A: You have to set up the database (MySQL) yourself. You also have to create the tables for gxsnmp yourself - this is described in the README cd database/tables cat *.table | mysql -u --password="" \ -h (The last two lines are actually one line.) Q: No symbols appear on my map. Do i need the database running correctly to show the symbols ? A: You have to have the map added, then when your editing the item, it has to be 'shown' on said map. (The far left hand side of the edit/add dialog) 4. UNRESOLVED Section Q: GxSNMP living in its own directory? Another question about gxsnmp, alot problems would be solved using a directory where gxsnmp lives in. Example a pointer from /etc/gxsnmp-something could point the installation dir of gxsnmp. Even a static installation directory wouldn't be too bad, like netview, because application like Openview/Netview has a dedicated machine anyway. Q: Doing something on data-collection and reporting?