~ahasenack/landscape-client/landscape-client-1.5.5-0ubuntu0.9.04.0

« back to all changes in this revision

Viewing changes to man/landscape-config.txt

  • Committer: Bazaar Package Importer
  • Author(s): Rick Clark
  • Date: 2008-09-08 16:35:57 UTC
  • mfrom: (1.1.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20080908163557-l3ixzj5dxz37wnw2
Tags: 1.0.18-0ubuntu1
New upstream release 

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
NAME
 
2
  landscape-config - configure the Landscape management client
 
3
 
 
4
SYNOPSIS
 
5
  landscape-config [--silent, -a ACCOUNT, -t TITLE, -p PASSWORD, -l LOG,
 
6
                    -k KEY, -d PATH]
 
7
 
 
8
DESCRIPTION
 
9
 
 
10
Before using the landscape-client it must be configured with account and
 
11
computer information that is transmitted to the Landscape server when the
 
12
client connects. The registration can be performed with or without user
 
13
interaction.
 
14
 
 
15
Running the landscape-config program without arguments will start the
 
16
program, prompting you for the necessary information to run the client.
 
17
Optionally you can provide command-line arguments (detailed below) to
 
18
specify default responses. You will be told if the registration was
 
19
successful or if an error occurred. When registration is successful
 
20
Landscape is configured and running on your system. Errors can occur if
 
21
you provide incorrect registration details.
 
22
 
 
23
OPTIONS
 
24
 --version                                   show program's version number and exit
 
25
 -h, --help                                  show this help message and exit
 
26
 -c FILE, --config=FILE                      Use config from this file (any command line options override settings from the file)
 
27
 --bus=BUS                                   The DBUS bus to use. One of 'session' or 'system'
 
28
 -d PATH, --data-path=PATH                   The directory to store data files in
 
29
 -q, --quiet                                 Do not log to the standard output
 
30
 -l FILE, --log-dir=FILE                     The directory to write log files to
 
31
 --log-level=LOG_LEVEL                       One of debug, info, warning, error or critical
 
32
 --ignore-sigint                             Ignore interrupt signals
 
33
 -a NAME, --account-name=NAME                The account this computer belongs to
 
34
 -p SECRET, --registration-password=SECRET   The account-wide password used for registering clients
 
35
 -t TITLE, --computer-title=TITLE            The title of this computer
 
36
 --script-users=USERS                        A comma-separated list of users to allow scripts to run. To allow scripts to be run by any user, enter ALL
 
37
 --include-manager-plugins=PLUGINS           A comma-separated list of manager plugins to load
 
38
 -u URL, --url=URL                           The server URL to connect to
 
39
 -k SSL_KEY, --ssl-public-key=SSL_KEY        The public SSL key to verify the server, only used if the given URL is https
 
40
 --exchange-interval=INTERVAL                The number of seconds between server exchanges
 
41
 --urgent-exchange-interval=INTERVAL         The number of seconds between urgent server exchanges
 
42
 --ping-url=PING_URL                         The URL to perform lightweight exchange initiation with
 
43
 --http-proxy=URL                            The URL of the HTTP proxy, if one is needed
 
44
 --https-proxy=URL                           The URL of the HTTPS proxy, if one is needed
 
45
 -n, --no-start                              Don't start the client automatically
 
46
 --silent                                    Run without manual interaction
 
47
 --disable                                   Stop running clients and disable start at boot
 
48
 
 
49
 
 
50
EXAMPLES
 
51
 
 
52
Register a machine for the first time, or reconfigure an already
 
53
registered machine, interactively. Command line parameters suppress
 
54
interaction for provided values.
 
55
 
 
56
  landscape-config
 
57
 
 
58
Register a machine for the first time, or reconfigure an already
 
59
registered machine, without requiring user interaction. The client
 
60
will be configured to start on boot automatically:
 
61
 
 
62
  landscape-config --silent -a account-name -p secret -t `hostname`
 
63
 
 
64
Register a machine with the script execution plugin enabled, without
 
65
requiring user interaction:
 
66
 
 
67
  landscape-config --silent -a account-name -p secret -t `hostname` --script-users nobody,landscape,root
 
68
 
 
69
To disable a client, stopping current instances and disabling start at
 
70
bootup:
 
71
 
 
72
  landscape-config --disable
 
73
 
 
74
 
 
75
SEE ALSO
 
76
 
 
77
  landscape-client (1)
 
78
 
 
79
AUTHOR
 
80
  Landscape Development Team <landscape-team@canonical.com>