Project

General

Profile

Actions

Documentation #8112

closed

radosgw usage and manpage need updating

Added by Zack Cerza about 10 years ago. Updated almost 8 years ago.

Status:
Resolved
Priority:
Normal
Assignee:
-
Target version:
-
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Pull request ID:

Description

While working on #7933, I noticed a large gap in what flags our tests are passing to radosgw, and what flags are documented at all.

manpage:

OPTIONS
       -c ceph.conf, --conf=ceph.conf
              Use ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor addresses during startup.

       -m monaddress[:port]
              Connect to specified monitor (instead of looking through ceph.conf).

       --rgw-socket-path=path
              Specify a unix domain socket path.

--help:

$ radosgw --help
usage: radosgw [options...]
options:
   --rgw-region=<region>     region in which radosgw runs
   --rgw-zone=<zone>         zone in which radosgw runs
  --conf/-c FILE    read configuration from the given configuration file
  --id/-i ID        set ID portion of my name
  --name/-n TYPE.ID set name
  --cluster NAME    set cluster name (default: ceph)
  --version         show version and quit

  -d                run in foreground, log to stderr.
  -f                run in foreground, log to usual location.
  --debug_ms N      set message debug level (e.g. 1)

teuthology/task/rgw.py:

rgw_cmd = [ 
    'radosgw',
    '-n', client,
    '-k', '/etc/ceph/ceph.{client}.keyring'.format(client=client),
    '--rgw-socket-path',
    '{tdir}/apache/tmp.{client}/fastcgi_sock/rgw_sock'.format(
        tdir=testdir,
        client=client,
        ),  
    '--log-file',
    '/var/log/ceph/rgw.{client}.log'.format(client=client),
    '--rgw_ops_log_socket_path',
    '{tdir}/rgw.opslog.{client}.sock'.format(tdir=testdir,
                                                client=client),
    '{tdir}/apache/apache.{client}.conf'.format(tdir=testdir,
                                                client=client),
    '--foreground',
    run.Raw('|'),
    'sudo',
    'tee',
    '/var/log/ceph/rgw.{client}.stdout'.format(tdir=testdir,
                                                client=client),
    run.Raw('2>&1'),
    ]   

I'm also curious about the apache config that's being passed; there's no flag for that but no unnamed args are documented.

Actions #1

Updated by Abhishek Lekshmanan almost 8 years ago

  • Status changed from New to Resolved
Actions

Also available in: Atom PDF