Upgrading the CAREWare 5 Business Tier to the CAREWare 6 Business Tier

RSS

» Upgrading the CAREWare 5 Business Tier to the CAREWare 6 Business Tier (CAREWare 6)

CAREWare support and documentation has been moved to a new location. For the most updated user guides and documentation for CAREWare click on the link below:

jPROG CAREWare Support Portal

Upgrading the CAREWare 5 Business Tier to the CAREWare 6 Business Tier

Overview

The CAREWare 6 (CW6) Business Tier is a REST server installed as a Windows Service. By default it listens on port 8000 and responds to requests made by the CAREWare HTTP Service. It will be replacing the CARWare 5 (CW5) Business Tier, which is a .NET Remoting/SOAP server that communicates with multiple CW5 Clients over the default port 8124.

CW6 uses the same BusinessTierSettings.xml file format as CW5, though it will look for it in the new CW6 installation directory. CW6 also uses the same CW_Data SQL server database as CW5, and CAREWare’s Data Tier Update process will automatically update that database when CW6 connects to the database the first time.

Here is a diagram of the CAREWare 5 architecture.
Here is a diagram of the CAREWare 6 architecture.

The rest of this document outlines each step you should take to upgrade the Business Tier to CW6.

Make a copy of your CW5 BusinessTierSettings.XML file.

If you installed the CW5 Business Tier in the default location, the BusinessTierSettings.XML will be in the C:\Program Files(x86)\CAREWare\RW CAREWare Business Tier directory. Make a copy of this file and put it in a handy place so you can copy it to the CW6 installation folder later.

Make sure there are current backups of CW_Data and any related CW databases
Here are instructions for creating a backup of the CAREWare data.

Uninstall the CW5 Business Tier

Using Windows Programs and Features application find RWCAREWare Business Tier and uninstall it.

Close port 8124 in the Windows Firewall and Router Port Forwarding

If you opened up port 8124 in your Windows Firewall or Router, make sure you have removed the exceptions for this port. The CW6 Business Tier does not use 8124 unless you change its default configuration. By default it listens to port 8000, and if the CAREWare HTTP Server is installed on the same box, you should leave that port closed.

Run CwBtSetup.exe

This will start a simple setup wizard in which you acknowledge steps by clicking Next until you are given the option to install. Select the default installation directory C:\Program Files\CAREWare Business Tier unless you have a reason not to.

Run CWHTTPSetup.exe

This will start a simple setup wizard in which you acknowledge steps by clicking Next until you are given the option to install. Select the default installation directory C:\Program Files\CAREWare HTTP Server unless you have a reason not to.

Stop CAREWare Business Tier

Here are instructions for stopping the business tier service.

Open the Windows Services application and find CAREWare Business Tier. It will likely already be stopped because of not being able to connect to CW_Data on your SQL server with the default BusinessTierSettings.xml connection string. If it is not stopped, right click on the service and click Stop.

Replace the default CW6 BusinessTierSettings.xml with the CW5 settings file

Find the BusinessTierSettings.xml file you copied in the first step and copy it to the new CAREWare Business Tier folder, replacing the existing one. The default directory for the CW6 business tier is C:\Program Files\CAREWare Business Tier.

Start the CAREWare Business Tier

Here are instructions for starting the business tier service.

In the Windows Services application, find CAREWare Business Tier, right click on the service and click Start. Give it about a minute and refresh the service list to make sure it is still running. Test the connection to the database by following the instructions here.

Start the CAREWare HTTP Server

In the Windows Services application, find CAREWare HTTP Server, right click on the service and click Start. Give it about a minute and refresh the service list to make sure it is still running. Check the end of the log file, located at C:\Program Files\CAREWare HTTP Server\cwhttp\logs by default, for any errors and troubleshoot if necessary.

To download these instructions click here.

Back to CAREWare 6