Install a New Server Certificate: Java Keystore

Use this procedure to replace the default Transfer Server or Gateway Administrator server certificate with a CA-signed certificate contained within a Java keystore.

Before you begin

Obtain a Java keystore (*.jks) file that contains your private key and a certificate signed by a Certificate Authority (CA). You can use the following procedures to create your keystore using the Java keytool utility.

To replace the default server certificate with a certificate in a Java keystore

  1. Move the new Java keystore to the folder that holds the default keystore (or to any secure location on your server). The default keystore locations are:

    <install path>\TransferServer\etc\

    <install path>\GatewayAdministrator\etc\

    Caution: Do not delete any of the existing certificates or keystore files in these locations. The server certificates located here are required for communication between FileXpress Gateway components.

  2. Locate the container.properties file in the location below for the server you are updating.

    <install path>\TransferServer\conf\container.properties

    <install path>\GatewayAdministrator\conf\container.properties

  3. Open container.properties in a text editor (running as an administrator). Remove the comment character (#) from the following lines and edit them to point to your keystore and specify your keystore password. For example:

    servletengine.ssl.keystore=../etc/newkeystore.jks

    servletengine.ssl.keystorepassword=mypassword

    Note: The path to the keystore must be specified using forward slashes or escaped backslashes. For example: C:/pathto/keystore or C:\\pathto\\keystore

  4. Restart the server you are configuring. See Start and Stop the FileXpress Transfer Server and Start and Stop the FileXpress Gateway Administrator Service.
  5. If you replaced the Gateway Administrator certificate, you must repeat the Activate and verify action on the FileXpress Secure Shell Proxy. This reestablishes the connection to the Gateway Administrator using the new certificate.
  6. Confirm that you can log on to the Transfer Client or Gateway Administrator. If you can't log in, or if you continue to see a certificate warning message, see Troubleshooting Server Certificate Setup.