This page describe the two-steps procedure to perform a copy of the ECtrans Associations from one ECaccess Gateway to another.
Please note that if you follow this procedure then all the data of the target Gateway will be removed (e.g. ECtrans Associations) and replaced by the data of the source Gateway.
The two-steps are:
- Export and Decrypt Decryption of the ECtrans Associations from the existing ECaccess Gateway.
- Encrypt Encryption and Import of the ECtrans Associations into the new ECaccess Gateway.
Because each Gateway has its own private-key for encryption it is required to decrypt and re-encrypt the ECtrans Associations with the relevant private-key.
Each step can be automated by using the scripts:
- decrypt.sh
- encrypt.sh
In order Before to follow the procedure, please first download these two scripts and place them respectively the following files and copy them into the mentioned directories:
- upgrade.jar: in both "bin" directories of the existing and new Gateway.
- decrypt.sh: in the "bin" directory of the existing Gateway
...
- .
- encrypt.sh: in the "bin" directory of the new Gateway.
Also, on the new ECaccess Gateway, make sure the "gateway/db" directory is original (the one from the distribution) and remove any "private-key.keystore" from the "gateway/conf" directory. This is important to allow a smooth execution of the procedure.
Note the following steps have to be performed as the UID under which the Gateway is running (e.g. root).
Step 1
Go to the "bin" directory of your the existing Gateway :
#cd gateway/bin
Make sure the Gateway and make sure it is not running:
#./gateway stop
Then start the export/decryption of the ECtrans Associations:
#./decrypt.sh
Once If the script has completed the file complete successfully, a file named "uncrypted-assoc.sql" has been created is created in the current directory with the ECtrans Associations in clear text.
Just copy move this file to the "bin" directory of the new Gateway.
Step 2
On the new Gateway, make sure the "gateway/db" directory is original (the one from the distribution - unmodified). Please also make sure to remove the "private-key.keystore" from the conf directory.
Then go to the "Go to the "bin" directory of the new Gateway :
#cd gateway/bin
Make and make sure it is not running:
#./gateway stop
Then start the encryption of the ECtrans Associations:
#./encrypt.sh
Once If the script has completed the file complete successfully, a file named "ecaccess.script" has been created is created in the current directory with the encrypted ECtrans Associations.
...
Move this file to the "gateway/db" directory:
...
#mv ./ecaccess.script ../db/.
Delete the clear text file:
#rm -f uncrypted-assoc.sql
And start the Gateway:
#./gateway start