Permalink
Browse files

INSTALL: add notes about Makepkgs and qa/admin/check-vm

  • Loading branch information...
1 parent b257279 commit e852abbcbea3f8246ffde35045a8beed1529b208 @kmcdonell kmcdonell committed with natoscott Apr 15, 2015
Showing with 29 additions and 0 deletions.
  1. +29 −0 INSTALL
View
29 INSTALL
@@ -108,6 +108,33 @@ PCP internet resources, and the pmchart utility.
== B. Building from source
+0. Preliminaries
+
+ The PCP code base is targeted for many different operating
+ systems and many different combinations of related packages,
+ so a little planning is needed before launching into a build
+ from source.
+
+ Package dependencies come in several flavours:
+
+ (a) hard build dependencies - without these PCP cannot be
+ build from source, and the build will fail in various
+ ways at the compilation or packaging stages, e.g. gmake,
+ autoconf, flex, bison, ...;
+
+ (b) optional build dependences - if these components are not
+ installed the build will work, but the resultant packages
+ may be missing some features or entire applications, e.g.
+ extended authentication, secure connections, service
+ discovery, pmwebd, ...;
+
+ (c) QA dependencies - you can ignore these unless you want to
+ run the (extensive) PCP QA suite.
+
+ It is strongly recommended that you run the script:
+ $ qa/admin/check-vm
+ and review the output before commencing a build.
+
1. Configure, build and install the package
The pcp package uses autoconf/configure and expects a GNU build
@@ -146,9 +173,11 @@ PCP internet resources, and the pmchart utility.
users "pcp" with home directory /var/lib/pcp, and "pcpqa" with home
directory such as /var/lib/pcp/testsuite, or as appropriate, or
designate other userids in the pcp.conf file.
+
Note 1: that there are so many "install" variants out there that we
wrote our own script (see "install-sh" in the top level directory),
which works on every platform supported by PCP.
+
Note 2: the Windows build is particularly involved to setup, this
is primarily due to build tools not being available by default on
that platform. See the PCP Glider scripts and notes in the pcpweb

4 comments on commit e852abb

how to install python bindings for pcp client in mac?

Contributor

kmcdonell replied Mar 27, 2016

@thirumalrao ... if the packaging was working correctly, the Python pieces (like everything else) would get installed in the correct place.
Unfortunately, the Mac OS X packaging for Python is broken at the moment. So the best workaround I have is ... install the source and setup a build environment, then

$ qa/admin/myconfigure
$ cd src/python
$ python setup.py build
$ sudo python setup.py install

and on my iMac this puts the required Python bits in /Library/Python/2.6/site-packages/pcp/ and then things "just work" (tm)

Contributor

natoscott replied Apr 1, 2016

| derive.o: s fmt : Error: additional symbol

@thirumalrao the above issue should be resolved in the master branch now.

Please sign in to comment.