sslconfig

Syntax

sslconfig [parameter_name [parameter_value]]

Parameters

• parameter_name – the SSL parameter to be set.
• parameter_value – the value of the SSL parameter.

  parameter_name	parameter_value
  dts_server_ssl_enabled	Whether DA agent creates its data transfer socket using SSL. Default: false. You must restart DA agent for this parameter to take effect.
  keypair_passwd	The password to grant access to the public/private key pair within the keystore. This value is encrypted on disk. When this value is displayed in the command line tool (CLT), a ******** placeholder indicates it is set to a nonblank value. You must restart DA agent for this parameter to take effect.
  keystore	The absolute path to the keystore (flat file) that contains the public/private key pair to use. You must restart DA agent for this parameter to take effect.
  keystore_passwd	The password to grant access to the keystore. This value is encrypted on disk. When this value is displayed in the CLT, a ******** placeholder indicates it is set to a nonblank value. You must restart DA agent for this parameter to take effect.
  rmi_server_ssl_enabled	Whether DA server requires all RMI clients to connect using SSL. Default: false. You must restart DA agent for this parameter to take effect.
  truststore	The absolute path to the truststore (flat file) that contains the trusted certificate. You must restart DA agent for this parameter to take effect.
  truststore_passwd	The password to grant access to the truststore. This value is encrypted on disk. When this value is displayed in the CLT, a ******** placeholder indicates it is set to a nonblank value. You must restart DA agent for this parameter to take effect.

Examples

• Example 1 – shows all SSL configuration parameters:

  sslconfig 
  go

  The returned result is:

   NAME                     VALUE      PENDING  REQUIRE RESTART
   -----------------------  -------    -------  --------------- 
   dts_server_ssl_enabled   false                     true
   keypair_passwd                                     true
   keystore                                           true
   keystore_passwd                                    true            
   rmi_server_ssl_enabled   false                     true     
   truststore                                         true     
   truststore_passwd                                  true   
  
  (0 rows affected)
    
   

• Example 2 – shows the current value and its description of a SSL parameter:

  sslconfig  dts_server_ssl_enabled 
  go

  The returned result is:

   NAME                    VALUE   PENDING  REQUIRE RESTART
   ----------------------  ------  -------  --------------- 
   dts_server_ssl_enabled  false                  true
   
  (0 rows affected)
  
  DEFAULT MINIMUM MAXIMUM EXPLANATION
  ------- ------- ------- -------------------------------
                          Whether this DA agent should use 
                          SSL when streaming data via its DTS.
                           
   (0 rows affected)
  

• Example 3 – changes the default value of an SSL parameter:

  sslconfig rmi_server_ssl_enabled true
  go