From fbe838f69bdcaf1ac46a2ab3367af8c7f066177c Mon Sep 17 00:00:00 2001 From: Herb Lewis Date: Wed, 11 Oct 2000 14:07:32 +0000 Subject: Try this again on the right machine. Adding files for PCP samba pmda (This used to be commit 8ad653f9ebc60c6807c1552425fa83218f6a15d4) --- pcp/README | 94 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 94 insertions(+) create mode 100644 pcp/README (limited to 'pcp/README') diff --git a/pcp/README b/pcp/README new file mode 100644 index 0000000000..81adb5df3b --- /dev/null +++ b/pcp/README @@ -0,0 +1,94 @@ +samba PMDA +=========== + +This PMDA is a sample that illustrates how a simple samba monitor +PMDA might be constructed, using a shared memory segment to transfer +information about transaction activity from the smb daemon. + +Note: + This PMDA may be remade from source and hence requires + a C compiler to be installed. + + Uses of make(1) may fail (without removing or clobbering files) + if the C compiler cannot be found. This is most likely to + happen when running the PMDA ./Install script. + + The only remedial action is to install the C compiler, or + hand-craft changes to the Makefile. + +Metrics +======= + +The file ./help contains descriptions for all of the metrics exported +by this PMDA. + +Once the PMDA has been installed, the following command will list all +the available metrics and their explanatory "help" text: + + $ pminfo -fT samba + +Installation +============ + + + # mkdir /var/pcp/pmdas/samba + + # cp * /var/pcp/pmdas/samba + + # cp ../source/includes/profile.h /var/pcp/pmdas/samba + + # cd /var/pcp/pmdas/samba + + + Check that there is no clash in the Performance Metrics Domain + defined in ./domain.h and the other PMDAs currently in use + (/etc/pmcd.conf). If there is, edit ./domain.h to choose another + domain number. + + + If you are not installing on an IRIX system, edit samba.c and + comment out the + + #define IRIX 1 + + + Then simply use + + # ./Install + + + Alternatively, to install just the Performance Metrics Name Space + for the samba metrics on the local system, but not the samba PMDA + (presumably because the local system is running PCP 1.x and you + wish to connect to a remote system where PCP 2.0 and the samba PMDA + is running), make sure the Performance Metrics Domain defined in + ./domain.h matches the domain chosen for the samba PMDA on the + remote system (check the second field in the corresponding line of + the pmcd.conf file on the remote system - located in /etc on IRIX + and /var/pcp/config/pmcd on Linux), then + + # ./Install -N + +De-installation +=============== + + + Simply use + + # cd /var/pcp/pmdas/samba + # ./Remove + + + If you also want to remove the sources use + + # cd / + # rm -rf /var/pcp/pmdas/samba + +Making something happen +======================= + +The application ./smbd updates the shared memory segment to add +profile information about smbd. By default updating is disabled. +To start updating of the shared memory segment you need to run the +smbcontrol command to turn on profiling for one or more smbd processes +(see the man page for smbcontrol). + + + +Troubleshooting +=============== + + + After installing or restarting the agent, the PMCD log file + (pmcd.log) and the PMDA log file (samba.log) should be checked + for any warnings or errors. These logs are located in + /var/log/pcp/pmcd on Linux and /var/adm/pcplog on IRIX. -- cgit From be6a3173458b3112e9b4d99d078895633fb80c60 Mon Sep 17 00:00:00 2001 From: Herb Lewis Date: Thu, 9 Nov 2000 20:45:09 +0000 Subject: restructure PCP metrics (merge from 2.2 branch) (This used to be commit dc725c2256ff5f3d8ac37fe33cfa1685194f7f46) --- pcp/README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'pcp/README') diff --git a/pcp/README b/pcp/README index 81adb5df3b..97d8125a53 100644 --- a/pcp/README +++ b/pcp/README @@ -7,7 +7,7 @@ information about transaction activity from the smb daemon. Note: This PMDA may be remade from source and hence requires - a C compiler to be installed. + a C compiler and Perl to be installed. Uses of make(1) may fail (without removing or clobbering files) if the C compiler cannot be found. This is most likely to @@ -32,7 +32,7 @@ Installation + # mkdir /var/pcp/pmdas/samba + # cp * /var/pcp/pmdas/samba - + # cp ../source/includes/profile.h /var/pcp/pmdas/samba + + # cp ../source/include/profile.h /var/pcp/pmdas/samba + # cd /var/pcp/pmdas/samba + Check that there is no clash in the Performance Metrics Domain @@ -77,7 +77,7 @@ De-installation Making something happen ======================= -The application ./smbd updates the shared memory segment to add +The application "smbd" updates the shared memory segment to add profile information about smbd. By default updating is disabled. To start updating of the shared memory segment you need to run the smbcontrol command to turn on profiling for one or more smbd processes -- cgit From 8e576b016ee72af3ccdc64cebd7e9c0f4adc36a3 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Tue, 10 Jul 2007 01:18:53 +0000 Subject: r23787: Remove the pcp example code until SGI have given us approval to use it under GPLv3 (This used to be commit 5c5d5bdf7f2fbe02a185b12989c88b18d7758fcb) --- pcp/README | 6 ++++++ 1 file changed, 6 insertions(+) (limited to 'pcp/README') diff --git a/pcp/README b/pcp/README index 97d8125a53..0c302bbfb4 100644 --- a/pcp/README +++ b/pcp/README @@ -1,3 +1,9 @@ +NOTE! The samba.c source in this directory has been removed pending +approval from SGI to use it under the GPLv3 license. + +Please see Samba 3.0.xx for a copy of this code under the GPLv2 +license if required. + samba PMDA =========== -- cgit