Jabber Server Configuration

Setup a Jabber Server to receive Instant Message (IM) notifications

Examine can be configured to send Test Suite completion notifications using the XMPP/Jabber protocol. To enable this functionality,  the administrator must configure a Jabber server using the Administration->Jabber screen

The Connect on server startup option instructs Examine to establish an XMPP connection on server startup. If a connection cannot be established on startup, an error will be logged on the console and notifications may not be delivered to the recipients correctly. So it is recommended that this option be enabled after verifying that a test instant message can be sent.

The Host, Port values correspond to the Jabber server host and port.

The username and password to log into the Jabber server must be specified as well if required.

If TLS/SSL option is enabled, all XMPP communication with the Jabber server will be secure. By default, Examine is configured to use to the default cacerts truststore that comes bundled with the Sun JRE. This truststore contains the certificate of well-known certificate authorities (CAs). However, the administrator can override this option and select another truststore to use. This option is useful when working with self-signed certificates that are not issued by any CA.

The Enable Client Authentication option enables SSL client-authentication with the IM server. By default this option is disabled as this requires that the client also possess a valid certificate. If the server running Examine contains a valid X.509 private / public key pair, then the keystore containing this key must be selected.

Configuring Google Talk as the IM server

Ensure that the server where Examine is configured/installed can communicate with Google Talk on talk.google.com and ports 5222 and 5223. Examine will automatically use the SASL PLAIN authentication mechanism, which is also the only Google Talk supported authentication mechanism.

TLS is required by default.

Enter the host name as gmail.com Leave the port number empty - Examine will automatically use the correct port.

Enter your username as name@gmail.com and your gmail password.

Ensure the TLS/SSL Enabled checkbox is checked and leave the Use Default Truststore checked.

Test the configuration by clicking on Test and entering another gmail account user as the recipient of the test message (as name@gmail.com). Click Save to save the configuration

Sample test IM on successful configuration

If the IM server and the Jabber configuration is setup correctly, then clicking on the Test button should make Examine to send a test IM with the message: Success! This is a test message to confirm that your Jabber configuration is correct!. A successful test message as received in the iChat IM client is shown below: