🔗 Source article (Salesforce): Click here
Manual | How-to's | Major Releases | Release notes
In this article the installation-procedure to update HealthConvEx is described.
For downloading and installation of HealthConvEx the following end-points should be available for application-server::
Downloading the .exe file
You can download the newest version of HealthConvEx (.exe) via the following links to our 'rings':
The second and most stable version of our roll-out plan. Depending on the magnitude of changes, this roll-out will go faster or slower. The actual speed of installation is decided by the HealthConnect R&D and Service teams. All users that did not give a specific preference of ring are included in this ring. New installations at the customer should be done with a release from this ring.
We offer normal support, picking up bugs according to priority and severity. All users are free to install this version at their convenience.
We roll-out our production release in two phases. A first batch is grouped in this ring, the fast ring. Depending on the magnitude of change, this roll-out is still relatively slow. The actual speed of installation is decided by the HealthConnect R&D and Service teams. Users in this ring will receive new features first, with the possible downside of experiencing a few bugs. If you want to be included in this ring, contact HealthConnect Service teams.
We offer normal support, picking up bugs according to priority and severity. Installation of these releases should be done in close coordination with HealthConnect R&D and Service teams.An insiders release is a pre-production release. The goal of this ring is to start pilot testing by installing at preselected users or in the acceptance environment of a customer. Releases in this ring are not public production releases. They have not been fully tested, and should only be installed at a customer after explicit approval of HealthConnect R&D and Service teams to solve a known bug.
We offer limited support, picking up bugs according to priority and severity in accordance with capacity. Installation of these releases should be done in close coordination with HealthConnect R&D and Service teams.
Pre-installation procedure
Before installing the update, it is strongly recommended to make a backup of the database and filestore.
More information about backing up a database can be found here.
To find out the location of the database, you can consult the application.properties. These can be found at: C:\Program Files\healthconvex\application.properties .
Important: If any users are active within HealthConvEx, you should warn them of a 15-30 minute downtime during the update.
Important: You must perform the update on the SERVER where the HealthConvEx service is running.
Important: The current version of HealthConvEx is written at the top of the search page: 'HealthConvEx 8.x.x-bxxx'. Do not downgrade!
In addition, you must also stop the HealthConvEx service before installation (Step 3). If you do not do this you will get a FAILURE in the Test.
You can stop the service by opening Services on the application server. Then search for the healthconvex service and you can stop the service.
[ IMAGE: image.png ]
Execute the .exe-file
If you connect to the database via integrated security, you must run the installer with the correct AD-user. If you are unsure, check the connection string by default in C:\Program Files\healthconvex\application-prd.properties.
The installer will check network- and database parameters. In case of errors during this check, you can find the general requirements here.
Installation: step 1 'Internet Connectivity'\
In case of an update, you normally do not need to change anything here. You can click on Test and, if the test is successful, on Next.
[ IMAGE: image.png ]
Proxy Type
As Proxy Type you can select 'DIRECT'.
Other options:
HTTP
SOCKS
Environment Depending on which environment (Production or Acceptance/Test) you want to install HealthConvex on, you must select the correct Environment.
For Production environments, select 'Production (default)'.
For Acceptance environments, select 'Acceptation'.
However, as often a (recent) copy of the production database is used on the acceptance environments, in practice most hospitals will also select 'Production (default)' for acceptance environments.
Test
Before you can proceed to the next step, you must click on Test.
If the test is successful, you can click on Next to continue with the installation.
Installation: step 2 'Database Connectivity'
In case of an update, you normally do not need to change anything here. You can click on Test and, if the test is successful, on Next.
[ IMAGE: image.png ]
Database type
You must select 'Microsoft SQL' as Database Type. The minimum requirement is MS SQL 2016.
Database URL
The general format for the connection URL is: jdbc:sqlserver://[serverName[\instanceName][:portNumber]];databaseName[=databaseName]
Example with integrated security:
jdbc:sqlserver://hostname\instance;database=healthconvex;integratedSecurity=trueLeave the Database user and Database password fields empty.
Example with SQL user:
jdbc:sqlserver://hostname\instance;database=healthconvexProvide the correct username/password for this user.
Database user and password
Here you can enter the database user and password. This is the user who has access to the database. This user must have DML and DLL rights.
If you are working with Integrated Security, leave these fields blank.
Test
Before you can proceed to the next step, you must click on Test.
If the test is successful, you can click on Next to continue with the installation.
Installation: step 3 'Accessibility'
In case of an update, you normally do not need to change anything here. You can click on Test and, if the test is successful, on Next.
[ IMAGE: image.png ]
Listening Interface
This is the interface to expose the HealthConvEx application on. By default we expose the application over ALL network interfaces (0.0.0.0).
0.0.0.0 - All interfaces
Listening port
8080 for local host
443 typical for setup with SSL-certificat
Test
Before you can proceed to the next step, you must click on Test.
If you get a FAILURE here, another process is using the selected interface, you have to stop the Windows service called "healthconvex".
If the Test is successful, you can click Next to continue with the installation.
Installation: step 4 'Upgrade'
[ IMAGE: image.png ]
We recommend that you download the installer for the previous version of HealthConvex before installation.
In addition, you should indicate that you have taken a backup of HealthConvex:
Backup of the SQL Database
Backup of the configuration
Backup of the filestore
If you have completed all steps click Next.
Installation: step 5 'Installation'
Then click on Next one last time to start the installation.
[ IMAGE: image.png ]
If the upgrade is successful you will see the following screen where you can click on Finish.
[ IMAGE: image.png ]
Verify that the HealthConvEx service is up and running.
Important: A fully completed update of HealthConvEx cannot be reverted without a full backup and always results in some downtime. Please contact our support if there are any questions.
Users are advised to clear caches of browser after an update (Shift + Ctrl + F5).
Any questions?
Please contact our helpdesk available (mon-fri) from 9am to 5pm. You can reach us at the number +32 (0)2 600 40 40 or by e-mail at support@healthconnect.be.
We will be glad to help you further.