Endeca Server and the endeca-cmd command interface

In a secure installation of the Endeca Server, the endeca-cmd utility communicates with the Endeca Server securely.

Two versions of the endeca-cmd command utility exist — SSL-enabled and non-SSL. The SSL version of endeca-cmdis located in the $DOMAIN_HOME/EndecaServer/bin directory, and is the one you should be using for an Endeca Server SSL deployment.

The SSL version lets you issue endeca-cmd commands without having to specify the location of the SSL certificates with the --keystore and --truststore options (as they are used automatically). It does so by making use of the $DOMAIN_HOME/config/EndecaCmd.properties configuration file. The file paths in EndecaCmd.properties are set automatically by the generate_ssl_keys utility.

When you run the endeca-cmd command utility in a secure installation, you need to specify the location of the Java keystore file (endecaServerClientCert.ks) and the Java truststore file (endecaServerTrustStore.ks), as well as the password for the key and trust stores. Providing this information enables the endeca-cmd command utility to communicate securely with the Endeca Server.

By default, you are prompted for the keystore password whenever you issue a command. This is the password that you specified with the --sslPassphrase flag of the generate_ssl_keys utility. Note that you can override the prompt by providing the password with the --password option; however, you should not create a script that uses the --password option, as the password would have to be specified in clear text.

SEVERE: Error while invoking endpoint "http://localhost:7001/endeca-server/ws/manage" from client
endeca-cmd encountered a problem.

caused by: 
Error contacting the Endeca Server localhost:7001: Client received SOAP Fault from server : 
OES-000149: Only allowing https connections, received http

caused by: 
Client received SOAP Fault from server : OES-000149: Only allowing https connections, received http

For more information on the SSL version of the endeca-cmd command utility, see the Oracle Endeca Server Administrator's Guide.