ObjectServer properties that control the HTTP interface and OSLC interface

ObjectServer properties that control the HTTP and OSLC interfaces.

The following table lists the ObjectServer properties that control the HTTP interface and the OSLC interface.

Table 1. Properties and command-line options for controlling the HTTP interface and the OSLC interface
Property Command-line option Description
NRestOS.Enable TRUE | FALSE -nrestosenable TRUE | FALSE Enables the HTTP interface and the OSLC interface to the ObjectServer.

The default is FALSE, which means that the interfaces are disabled.

NRestOS.OSLCResourceConfigFile string -nrestososlcrescfg string The path to the OSLC resource configuration file. This JSON file defines how columns from the ObjectServer schema are mapped to properties in the OSLC event domain.

The default is $OMNIHOME/etc/restos/resourcecfg.json.

The following table lists the ObjectServer properties that control the embedded HTTP server.

Table 2. Properties and command-line options for controlling the embedded HTTP server
Property Command-line option Description
NHttpd.AccessLog string -nhttpd_accesslog string Specifies the name and location of the log file where the server logs all requests that it processes.

The default is $OMNIHOME/log/NCOMS_http_access.log.

NHttpd.AuthenticationDomain string -nhttpd_authdomain string Specifies the authentication domain that is used when requesting authentication details over the HTTP or HTTPS connection.

The default is omnibus.

NHttpd.ConfigFile string

-nhttpd_configfile string Specifies the path to a JSON configuration file.

The default is $OMNIHOME/etc/libnhttpd.json, which enables mimeType settings and HTTP headers in HTTP response files.

For more information about the libnhttpd.json configuration file, see Advanced ObjectServer HTTP Interface Configuration

NHttpd.DocumentRoot string -nhttpd_docroot string Specifies the document root of the embedded web service.

The default is $OMNIHOME/etc/restos/docroot.

NHttpd.EnableFileServing TRUE | FALSE -nhttpd_enablefs TRUE | FALSE Use this property to enable default file serving by the ObjectServer. This allows the ObjectServer to act as a simple HTTP server that serves files from the local filesystem.

The default is FALSE.

NHttpd.ExpireTimeout unsigned -nhttpd_exptimeout unsigned Specifies the maximum time, in seconds, that an HTTP 1.1 connection remains idle before it is dropped.

The default is 15.

NHttpd.ListeningHostname string -nhttpd_hostname string Specifies the listening host name or IP address that can be used as the hostname part of a URI to the ObjectServer HTTP or HTTPS interface.

The default is hostname.

NHttpd.SSLListeningPort integer -nhttpd_sslport integer Specifies the port on which the ObjectServer listens for HTTPS requests.

The default is 0.

NHttpd.SSLCertificate string -nhttpd_sslcert string Specifies the name of the SSL certificate of the server.

The default is ''.

NHttpd.SSLEnable TRUE | FALSE -nhttpd_sslenable TRUE | FALSE Enables the use of SSL support.

The default is FALSE.

NRestOS.OSLCRDFMsgFormat string

nrestososlcrmf string Set this property to the string MIGRATION to redevelop any utilities that are based on the ObjectServer OSLC interface so that the members resource reference list is generated in a Collection resource instance instead of a ResponseInfo resource instance in the RDF/XML payload of the Event, Detail, and Journal query capability.

The MIGRATION setting means that the members resource reference list is generated in both a Collection and a ResponseInfo resource instance. Redevelop your OSLC utilities to generate the members resource reference list only in the Collection resource instance. After the code that generates the list in ResponseInfo resource instance is removed, reset this property.