Errors starting XIC after upgrading to Version 1.30 from previous versions

Errors starting XIC after upgrading to Version 1.30 from previous versions

When upgrading to version 1.30 from a previous version, the following occurs:

  1. Rename the .ssh and .pem files as follows:

    XIC_EP.ssl to XIC_EP.ssl.bak
    XIC_PrivatePair.pem to XIC_PrivatePair.pem.bak
    XIC_PubKey.pem to XIC_PubKey.pem.bak
    XIC_XTR_EP.ssl to XIC_XTR_EP.ssl.bak
    XIC_XTR_PrivatePair.pem to XIC_XTR_PrivatePair.pem.bak
    XIC_XTR_PubKey.pem to XIC_XTR_PubKey.pem.bak
  2. Recreate the .ssl and .pem files and encrypt them using Java.
  3. Replace everything else with the files in the version 1.30 package.
In the event the Upgrade is done before the files have been renamed, the installation script replaces everything with files in the Version 3 package (step 3) and therefore the upgrade never works

As a result, the previous-version .ssl and .pem files are still in place and XIC is trying to decrypt them using Java, but they have been encrypted using openssl.

The Customer will need to carefully perform the steps below manually, replacing the directory indicated with ?/ with the full path of the directory. For example, in my installation, the full path to ?/XYPRO is /users/davet/local/XYPRO.

  1. Make a backup copy of the current installation. For example:
    cp -R ?/webservices ?/webservices_bak
  2. In the ?/webservices directory:
    ./shutdown.sh
  3. In the ?/.ssh directory:
    mv XIC_EP.ssl XIC_EP.ssl.bak
    mv XIC_PrivatePair.pem XIC_PrivatePair.pem.bak
    mv XIC_PubKey.pem XIC_PubKey.pem.bak
    mv XIC_XTR_EP.ssl XIC_XTR_EP.ssl.bak
    mv XIC_XTR_PrivatePair.pem XIC_XTR_PrivatePair.pem.bak
    mv XIC_XTR_PubKey.pem XIC_XTR_PubKey.pem.bak
    chmod +x ?/dst/iXYKeygen.jar
    chmod +x ?/dst/iXYCrypto.jar
    java -jar ?/dst/iXYKeygen.jar -keygen -alg RSA -keylength 4096 -publickey ?/.ssh/XIC_XTR_PubKey.pem -privatekey ?/.ssh/XIC_XTR_PrivatePair.pem -debug
    java -jar ?/dst/iXYKeygen.jar -keygen -alg RSA -keylength 4096 -publickey ?/.ssh/XIC_PubKey.pem -privatekey ?/.ssh/XIC_PrivatePair.pem -debug
    java -jar ?/dst/iXYCrypto.jar passphrase ?/.ssh/XIC_XTR_PrivatePair.pem ?/.ssh/XIC_XTR_EP.ssl
    java -jar ?/dst/iXYCrypto.jar passphrase ?/.ssh/XIC_PrivatePair.pem ?/.ssh/XIC_EP.ssl

    Note: Replace passphrase with your current Java keystore passphrase.

    chmod 400 XIC_XTR_PrivatePair.pem
    chmod 400 XIC_XTR_PubKey.pem
    chmod 400 XIC_PrivatePair.pem
    chmod 400 XIC_PubKey.pem
    chmod 400 XIC_EP.ssl
    chmod 400 XIC_XTR_EP.ssl
  4. In the ?/webservices directory:
    ./startup.sh