← Back to branch summary

~ubuntu-branches/debian/sid/pyro/sid

« back to all changes in this revision

Viewing changes to docs/3-install.html

  • Committer: Bazaar Package Importer
  • Author(s): Bernd Zeimetz, Sandro Tosi, Bernd Zeimetz
  • Date: 2009-05-25 14:26:23 UTC
  • mfrom: (1.1.3 upstream)
  • Revision ID: james.westby@ubuntu.com-20090525142623-31cqgb2pdff6c1az
Tags: 3.9.1-1
[ Sandro Tosi ]
* debian/control
  - switch Vcs-Browser field to viewsvn

[ Bernd Zeimetz ]
* New upstream release.
* debian/patches/usr-bin-env-location.dpatch:
  - Dropping patch, applied usptream. 
* debian/control, debian/rules:
  - Dropping dpatch build-dep and include, not needed anymore. 
* Switching to python-support and dh 7.
* Bumping Standards-Version to 3.8.1. 
* Dropping maintainer scripts, dh creates them properly. 
* Adding missing ${misc:Depends}. 
* Fix several file permissions in the examples package.
* Add symlink to the actual docu in pyro-examples. 

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/3-install.html
1
1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
2
<html>
3
 
<!-- $Id: 3-install.html,v 2.44 2007/03/07 23:08:19 irmen Exp $ -->
 
3
<!-- $Id: 3-install.html,v 2.44.2.12 2009/03/26 21:27:26 irmen Exp $ -->
4
4
<head>
5
5
  <title>PYRO - Installation</title>
6
6
  <link rel="stylesheet" type="text/css" href="pyromanual_print.css" media="print">
19
19
  </table>
20
20
<hr></div>
21
21
 
22
 
  <h2><u>3. Installation and Configuration</u></h2>Please read this entire chapter before trying to install Pyro.&nbsp;
 
22
  <h2>3. Installation and Configuration</h2>
 
23
  Please read this entire chapter before trying to install Pyro.&nbsp;
23
24
  Not that it's complex, but just that you've seen the choices you have to make.
24
25
 
25
26
  <p><strong>Installation</strong></p>
61
62
  <p><strong>Configuration</strong></p>
62
63
 
63
64
  <p>The default settings will do nicely in most cases. But sooner or later you will have to change some parameters of
64
 
  Pyro. Pyro's configuration is accessed through <code>Pyro.config</code>. This object has several configuration
65
 
  items:<br></p>
 
65
  Pyro. Pyro's configuration is accessed through <code>Pyro.config</code>. This object has a lot of configuration
 
66
  items, shown in the table below.<br></p>
 
67
  <p>Use <code>python -m Pyro.configuration</code> to get a printout of Pyro's active configuration settings.</p>
66
68
 
67
69
  <table>
68
70
    <tr>
339
341
      <td>number</td>
340
342
 
341
343
      <td>The base socket number of the range of socket numbers that the Pyro daemon can use to listen for incoming
342
 
      requests (Pyro method calls).</td>
 
344
      requests (Pyro method calls). Set to 0 to let the operating system choose a random port.</td>
343
345
 
344
346
      <td>7766</td>
345
347
    </tr>
406
408
 
407
409
      <td>string</td>
408
410
 
409
 
      <td>The hostname that is tried to find the NameServer on, when the broadcast lookup mechanism fails.</td>
 
411
      <td>The hostname that is initially tried to find the NameServer on, or when the broadcast lookup mechanism fails.</td>
410
412
 
411
413
      <td><i>empty</i></td>
412
414
    </tr>
417
419
      <td>number</td>
418
420
 
419
421
      <td>The socket number on which the Name Server will listen for incoming requests (Pyro method calls, in
420
 
      fact).</td>
421
 
 
 
422
      fact). Set to 0 to let the operating system choose a random port. Note that if you set this to 0, a client cannot use 
 
423
      this config item to directly connect to the NS. It will have to use the broadcast lookup.</td>
422
424
      <td>9090</td>
423
425
    </tr>
424
426
 
425
427
    <tr>
 
428
      <td><code>PYRO_NS_BC_ADDR</code></td>
 
429
      <td>string</td>
 
430
      <td>Overrides the default broadcast address. It is used by the nameserver to bind the broadcast
 
431
        listener on this broadcast address, and by the name server locator when it uses broadcast discovery.
 
432
        When empty, the default broadcast address is used (usually 255.255.255.255).</td>
 
433
      <td><i>empty</i></td>
 
434
    </tr>
 
435
 
 
436
    <tr>
426
437
      <td><code>PYRO_NS_BC_PORT</code></td>
427
 
 
428
438
      <td>number</td>
429
 
 
430
439
      <td>The socket number on which the Name Server will listen for broadcast requests (usually to find the
431
440
      location).</td>
432
 
 
433
441
      <td>9090</td>
434
442
    </tr>
435
443
 
454
462
    </tr>
455
463
 
456
464
    <tr>
 
465
      <td><code>PYRO_NS2_BC_ADDR</code></td>
 
466
      <td>string</td>
 
467
      <td>Like above, but for the second (paired) Name Server.</td>
 
468
      <td><i>empty</i></td>
 
469
    </tr>
 
470
 
 
471
    <tr>
457
472
      <td><code>PYRO_NS2_BC_PORT</code></td>
458
473
 
459
474
      <td>number</td>
485
500
 
486
501
      <td>1</td>
487
502
    </tr>
 
503
    
 
504
    <tr>
 
505
      <td><code>PYRO_ONEWAY_THREADED</code></td>
 
506
 
 
507
      <td>boolean</td>
 
508
 
 
509
      <td>If true (1), oneway method calls will execute in a new server thread. 
 
510
        This allows for the server to continue to process other method calls on this object in the meantime.
 
511
        If false (0), oneway method calls will execute in the main server thread and need to complete before
 
512
        the server can process other calls on that object.</td>
 
513
      <td>1</td>
 
514
    </tr>
488
515
 
489
516
    <tr>
490
517
      <td><code>PYROSSL_CERTDIR</code></td>
526
553
 
527
554
      <td>client.pem</td>
528
555
    </tr>
 
556
    <tr>
 
557
      <td><code>PYROSSL_POSTCONNCHECK</code></td>
 
558
 
 
559
      <td>boolean</td>
 
560
 
 
561
      <td>Tells the SSL layer if it should do 'post-connection' validations on the certificate(s) for instance.
 
562
        Set it to 0 to disable these checks (not advised! But convenient to be able to use a
 
563
        certificate that hasn't got a matching commonName or stuff like that) Default is 1: 
 
564
        the SSL layer will do its checks as enabled by its own default settings.</td>
 
565
      <td>1</td>
 
566
    </tr>
 
567
 
529
568
  </table>
530
569
 
531
570
  <p>There are several ways to change the default settings:</p>