← Back to branch summary

~ubuntu-branches/ubuntu/trusty/sblim-sfcb/trusty-proposed

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Thierry Carrez
  • Date: 2009-06-08 12:04:49 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20090608120449-byfplk09rqz8rtg6
Tags: 1.3.3-0ubuntu1
* New upstream release.
* debian/rules: Removed rpath hacks, SFCB default build handles that now.
* Removed 1934753-remove-assignment.diff, now upstream.
* Refreshed patch cim-schema-location.diff

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
110
110
        bison >= 1.85
111
111
        curl >= 7.11.1-1
112
112
        curl-devel >= 7.11.1-1
 
113
    flex
113
114
 
114
115
If you want to enable SSL support, the following packages are needed as well:
115
116
 
236
237
installed and working correctly because stripping the binaries will remove
237
238
useful debugging information should problems arise. However, stripping the
238
239
binaries and libs will significantly reduce their size.
 
240
 
 
241
You can use the footprinting utility to evaluate the resource usage of sfcb.
 
242
 
 
243
First you must download the ps_mem.py utility from http://www.pixelbeat.org/scripts/ps_mem.py
 
244
Place that script anywhere in your path, or in the sfcb CVS directory, and ensure that it is
 
245
executable.
 
246
 
 
247
Then build and start sfcb as described in sections 6 and 10 
 
248
 
 
249
Lastly, run the footprint utility as root:
 
250
 
 
251
                make footprint
 
252
 
 
253
The resulting report will describe the resource usage. You may then try different build
 
254
options and rerun the utility to evaluate their affect. The README.sfcb-shrink file 
 
255
gives some guidance and tips for further reducing the footprint.
239
256
 
240
257
 
241
258
8. Build Options
285
302
                on IPv4 addresses.
286
303
                Default=no
287
304
 
 
305
        --enable-local-connect-only
 
306
                SFCB will only support local connection. Http server will not 
 
307
                be built. Default=no
 
308
 
 
309
        --enable-tests[=TESTS]
 
310
                Enables the test suite with the listed tests. If no tests are
 
311
                listed, all tests are enabled.
 
312
                Valid tests are "commands,unit,xml,wbemcli,gcov"
 
313
                Default=no
 
314
 
 
315
        --enable-uds
 
316
                Enables UDS authentication for the http server.
 
317
                Default=no
 
318
                This option may require the GNU_SOURCE compiler flag if
 
319
                building under glibc 2.8+. (CFLAGS=-D_GNU_SOURCE ./configure)
 
320
 
288
321
 
289
322
9. Downloading the CIM Schema
290
323
=============================
449
482
        enableHttps:    false
450
483
        httpsProcs:     8
451
484
        provProcs:      32
 
485
    maxMsgLen:      10000000
452
486
        doBasicAuth:    false
453
487
        basicAuthLib:   sfcBasicAuthentication
454
488
        useChunking:    true
457
491
        sslKeyFilePath: /usr/local/etc/sfcb/file.pem
458
492
        sslCertificateFilePath: /usr/local/etc/sfcb/server.pem
459
493
        registrationDir: /usr/local/var/lib/sfcb/registration
460
 
        providerDirs: /usr/local/lib /usr/local/lib/cmpi
 
494
        providerDirs: /usr/local/lib/sfcb /usr/local/lib /usr/local/lib/cmpi
461
495
 
462
496
Config Option Descriptions
463
497
--------------------------
493
527
        then one of the existing providers will first be automatically
494
528
        unloaded. Default=32 
495
529
 
 
530
maxMsgLen
 
531
    Maximum size in bytes of received messages. Messages larger than
 
532
    this size will be rejected.
 
533
    Default=10000000
 
534
 
496
535
doBasicAuth
497
536
        Perform basic authentication on the client userid (obtained from the
498
537
        HTTP/HTTPS header) before allowing the request. Default=false
552
591
        be executed in the same process unless another group has been specified
553
592
        in the provider registration file. Default: true
554
593
 
 
594
slpHostnameLib
 
595
    Specify the name of the library to use to determine the SLP hostname. This
 
596
    will override the default method. You must implement this library based 
 
597
    on the sample provided, sfcSlpHostname.c. You must also specify the 
 
598
    --enable-slp-hostname-lib configure option to enable this support.
 
599
 
555
600
sslClientCertificate
556
601
        Specify the way sfcb handles client certificate based authentication. If set to
557
602
        ignore it will not request a certificate from the client. If set to
596
641
PATH=/usr/local/bin:/usr/local/sbin
597
642
        Path to the sfcbd daemon and utilities.
598
643
 
599
 
LD_LIBRARY_PATH=/usr/local/lib
 
644
LD_LIBRARY_PATH=/usr/local/lib/sfcb
600
645
        Path to the sfcb runtime libraries. Note: the path to the SBLIM
601
646
        provider libraries is specified in the sfcb configuration file and 
602
647
        therefore does not need to be on the global LD_LIBRARY_PATH. 
1536
1581
/usr/local/var/lib/sfcb/stage/regs/*
1537
1582
        Registration info for all installed providers.
1538
1583
 
1539
 
/usr/local/lib/libsfc*
 
1584
/usr/local/lib/sfcb/libsfc*
1540
1585
        Binaries for sfcb runtime libraries.
1541
1586
 
1542
1587
/usr/local/lib/cmpi/*
1628
1673
Solution: Build the latest mofc with sfcb as described in Sec. 6.  Note: you 
1629
1674
          should NOT run configure in the mofc subdirectory; the sfcb configure
1630
1675
          script will take care of this
 
1676
 
 
1677
Problem:  "Inconsistent provider registration for [provider] (2)" error when
 
1678
          issuing a CIM request
 
1679
Cause:    sfcb is expecting the provider to be a type that it is not
 
1680
Solution: Most likely problem is that "type" is set incorrectly in the
 
1681
          providerRegister file for the requested provider.