How to upgrade from version 1.x - 2.4.x to version 2.5.x
Important changeovers were made from the previous version to the current version.
- The operating system has been updated from CentOS6 to CentOS7
- The application server was migrated from jboss 7 to WildFly 14.0.0.Final
- In addition to a series of application improvements that you can find at the changelog https://confluence.namirial.com/display/SWS/Changelog
To complete the update you need to create a new machine and proceed to a new appliance installation that you find at the following link SWS OnPremise Installation Guide#HowtoobtaintheOVFvirtualappliance .
A step by step installation guide can be found at the following link SWS OnPremise Installation Guide#Deploymentandtest.
Once the installation is complete you will need to reconfigure your VA with the production keystore, you can find at this link a detail on how to do this SWS OnPremise Installation Guide#MigratefromTESTtoPRODenvironment.
If you want to stay up to date with the latest version we recommend you follow this guide. HowcaniupgradeSWSappliancetolatestversion?
How can i export the log from SWS?
At this link:
SWS OnPremise Installation Guide#ExportLogFiles
You can see the guide for export the files.
How can i see the SWS version?
There are two ways. First way:
Go to link:
http://<IP-APPLIANCE>:8080/SignEngineWeb/help.xhtml
And read the version software (starts with 2.x )
Or:
1) Login SSH to appliance and execute:
rpm -q sws
And read the version software (starts with 2.x)
NOTE: for the old appliance SWS is available only the second way.
How can i upgrade SWS appliance to latest version?
1) Login SSH to SWS appliance
2) Execute:
sudo yum update https://sws.namirialtsp.com/download/sws.rpm
How can i upgrade SWS appliance menu to latest version?
1) Login SSH to SWS appliance
2) Execute:
sudo yum update https://sws.namirialtsp.com/download/sws_menu.rpm
How can i obtain the latest version of SWS appliance?
At this link:
SWS OnPremise Installation Guide#HowtoobtaintheOVFvirtualappliance
You can obtain the latest version and the details for import and configure
How can i obtain the TEST Namirial App OTP?
For Android:
https://appdistribution.firebase.dev/i/e843f2440b8a7b69
For iOS:
https://testflight.apple.com/join/4ZUE4zjf
Template support request in case of problems with integration
The fields required are:
DATE and TIME when you have received the error: ???
URL ENDPOINT: ???
METODO NAME CALLED: ???
INPUT PARAMETERS: ???
ERROR RECEIVED (from our server): ???
How can i install SWS in standalone mode?
Is possible to install SWS in standalone mode ONLY in server RedHat, Almalinux9 and CentOS (this OS is supported until June 2024). Below the procedure:
wget https://sws.firmacerta.it/download/sws2_packages.tar.gz tar xzfv sws2_packages.tar.gz
Move into directory just extracted and run this command:
./install.sh
How can i TEST SWS SaaS?
The url prefix for TEST SWS SaaS is:
https://sws-companynamesaas-test.namirialtsp.com/SignEngineWeb
This is the link for download SSL certificate on our service
For example during the integration the full url to use for SOAP request is:
https://sws-companynamesaas-test.namirialtsp.com/SignEngineWeb/sign-service?wsdl
And the full url for REST request is:
https://sws-companynamesaas-test.namirialtsp.com/SignEngineWeb/rest/sign/signPades
How can i fix the problem caused by truststore not updated?
If in the SWS logs is present the messege:
Caused by: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
The problem maybe caused by the trustore not updated. Below the step to fix the problem:
1) Login SSH to the SWS virtual machine
2) Type the following command
rpm -q sws
3) If the output of the command starts with "sws-2.4" you should perform the following commands:
wget https://sws.firmacerta.it/download/truststore.jks -O /home/jboss/.SignEngine/keystore/truststore.jks wget https://sws.firmacerta.it/download/cacerts -O /usr/java/latest/lib/scurity/cacerts
And
service jboss restart
If the output of the command starts with "sws-2.5" you should perform the following command:
sudo wget https://sws.firmacerta.it/download/truststore.jks -O /home/wildfly/.SignEngine/keystore/truststore.jks
And
sudo service wildfly restart