NAME

srs-epp-proxy - start and stop an SRS EPP Proxy instance

SYNOPSIS

srs-epp-proxy [options] { start | status | restart | stop }

DESCRIPTION

This program starts an instance of the SRS EPP Proxy. See SRS::EPP::Proxy for an introduction to what that is.

This is a MooseX::Daemonize'd program, using MooseX::Getopt. Additionally, MooseX::SimpleConfig is used which allows for configuration of the proxy via a .yml file (other options are available).

CONFIGURATION OPTIONS

These may be specified on the command-line using the gnu-style convention for simple options;

srs-epp-proxy --listen srsrps-fe \
    --backend http://srsrps-fe.srs.net.nz/srs/summary

For options that take a list, the option may be specified multiple times.

ssl_key_file

ssl_cert_file

ssl_cert_dir

ssl_crl_file

The EPP protocol specifically requires use of SSL, so you need to specify these options.

listen

Specify a listen address, may be specified multiple times. The default is to listen on all local interfaces via IPv4, or IPv6 if available.

gpg_dir

Specify where the GPG-like keyring and secure keyring files can be found. This is equivalent to setting the GNUPGHOME environment variable.

backend

Specify the back-end URL of the SRS system.

pidfile

Actually all of the options listed on MooseX::Daemonize are supported, but I just thought I'd point this one out. Specifies where the PID file goes, and will default to /var/run/srs-epp-proxy.pid =item foreground

Another option inherited from MooseX::Daemonize; this option will stop the program from daemonizing.

logging

This option can customize the Log::Log4perl system. This system is used for its support for flexible, per-component log levels.

You can specify a log level such as FATAL, ERROR, WARN, INFO, DEBUG, or TRACE, the proxy will only log messages that high or higher. The default is INFO.

If you specified --foreground, then all logging will be set to go to standard error. Otherwise, it will end up in the daemon syslog category.

If you specify a filename here, it will be used as the Log::Log4perl configuration file. If you are configuring via the .yml file, you can pass in the detailed configuration directly; eg

logging:
   rootLogger: ERROR, LOGFILE
   appender.LOGFILE: Log::Log4perl::Appender::File
   appender.LOGFILE.filename: /var/log/myerrs.log
   appender.LOGFILE.mode: append
   appender.LOGFILE.layout: PatternLayout
   appender.LOGFILE.layout.ConversionPattern: "[%r] %F %L %c - %m%n"