Installer 10.5 | Complete Installation and Upgrade Information for Software AG Products | Upgrading Software AG Products On Premises | Prepare New Products, Old Products, Database Components, and ZIP Files for Migration | Prepare the Old Environment for Migration | Prepare the Old API Gateway
 
Prepare the Old API Gateway
1. Back up the old API Gateway's data store.
2. Go to the new_Software AG_directory/InternalDataStore/config directory, open the elasticsearch.yml file, and add this line at the end:
reindex.remote.whitelist: old_data_store_host_name:old_data_store_port
3. If you used custom keystore files in the old API Gateway installation, copy the files to the same location in the new installation.
4. Upgrade from 10.1: If the old data store is protected with HTTPS, add the old certificates to the JVM trust store for the new data store.
Then go to the old_Software AG_directory/IntegrationServer/instances/API Gateway_instance_name/packages/WmAPIGateway/config/resources/elasticsearch directory and open the config.properties file.
a. Add this line at the end of the file:
pg.gateway.elasticsearch.hosts=old_data_store_host_name:old_data_store_port
b. If the old data store is protected with basic auth, add these lines:
pg.gateway.elasticsearch.http.username=user_name_to_connect_to_old_data_store
pg.gateway.elasticsearch.http.password=password
c. If the old data store is protected with HTTPS, set this property:
pg.gateway.elasticsearch.https.enabled=true
5. If the old and new data stores are using the same ports, change the new data store to use different ports until the migration is completed, as follows:
a. Go to the new_Software AG_directory/InternalDataStore/config directory, open the elasticsearch.yml file, and change the values for the HTTP port on the http.port property and for the TCP ports on the discovery.zen.ping.unicast.hosts and transport.tcp.port properties.
b. Go to the new_Software AG_directory/IntegrationServer/instances/instance_created_during_installation/packages/WmAPIGateway/config/resources/elasticsearch directory, open the config.properties file, and find the pg.gateway.elasticsearch.hosts property. If the property is set to changeOnInstall, you need do nothing further. If the property is set to a host:port, change the port value to the value you just specified for the http.port property.
6. Start the old data store by starting the service Software AG Internal Data Store or by opening a command window or shell, going to the old_Software AG_directory/{EventDataStore|InternalDataStore}/bin directory, and running the command startup.bat
7. Start the new data store by starting the service Software AG API Gateway Data Store or by opening a command window or shell, going to the new_Software AG_directory/InternalDataStore/bin directory, and running the command startup.bat