Installation and Configuration > Configuring Windchill RV&S servers > Configuring Windchill RV&S 12.4.0.0 Server > Configuring the Windchill RV&S OSLC Server
Configuring the Windchill RV&S OSLC Server
You must configure properties for the Windchill RV&S OSLC Server and the Windchill RV&S server before starting the Windchill RV&S OSLC Server. Use the production.json file located in <installdir>/config/ to configure these properties.
You must also ensure that the types and fields corresponding to the requirement document types and requirement types are mapped in the requirements-domain-mapping.json file for OSLC mapping. For more information on mapping requirements domain and the requirements-domain-mapping.json file, see Mapping Requirements Domain Using Windchill RV&S OSLC Server.
Configuring the Windchill RV&S OSLC Server Properties
You must manually edit the following configuration properties under olsc property in the production.json file for the Windchill RV&S OSLC Server:
Property
Description
scheme
Protocol scheme supported by the Windchill RV&S OSLC Server.
Supported protocol is http or https.
Default protocol is https.
host
Host name of the Windchill RV&S OSLC Server.
Default host name is localhost.
* 
It is recommended to specify the IP address of the Windchill RV&S OSLC Server host machine instead of the default host name (localhost).
port
Port number of the Windchill RV&S OSLC Server.
Default port number is 3001.
context
Context URI of the Windchill RV&S OSLC Server.
Default is /oslc/r.
* 
Define the context URI during initial setup only. Do not edit the URI after the context URI is set.
storageImpl
Reserved property. Do not modify.
services
Reserved property. Do not modify.
contentType
Reserved property. Do not modify.
sslPrivateKey
Private key for the SSL certificate.
Default value is server.key.
Update the private key corresponding to your SSL certificate.
* 
PTC strongly recommends to use your own SSL certificate and private key for configuring the Windchill RV&S OSLC Server.
sslCertificate
Name of the SSL certificate.
Default value is server.cert.
Update the value per the name of the SSL certificate installed on your Web server.
* 
• PTC strongly recommends to use your own SSL certificate and private key for configuring the Windchill RV&S OSLC Server.
• It is recommended to use CA-signed SSL certificates.
useClientAuthForSSL
Reserved property. Do not modify.
allowedOrigins
Whitelisted domains for allowing cross-origin requests to the Windchill RV&S OSLC Server.
Specify the domain name in the <scheme>://<host>:<port> format, where <scheme> is http or https.
For example, to allow connection requests for accessing the delegated UI from a Windchill instance hosted at https://myexample.com:8888, specify the domain name https://myexample.com:8888 as the value of this property.
Multiple domains are supported. To specify multiple domains, provide the domain names per the format separated by a comma. For example, https://myexample.com:8888,http://localhost:8080.
* 
System integrators must set this property if they plan to use the delegated UI for resource selection.
isamScheme
Supported scheme on the ISAM virtual host junction for the Windchill RV&S OSLC Server.
Supported scheme is https.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.
isamHost
Host name of the Windchill RV&S OSLC server configured on the ISAM virtual host junction.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.
isamPort
Port number of theWindchill RV&S OSLC Server configured on the ISAM virtual host junction.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.
appendSlash
Append a slash to the start of the project name in the URIs if the Windchill RV&S OSLC Server is configured with the ISAM authentication scheme.
oauthAuthorizationURI
URI for obtaining OAuth authorization.
Contact the PingFederate administrator for the OAuth authorization URI.
* 
The property is applicable only if the Windchill RV&S server is configured for Single Sign-On.
oauthAccessTokenURI
URI for obtaining OAuth access token.
Contact the PingFederate administrator for the OAuth access token URI.
* 
This property is applicable only if the Windchill RV&S server is configured for Single Sign-On.
oauthRequestTokenURI
URI for obtaining OAuth request token.
Contact the PingFederate administrator for the OAuth request token URI.
* 
This property is applicable only if the Windchill RV&S server is configured for Single Sign-On.
* 
• For SSO-enabled configuration, the OSLC clients can automatically discover the three OAuth URIs that are required to act as an OAuth Consumer. These URIs are returned in the service provider catalog if the oauthAuthorizationURI, oauthAccessTokenURI, and oauthRequestTokenURI properties are specified in the production.json file.
For more information on the supported SSO configuration for Windchill RV&S, see the Windchill RV&S Single Sign-On Configuration Guide.
• The OSLC APIs utilize the OAuth tokens for connecting to the target OSLC servers in the Refreshed Web Interface when SSO is enabled.
Configuring the Windchill RV&S Server Properties for the Windchill RV&S OSLC Server
You must manually edit the following configuration properties under ilm property in the production.json file for the connection between the Windchill RV&S server and the Windchill RV&S OSLC Server:
Property
Description
scheme
Protocol scheme on which the Windchill RV&S server is running.
Supported protocol is https.
host
Host name of the Windchill RV&S server.
Default host name is the host name set during installation of the Windchill RV&S OSLC Server.
port
Port number of the Windchill RV&S server.
The default port number is the port number set during installation of the Windchill RV&S OSLC Server.
baseContext
Base URI for the Windchill RV&S REST services.
* 
This property is reserved. Do not modify.
strictSSL
Support for trusted or self-signed certificates for the connections.
If value is set to true, only trusted certificates are supported for the connections.
If value is set to false, both trusted and self-signed certificates are supported for the connections.
Default value is false.
docStudioContext
Provides the context to the linked Windchill RV&S item in the resource previews.
* 
This property is reserved. Do not modify.
isamScheme
Supported scheme on the ISAM virtual host junction for the Windchill RV&S server.
Supported scheme is https.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.
isamHost
Host name of the Windchill RV&S server configured on the ISAM virtual host junction.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.
isamPort
Port number of the Windchill RV&S server configured on the ISAM virtual host junction.
* 
This property is applicable only if an ISAM server is configured as a reverse proxy for the Windchill RV&S server.