Upgrade instance
Upgrade¶
Upgrading ActiveServer is a simple process that only requires the as.jar
to be replaced with the new version.
To upgrade your existing ActiveServer instance to the latest version:
Stop the ActiveServer instance node.
Open the ActiveServer directory and back up the old
as.jar
file (simply copy or save in an archive) in case a roll back is required.Back up the ActiveServer database (refer to your database documentation for back up processes and requirements specific to your database).
Download and extract the new ActiveServer package into a temporary directory and copy the
as.jar
file to your ActiveServer directory.Start up the ActiveServer instance node. ActiveServer will automatically upgrade the database as necessary during the startup. Then the upgrade process is complete.
Clustering environment upgrade
In a clustering environment where multiple ActiveServer nodes are deployed with the same database, the database upgrade process will be handled automatically so that only one node at a time can migrate the database. The startup process of the rest of the nodes in the cluster will be blocked until the database migration is done by the first node.
Upgrading to v1.3.3 or above¶
From v1.3.3, ActiveServer supports DS Profiles which allows a single instance to connect to both card scheme production Directory Servers and the GPayments TestLabs Directory Server. However, there are two important updates that are required for clients to review when you upgrade your ActiveServer to v1.3.3 or above:
- Adding
trans-type=prod
to API requests in the 3DS Requestor - Configuring additional ports for the GPayments TestLabs to access
Important: No existing Directory Server settings or certificates will be changed during this upgrade.
Transaction type parameter¶
When you upgrade ActiveServer to v1.3.3, by default all Auth API requests will be sent to the GPayments TestLabs directory server, for testing purposes. When moving into production, to send the API request to the card scheme directory server, the trans-type
query parameter must be appended to the API URL.
This parameter is required for the InitAuth
and Auth
processes if you would like to send the authentication requests to the production Directory Server. If this parameter is not provided, the authentication requests will be sent to the GPayments TestLabs.
For example, InitAuth
will be called with following URL https://api.testlab.3dsecure.cloud/api/v2/auth/brw/init?trans-type=prod
.
Update 3DS requestor first!
Important: If you are already in production, to ensure the upgrade process proceeds smoothly the trans-type=prod
parameter can be added to your existing 3DS Requestor code before the upgrade without any issues. This will ensure that all existing implementations will send API requests to the production DS that is already configured as soon as the upgrade takes place.
Not adding the trans-type=prod
to the 3DS requestor before upgrading to v1.3.3 will result in all requests going to the TestLabs Directory Server after the upgrade.
If you are currently only using the TestLabs, then this step is not required, as API requests will continue to be sent to the TestLabs after upgrading.
Configure GPayments TestLabs¶
If ongoing access to the TestLabs is required, additional ports must be opened for TestLabs DS communications. This will allow testing with TestLabs in parallel with using the production card scheme Directory Servers. The additional ports should be externally accessible from the GPayments TestLabs Directory Server. The settings should be added to your application-prod.properties
, with example properties shown below:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | ##----------------------------------------------------------------- ## GPayments TestLabs DS ports ## ## DS ports used to connect from GPayments TestLabs directory servers ##----------------------------------------------------------------- ## Visa TestLabs as.testlab.visa.port=9800 ## Set to false to disable DS HTTPS listening port # as.testlab.visa.enabled=false ## Mastercard TestLabs as.testlab.mastercard.port=9801 ## Set to false to disable DS HTTPS listening port # as.testlab.jcb.enabled=false ## American Express TestLabs as.testlab.amex.port=9802 ## Set to false to disable DS HTTPS listening port # as.testlab.amex.enabled=false ## Discover TestLabs as.testlab.discover.port=9803 ## Set to false to disable DS HTTPS listening port # as.testlab.discover.enabled=false ## JCB TestLabs as.testlab.jcb.port=9804 ## Set to false todisable DS HTTPS listening port # as.testlab.jcb.enabled=false |
For full information on setting the application-prod.properties
, refer to the quickstart guide.
Tip
After upgrading to v1.3.3, you can safely remove all DS settings and certificates related to the GPayments TestLabs. Alternatively, this step can be completed gradually as you replace the settings with the production settings provided by the card schemes.
Rollback¶
In case you need to roll back to your previous version of ActiveServer:
Stop the ActiveServer instance node.
Open the ActiveServer directory and back up the old
as.jar
file (simply copy or save in an archive) if required.Restore your previous
as.jar
into the ActiveServer directory.Restore the ActiveServer database that you have previously backed up.
Start ActiveServer.