From a1c27ade3f4b5bcdece2e42738c03294afff3566 Mon Sep 17 00:00:00 2001 From: Andre Lorbach Date: Fri, 30 May 2008 12:18:59 +0200 Subject: [PATCH] Changed Online Search Parameters --- INSTALL | 137 +++++++++++++++++++++++++++++++++++++++++++++++++- src/index.php | 12 ++--- 2 files changed, 142 insertions(+), 7 deletions(-) diff --git a/INSTALL b/INSTALL index 8c40018..731bf20 100644 --- a/INSTALL +++ b/INSTALL @@ -28,7 +28,7 @@ 1. Upload all files from the phplogcon/src/ folder to you webserver. The other files are not needed on the webserver. - 2. If you webserver has write access to the phplogcon folder, + 2. If your webserver has write access to the phplogcon folder, you can skip the following step: Upload the scripts configure.sh and secure.sh from the @@ -45,6 +45,141 @@ script. The install script will guide you through the phplogcon installation, just follow the instructions. + 3.1 Step 1 - Prerequisites Beginning of installation / welcome site + This is the first page of the installation. It just tells + you, that before installing, some file permission have to + be checked. Simply click "Next" to start the process. + + 3.2 Step 2 - Verify the file permissions + Here you will see, if the config.php can be written or not. + If it cannot be written, you have to repeat the complete + Step 2. + + 3.3 Step 3 - Basic Configuration + You can set several basic options here. + + - Number of syslog messages per page = 50 (default) + This is the number of syslog messages displayed on each page. + You can increase the value (makes phpLogCon slower) or decrease + the value (makes it faster). + + - Message character limit for the main view = 80 (default) + Set the number of characters per message which will be shown + in the last column of the main view. Full messages can be + reviewed by hovering the mouse over it. + + - Show message details popup (default yes) = yes (default) + Here you can set, if you want the small window with the complete + message to pop up if you are hovering over a event with the + cursor. If you choose "No", then you have to click on the + message to see the details. + + 3.4 Step 4 - not implemented yet + + 3.5 Step 5 - not implemented yet + + 3.6 Step 6 - not implemented yet + + 3.7 Step 7 - Create the first source for syslog messages + This is the most important step. Here, you will configure + your first data source, which holds all your syslog data. + + Mainly, you have to choose a "Name of the Source" and a + "Source Type". The name will be displayed later in a drop-down + menu with which you choose your active syslog source. The + "Source Type" can be a file, a MySQL database or the PHP PDO + which supports different database types like mssql, PostgreSQL, + odbc, oracle or even ibm db2. + + + If you choose the diskfile, you have to provide the following + information: + + - Logline Type = Syslog / Rsyslog (default) or Adiscon WinSyslog + This tells phpLogCon, how the lines look like. This is + necessary for show the log messages properly. + + - Syslog File = /var/log/syslog (default) + This is the position of the logfile in your file system. + + + If you choose MySQL native as data source, following information + is needed: + + - Table Type = monitorware (default) + This is the table layout. Currently, you can use "monitorware" + or "syslogng". For more details see "Note on MySQL Databases" + below. + + - Database Host = localhost (default) + This is the host, where the database is located. By default this + is localhost. You can specify any other host if necessary. + + - Database Name = phplogcon (default) + The name of the database you want to use. + + - Database Tablename = systemevents (default) + This is the name of the table in which the data is stored. The + default tablename corresponds to the tables created with the + MonitorWare Line of products. + + - Database User = user (default) + The username for the database. + + - Database Password = not set by default + The password for the username. + + - Enable Row Counting = No (default) + If configured to "Yes", the amount of rows in the table will be + counted with every query, giving you the total records for your + search, though having a lot of impact on your system when using + a very large database. If configured to "No", the rows will not + be counted, providing you a lot more performance. + + + If you choose Database (PDO), the following has to be defined: + + - Database Storage Engine = MySQL Server (default) + Choose the engine of the database you are using. The databases + are available: MySQL Server, Microsoft SQL Server, ODBC + Database Connection, PostgreSQL, Oracle Call Interface, IBM + DB2, Firebird/Interbase 6, IBM Informix Dynamic Server, + SQLite 2. + + - Table Type = monitorware (default) + This is the table layout. Currently, you can use "monitorware" + or "syslogng". For more details see "Note on MySQL Databases" + below. + + - Database Host = localhost (default) + This is the host, where the database is located. By default this + is localhost. You can specify any other host if necessary. + + - Database Name = phplogcon (default) + The name of the database you want to use. + + - Database Tablename = systemevents (default) + This is the name of the table in which the data is stored. The + default tablename corresponds to the tables created with the + MonitorWare Line of products. + + - Database User = user (default) + The username for the database. + + - Database Password = not set by default + The password for the username. + + - Enable Row Counting = No (default) + If configured to "Yes", the amount of rows in the table will be + counted with every query, giving you the total records for your + search, though having a lot of impact on your system when using + a very large database. If configured to "No", the rows will not + be counted, providing you a lot more performance. + + 3.8 Step 8 - Finish + + + 4. If everything went right, you should see syslog messages already in your phplogcon installation. You can now remove the install.php script now. diff --git a/src/index.php b/src/index.php index d0ac432..d52d74d 100644 --- a/src/index.php +++ b/src/index.php @@ -357,7 +357,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_FACILITY']) . '+' . GetFacilityDisplayName($logArray[$mycolkey]), + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_FACILITY . '&q=' . GetFacilityDisplayName($logArray[$mycolkey]), 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_FACILITY'] . " '" . GetFacilityDisplayName($logArray[$mycolkey]) . "'", 'IconSource' => $content['MENU_NETWORK'] ); @@ -386,7 +386,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_SEVERITY']) . '+' . GetSeverityDisplayName($logArray[$mycolkey]), + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_SEVERITY . '&q=' . GetSeverityDisplayName($logArray[$mycolkey]), 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_SEVERITY'] . " '" . GetSeverityDisplayName($logArray[$mycolkey]) . "'", 'IconSource' => $content['MENU_NETWORK'] ); @@ -426,7 +426,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_EVENTID']) . '+' . $logArray[$mycolkey], + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_EVENT_ID . '&q=' . $logArray[$mycolkey], 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_EVENTID'] . " '" . $logArray[$mycolkey] . "'", 'IconSource' => $content['MENU_NETWORK'] ); @@ -516,7 +516,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_SYSLOGTAG']) . '+' . $logArray[$mycolkey], + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_SYSLOGTAG . '&q=' . $logArray[$mycolkey], 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_SYSLOGTAG'] . " '" . $logArray[$mycolkey] . "'", 'IconSource' => $content['MENU_NETWORK'] ); @@ -542,7 +542,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_EVENTLOGTYPE']) . '+' . $logArray[$mycolkey], + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_EVENT_LOGTYPE . '&q=' . $logArray[$mycolkey], 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_EVENTLOGTYPE'] . " '" . $logArray[$mycolkey] . "'", 'IconSource' => $content['MENU_NETWORK'] ); @@ -557,7 +557,7 @@ if ( isset($content['Sources'][$currentSourceID]) ) // && $content['Sources'][$c 'IconSource' => $content['MENU_BULLET_BLUE'] ); $content['syslogmessages'][$counter]['values'][$mycolkey]['buttons'][] = array( - 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&q=' . PrepareStringForSearch($content['LN_FIELDS_EVENTSOURCE']) . '+' . $logArray[$mycolkey], + 'ButtonUrl' => 'http://kb.monitorware.com/kbsearch.php?sa=Search&oid=' . SYSLOG_EVENT_SOURCE . '&q=' . $logArray[$mycolkey], 'DisplayName' => $content['LN_VIEW_SEARCHFOR'] . " " . $content['LN_FIELDS_EVENTSOURCE'] . " '" . $logArray[$mycolkey] . "'", 'IconSource' => $content['MENU_NETWORK'] );