
> sldreg
Command line used to start sldreg:
sldreg
Program Usage: sldreg <options>
Option groups:
(1) Transfer Data Options:
[-file <xml-file>] : XML file containing data to be transfered.
If not specified, the program uses standard input instead
(e.g. for pipes).
[-stdin] : Use 'stdin' for data. Default if no input file is set.
Overrides the file setting.
[-oldtransferdtd] : If specified, an old transfer DTD is used
for older SLD bridges.
(2) HTTP Connect Options:
-connectfile <file> : File containing the encrypted HTTP user/password
and host/port information.
-symbolfile <file> : File containing symbols in the form name=value
(property file). Symbols in form ${name} are replaced
by their value in attributes and character data
of the <value> tag (recursively).
-user <http-user> : Http user for J2EE engine connect.
[-pass <password>] : HTTP password for J2EE engine connect
(default: no password).
-host <http-host> : HTTP host.
-port <http-port> : HTTP port number.
[-usehttps] : Use HTTPS (Requires additional configuration tasks).
[-sslcertauth] : Instead of HTTP basic authentication, use SSL Certificate based authentication.
Automatically sets -usehttps. Parameters user and password are discarded if provided.
[-pse <file_path>] : Explicitly specifies the fullpath to the client PSE file to be used.
Only client PSE file is needed (i.e. no need for server PSE).
If missing, the default SAPSSLC.pse is used.
Options -sslcertauth and -pse are independent.
Proxy options:
-puser <proxy-user> : Proxy user.
-ppass <proxy-pass> : Proxy password.
-phost <proxy-host> : Proxy host.
-pport <proxy-port> : Proxy port number.
Proxy is used if and only if <proxy-host> is specified, then <proxy-port> is mandatory.
Parameters <proxy-user> and <proxy-ppass> are optional (but must come together).
If <proxy-pass> is missing, sldreg will prompt for it.
-connecttimeout <n> : Network connect timeout in seconds (0 = infinite).
-sendtimeout <n> : Message send timeout in seconds (0 = infinite).
-receivetimeout <n> : Message response timeout in seconds (0 = infinite).
Note: You have to specify either a connect file or a valid
user/password/host/port combination.
If both is specified, the connect file takes precedence.
All timeout parameters are set to 420 sec by default.
(3) Configuration of connection information stored in an encrypted file:
-configure <file> : Configuration of connection settings either interactively
or from command line parameters. Saved in specified file.
-backup : Use suffix '.backup' instead of '.YYYMMDDhhmmss' when creating
backup for configuration and key file.
-noninteractive : Configuration will be based only on command line parameters.
Only <password> and <proxy-password> will be prompted if missing.
[-usekeyfile] : If specified, a newly generated encryption key is stored
in a '*.key' file.
If not specified, a built-in encryption key is used.
-showconnect <file> : Display the connection settings excepting the password.
(4) Additonal optional Settings:
-help : Prints this help information and terminates
-version : Prints the patch version and terminates
-datatrace : Full data trace, i.e. data parsed by program
-httptrace : Full HTTP data trace, i.e. data send via HTTP
-logfile <logfile> : File where the log should be written to (default: stdout)
(5) Profile related options:
[-pf=<profile>] : Path to the profile. If not specified, the current working
directory is searched for profile named SLDREG.PFL (deprecated)
Note: Profile can be used for setting SSL parameters, or for alternative
trace activation via 'sldreg/datatrace = 1' and 'sldreg/httptrace = 1'.
Recommended SSL configuration for SLDREG.
-----------------------------------------
Without SAP Profile, set following environment variables:
LD_LIBRARY_PATH # must contain directory with libsapcrypto.so
SECUDIR # must point to directory containing client PSE and credentials.
For Kernels 722, 745, 749 and higher also environment variable SAPSSL_CLIENT_CIPHERSUITES can be used.
See Note 2384290
With SAP Profile, set following profile parameters:
ssl/ssl_lib # mandatory; absolute path for libsapcrypto.so
DIR_INSTANCE # mandatory; DIR_INSTANCE/sec is directory containing PSEs
ssl/client_ciphersuites # optional; to enable other than default values
sldreg/secudir_unset # optional; use 'sldreg/secudir_unset = 1' to remove SECUDIR from sldreg's environment.
Environment variable LD_LIBRARY_PATH is ignored for SSL configuration.
Environment variable SECUDIR is used ONLY for credentials to access PSEs.
(DIR_INSTANCE/sec is directory containing PSEs)
(Unknown options are ignored)