Upgrading / New iVeri Client to 4.0.2 installation

Technical questions relating to the .Net API integration

Upgrading / New iVeri Client to 4.0.2 installation

by samora Wed Apr 20, 2016 1:21 pm
Setting Up Your Environment
To make use of iVeriClient 4.0.2 you need at least have Microsoft .NET Framework 4.6
For the purpose of this exercise i will assume that you will be making use of the following directory as your iVeri Client Working Directory.
C:\iVeriClient

Please Note
This directory does not have to be the same as above. However it has to be a directory that the user running your application will have access to.
Create your working directory

Windows
Right Click Computer -> Properties
Click on Advanced System Settings
Click on Environment Variables
Under System Variables click on New.
Variable Name = iVeriClient_Home
Variable Value = C:\iVeriClient
Note
that the directory "C:\iVeriClient" needs to be created before you start the process as discussed above.
You may be required to reboot the machine after updating your Environment Variables.

Image
Click on OK





If Upgrading from a previous version and Running iVeri Client for the first time

  • locate and open your existing iVeriClient.config on %Program Files%/iVeri/Client and copy the DefaultCertificateID under your current gateway. This will be under the gateway name you are making use of.
    Code: Select all
    <DEFAULTCERTIFICATEID>7eb345af-dc94-413b-918c-81b33419383f</DEFAULTCERTIFICATEID>
  • Place your new iVeriClientConfig.exe and iVeriClient.dll in your iVeriClient_Home directory. You will have download the new iVeri Client .Net 4.0.2 from Click Here
  • Run the iVeriClientConfig.exe as Administrator.
  • You may be prompted to choose a default gateway you will be making use of
    • please enter nedbank for the Nedbank gateway or enter host for other banks.
  • Now the following will be desplayed
    Image
  • Now capture your default certificate as shown below, note that this is the certificate id we copied above.
    Image
  • You may now perform your "ApplicationID ping iVeri Gateway" to ensure your setup is correct.



For New Installation or Requesting for a new certificate
  • Please login to Backoffice using the Administrator credentials.
  • Go to Menu item Certificate -> Manage Certificates
    Image
  • Click on "New Certificate" at the top of the page
    Image
  • Fill in the required info. Also note the the password field is required. Once done, click on the box at the bottom of the fields.
    Image
    • Should you not be presented with the page above, please contact your local support team and ask them to move you to the new certificate chain.
    • Once you are moved to the new certificate chain then you no longer be able to request for a new cert using an older version of iVeri Client.
  • Download your certificate and place it in your iVeriClient_Home directory
    Image
  • Now run your iVeriClient Utility and set the default certificate id as shown below.
    Image
Optional Set Certificate Authentication
Please note that by default this is set to NO.
This must not be set to yes if you are making use of a Certificate ID that may have been requested on an old iVeri Client(Version 3, 2 , 1 ).
Should you wish to set this to yes the you may do the following
Image
Note
  • The password prompted for is the password that you created in Backoffice while requesting for the certificate
  • Should you wish to us the Certificate Store as your "Certificate Source" then
    • You need to import your certificate by double click your new certificate as downloaded from Backoffice.
    • Ensure that Local Machine is selected as your Store Location as shown below.
      Image
    • Click Next and should you be prompted for a password then provide the password that you created in Backoffice while requesting for your certificate.


Now You may make use of your new iVeriClient.dll on your application
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by CandiceDaniel Fri Apr 29, 2016 11:58 am
Hi We have followed every step and are getting the following error
Transaction Status: Failed Error Description: mscorlib Could not find file 'c:\windows\system32\inetsrv\iVeriClient.config'.
Posts
5
Joined
Wed Apr 13, 2016 7:25 am

Re: Upgrading / New iVeri Client to 4.0.2 installation

by samora Fri Apr 29, 2016 12:05 pm
The above means that you either have not set the iVeriClient_Home directory in you Environment Variables or you are still making use of the Old iVeriClient.dll from your application. Please ensure that you are referencing the new iVeriClient.dll from your application.
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by CandiceDaniel Fri Apr 29, 2016 12:13 pm
Hi
We have changed the Environment Variables and I have replaced the dll in my application.
we have not restarted the server
Posts
5
Joined
Wed Apr 13, 2016 7:25 am

Re: Upgrading / New iVeri Client to 4.0.2 installation

by samora Fri Apr 29, 2016 12:16 pm
CandiceDaniel wrote:Hi
We have changed the Environment Variables and I have replaced the dll in my application.
we have not restarted the server


Please try restarting your sever.
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by CandiceDaniel Fri Apr 29, 2016 12:21 pm
It is a live server we would like to see what else we could do first.
Any suggestions?
Posts
5
Joined
Wed Apr 13, 2016 7:25 am

Re: Upgrading / New iVeri Client to 4.0.2 installation

by samora Fri Apr 29, 2016 12:28 pm
CandiceDaniel wrote:It is a live server we would like to see what else we could do first.
Any suggestions?

In your iVeriClient_Home directory. Do you have the file iVeriClient.config? if so, when was the last time the file was updated?
If this file was updated recently then you may need to either restart IIS or the entire server.
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by CandiceDaniel Fri Apr 29, 2016 12:32 pm
I updated it with the default cert id so it was updated then? is there nothing else we can do?
Posts
5
Joined
Wed Apr 13, 2016 7:25 am

Re: Upgrading / New iVeri Client to 4.0.2 installation

by samora Fri Apr 29, 2016 12:36 pm
You can temporarily copy your iVeriClient.config from your iVeriClient_Home directory to c:\windows\system32\inetsrv\ till such time that you can be able to reboot your server.
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by CandiceDaniel Fri Apr 29, 2016 12:41 pm
Thanks will try that. Appreciate your help.
Posts
5
Joined
Wed Apr 13, 2016 7:25 am

Re: Upgrading / New iVeri Client to 4.0.2 installation

by dann Mon May 09, 2016 12:05 pm
Hi Samora
Current version being used (v240). All steps as per your procedure have been followed. Current error: setCertificate() must be called before this method is allowed.
Please advise soonest as this platform is now down since 02-05-2016.
Posts
1
Joined
Wed May 04, 2016 4:33 pm

Re: Upgrading / New iVeri Client to 4.0.2 installation

by samora Mon May 09, 2016 1:58 pm
dann wrote:Hi Samora
Current version being used (v240). All steps as per your procedure have been followed. Current error: setCertificate() must be called before this method is allowed.
Please advise soonest as this platform is now down since 02-05-2016.


This would mean that in your application you are still making use of the old iVeriClient.dll and not the new one. Please check and advise.
Posts
54
Joined
Thu Sep 17, 2015 3:29 pm

Sort By

Jump To