1
2
Table of Contents
Installation Instructions ………………………………………………….. 3
Before you Begin ………………………………………………………….. 3
Installing .Net
………………………………………………………….. 4
Installing in a Peer-to-Peer Environment
Workstation with database
Additional workstations
………………………………………….. 5
…………………………………………. 10
Installing in a Client-Server Environment
Server
Workstations
………………………….. 5
…………………………. 12
…………………………………………………………. 12
…………………………………………………………. 17
Upgrading from the Desktop Edition of VHI PC-Kits ……………..... 20
Installing in a Terminal Server Environment …………………………. 22
Understanding VHI PC-Kits Server Components
Advanced SQL Topics
…………………. 23
…………………………………………………. 25
Manually configuring the VHI PC-Kits SQL Database .………………. 25
Using Windows Authentication with SQL
…………………………. 25
Backing up the SQL Database …………………………………………. 25
Moving the pckits SQL database from one server to another …….. 27
Moving the VHI PC-Kits License Server ………………………………. 28
Configuring Firewalls
…………………………………………………. 29
3
Installation Instructions
VHI PC-Kits: Version 4, Network Edition
Before you Begin
The first step to installing VHI PC-Kits Network Edition, is determining which type of
networking environment you have. If your office has only workstation machines and no
server machine, then you have what’s called a peer-to-peer networking environment. If
on the other hand, you have a server machine in addition to workstations, then you have a
client-server environment. The installation instructions for each of these environments
are detailed in this document. Follow the appropriate instructions for your environment.
NOTE: It is recommended that you exit from all currently running software before
installing VHI PC-Kits. This includes any Microsoft Internet Explorer windows that you
have open and any virus protection software you’re using.
If you are upgrading a workstation from the Desktop edition of VHI PC-Kits, see the section
titled, “Upgrading from the Desktop Edition of VHI PC-Kits” before beginning your
installation.
After installing, VHI PC-Kits will need to be activated. Activation can be done via
telephone during support hours or via the Internet 24 hours a day. Only the machine with
the licensing service installed will need to be activated.
Please note that in order to install and use VHI PC-Kits Network Edition on your network,
you must be running the TCP/IP network protocol on the workstations and server.
For further assistance, you may call VHI PC-Kits Product Support at 1-800-356-0709
during support hours or email us at support@vhikits.com.
NOTE: If you are using a Terminal Server/Citrix environment, please read the section
titled, “Installing in a Terminal Server Environment”.
If you downloaded a .ZIP file from VHI instead of receiving a DVD, be sure to extract all
the files out of the ZIP before installing. Right click the downloaded file and choose
Extract All (depending on the software installed on your PC you may need to open the
file first and then choose Extract). Do not extract to your Desktop unless you specify a
new folder. When instructed by this document to run setup from your DVD, you will
instead open the extracted folder and run Setup from there.
4
Installing .Net
VHI PC-Kits
requires that .Net 4.0 or later be installed on your computer. If setup detects
that .Net is not installed, you will see this screen:
If you choose Cancel, thenn setup will stop. You will not be able to install VHI PC-Kits
PC
until
you have installed .Net 4.0 or later. If you click OK, this screen is displayed:
Check the “I have read and accept the license terms” and then click Install. Be patient as
the .Net install can take 15 to 30 minutes on some computers.
Once the install is finished, reboot your computer. Then start the VHI PC-Kits install again.
5
Installing in a Peer-to-Peer Environment
In a peer-to-peer environment, the VHI PC-Kits software is installed on your workstations.
One of these workstations is chosen to house your shared database files. To choose which
workstation should house your database files, consider the following criteria:






The workstation must be turned on while anyone in your office is using VHI
PC-Kits.
The workstation must be running Windows 7 SP1, Windows 8, Windows 8.1,
Windows 10, or Server 2008 SP2 or newer.
.Net 4.0 or later is required.
It is recommended that you have 1 GB of RAM and 6 GB free space on your
hard drive to install SQL 2014 Express.
It is recommended that this be on a machine that is backed up on a regular
basis, to protect your database from being lost in a system crash. See the
section titled “Backing up Your SQL Database”.
If your network is connected to the Internet, it is highly recommended that this
machine be behind a firewall for security reasons.
Workstation with database
Once you have chosen which workstation will be used to store your database files, place
the VHI PC-Kits Network Edition DVD in the DVD drive on that workstation. The setup
program should start automatically. If it does not, double click on the Computer icon on
your desktop or start menu (Windows 7) or open File Explorer and then click on This PC
(Windows 8 or 10). Find your DVD drive’s icon and right click it and select AutoPlay or
Install from the menu. Alternatively, open the DVD and double click Setup.exe or the
Setup that is labeled Application. If Windows asks you if you wish to allow the program,
click Yes or Allow. If Windows asks you for a password or says you need administrator
rights to install software, log into Windows as an Administrator user or, if you do not
have an Administrator account, contact your IT department to install the software for
you.
6
Figure 1. Install Screen
Choose Install or Remove PC
PC-Kits.. Read and follow the onscreen instructions. Be sure
to read the licensing agreement carefully. After accepting the licensing agreement, the
dialog in Figure 2 will be displayed. Since this is a peer
peer-to-peer
peer environment, you’ll
always choose Workstation from this dialog box.
Figure 2. Workstation or Server
The next dialog box will ask you how this workstation will be connecting to your shared
database. Since the database will be residing on this machine, choose the first option
Install a peer-to-peer
peer database on this workstation as shown in Figure 3.
7
Figure 3. Installing Shared Database
The next dialog box asks you to create a password for SQL.
Figure 4. Create a password for SQL
Be sure to record this password and keep it with your VHI PC-Kits serial numbers. This
password should only be needed when installing or uninstalling VHI PC-Kits or backing up
the database and then only if the user is not an administrator in SQL.
Next you are asked for your serial numbers.
8
Figure 5. Enter serial numbers
Note: The numbers shown in the picture are not valid numbers. They are an example only.
Enter the numbers that came with your VHI PC-Kits software. They should be on the inside
flap of the VHI PC-Kits box or in the email if you requested to download VHI PC-Kits.
You will have multiple serial numbers (at least two but possibly more). Type each serial
number into the 4 boxes. Once the serial number is typed correctly, the Add button will
be enabled. Click Add and then enter your next serial number. Repeat until all numbers
have been entered, then click Next.
The next dialog box will ask you where you want to install VHI PC-Kits on your hard drive.
Click Next to accept the default path.
The next dialog box displays all the components that are being installed including all the
kits you purchased. If you are missing any kits, use the Back button to return to the serial
number screen and add any numbers you might have missed. If all the components look
correct, click Next to start the file copy process. The following screens will show the
install progress. The install may appear to hang during certain operations, please be
patient and it will resume when ready. In particular, when SQL is installed, it may take
up to 30 minutes or more. Also, when the PDF converter is installed it sometimes will
take 10 minutes or more. When installation is complete, click Finish and your computer
will be rebooted.
After rebooting, you must activate VHI PC-Kits. Open the VHI PC-Kits License Manager by
double clicking the small VHI icon on the system tray (see Figure 6). If the icon is not
there, go to Start, All Programs, Visual Health Information, VHI PC-Kits, and open the
License Manager (for Windows 8 or 10 you can also Search for VHI or go to All Apps on
the Start menu).
9
Figure 6.. The VHI PC
PC-Kits License Manager Icon
In the License Manager, choose
hoose Activate from the File menu. Activation can be done via
the Internet 24 hours a day or via telephone during normal support hours.. After
activating,
ting, click the Stop button and then click the Start button to start the license service.
You should see the message ‘Service started successfully’ and also all your serial
numbers should be displayed.
Next, verify that VHI PC-Kits runs properly on the pr
primary
imary workstation by double clicking
the VHI icon on the desktop.
If using a firewall on the primary workstation, read the “Configuring Firewalls”
section of this document before continuing
continuing.
10
Additional workstations
Now you can install VHI PC-Kits on any other machine on which you want to use the
software. These additional workstations have the following relaxed hardware
requirements:





The workstation must be running Windows 7, Windows 8, Windows 8.1,
Windows 10, Windows Server 2008 SP2 or newer.
The workstation must have between 50 MB and 900 MB free hard drive space
(depending on how many kits you’ve purchased).
.Net 4.0 or later is required.
The workstation must be connected to the same network as the workstation with
the database. If you install VHI PC-Kits on a laptop or tablet, you will not be able to
use the program if you are not connected to the network. For example, if you
wanted to take your laptop home and use the program, you would first have to
create a VPN connection to your network before you can use VHI PC-Kits.
Since the shared database does not reside on these additional workstations,
backing them up is not necessary to protect your VHI PC-Kits data from a system
crash.
To install an additional workstation, place the VHI PC-Kits DVD into the DVD drive. The
setup program should start automatically. If it does not, double click on the Computer
icon on your desktop or start menu (Windows 7) or open File Explorer and then click on
This PC (Windows 8 or 10). Find your DVD drive’s icon and right click it and select
AutoPlay or Install from the menu. Alternatively, open the DVD and double click
Setup.exe or the Setup that is labeled Application.
When presented with the dialog box shown in Figure 2, choose Workstation. When
presented with the dialog in Figure 3, choose the second option Connect to a database on
another workstation.
You will then be asked to tell VHI PC-Kits the network name or IP address of the
workstation containing your database (as shown in Figure 7). If you don’t know the
name of that machine, go back to that workstation and Right click on the Computer icon
on the desktop or start menu (Windows 7) or open File Explorer and then Right click on
This PC (Windows 8 or 10). Choose Properties and look for the computer name.
11
Figure 7.. Pointing VHI PC
PC-Kits to your Shared Database
NOTE: Using the “Search” button to search for the shared database can be a time
consuming operation depending on various ne
network
twork configuration issues. It is
i much
quicker to just type in the machine’s network name.
Read and follow the remaining
maining onscreen instructions. Click Finish when done and your
computer will be rebooted.
After verifying that the newly installed workstation runs properly, you can proceed to
install VHI PC-Kits on your remaining workstations. You can install VHI PC-Kits
Kits on as many
workstations as you want. The licenses you purchased only limit how many of those
workstations can be running the program simultaneously. You will not be required to
activate these additional workstations.
12
Installing in a Client-Server Environment
Installation in a client-server environment involves first installing the software to your
server machine(s) and then installing as many workstations as needed. There are many
options available to you in a client-server installation. For example:

You may install the License Server on any machine on your network, as long as
that machine is running while people are using VHI PC-Kits.

You may install the database to an existing Microsoft SQL Server on your
network or let VHI PC-Kits install a new instance of SQL 2014 Express.

You may install the client on a Citrix or Terminal server or you can install it on
each workstation.
The following instructions outline the simplest client-server installation. In this example,
a single server contains the SQL database and License Server. The VHI PC-Kits client
software is installed on every workstation. The workstations connect to the server only to
validate their license and access the shared database.
In this configuration, the server machine must meet the following requirements:





The server must be running Windows Server 2008 SP2, Windows Server 2008 R2
SP1, Windows Server 2012, Windows Server 2012 R2, Windows 7 SP1,
Windows 8, Windows 8.1, Windows 10.
It is recommended that you have 1 GB of RAM and 6 GB free space on your hard
drive to install SQL 2014 Express.
.Net 4.0 or later is required.
It is recommended that this machine be backed up on a regular basis, to protect
your database from being lost in a system crash. See the section titled “Backing
up Your SQL Database”.
If your network is connected to the Internet, it is highly recommended that this
machine be behind a firewall for security reasons.
Server
To install VHI PC-Kits to your server machine, place the VHI PC-Kits DVD into its DVD
drive. The setup program should start automatically. If it does not, open the DVD and
double click Setup.exe or the Setup that is labeled Application.
13
Figure 8. Install Screen
Choose Install or Remove PC
PC-Kits.. Read and follow the onscreen instructions. Be sure
to read the licensing agreement carefully. After accepting the licensing agreement, the
dialog shown in Figure 9 will be displayed. Since we’re installing to the server, choose
Server in this dialog.
Figure 9. Workstation or Server
After choosing to install the server software, you’ll be asked which of the server
components you wish to install to this machine. Database and Licensing are selected as
the default configuration. This will put the sshared
hared database on this server as well as the
license service. See Figure 10
10.
14
Figure 10
10. Default Server Installation Options
Next, you will be asked if you want to use an Existing instance of SQL or if you want
setup to install a New instance of SQ
SQL 2014 Express. If you choose Existing Server, then
you must already have an instance of SQL 2005 or later installed on this server.
Figure 11. New or Existing SQL Server
If you choose the New Server option, setup will install SQL 2014 Express with an
instance name of “VHI_PCKITS
VHI_PCKITS” unless you choose to change the name.
A SQL server may have multiple instances of SQL installed so if you choose the Existing
Server option, you are presented with the foll
following dialog box which allows you to
choose the instance of SQL that you want to use.
15
Figure 12. Select SQL instance
If you see the instance you wish to use, click on it to highlight it. If you don’t see the
instance but you know the name, you can click Specify Instance and then type the full
name of the instance. Click Default Instance if you wish to use an instance of SQL that
was installed without a specific name. When you click Next,, setup will verify that it can
connect to the instance you selected. If it can’t connect, you can use the Back button to
either select a different instance, or Back again to choose New Ins
Instance,
tance, or Back again to
unselect Database Server and then manually configure the SQL database.
After the SQL dialogs, you will come to the Serial Number dialog box.
Figure 13. Enter serial numbers
Note: The numbers shown in the picture are not valid numbers. They are an example only.
Enter the numbers that came with your VHI PC-Kits software. They should be on the inside
flap of the VHI PC-Kits box or in the email if you requested to download VHI PC-Kits
Kits.
16
You will have multiple serial numbers (at least two but possibly more). Type each serial
number into the 4 boxes. Once the serial number is typed correctly, the Add button will
be enabled, click Add. Enter your next serial number and click Add again.. Repeat
Repea until all
numbers have been entered, then click Next.
The next screen will ask you where you want to install VHI PC-Kits on your hard drive.
Click Next to accept the default path, or edit the path if you prefer not to install to the
primary drive. Only the VHI PC
PC-Kits files will be installed to this location. If SQL is also
being installed it will go to the default drive. To change w
where
ere SQL is installed, cancel
setup and install SQL separately.
The next screen displays all the components that are being installed including all the kits
you purchased. If you are missing any kits, use the Back button to return to the serial
number screen and add any numbers you might have missed. If all the components look
correct, click Next to start the file copy process
process.. The following screens will show the
install progress. The install may appear to hang during certain operations, please be
patient and it will resume when ready. In particular, when SQL is installed, it may take
up to 30 minutes or more. Also, when the PD
PDF
F converter is installed it sometimes will
take 10 minutes or more. When installation is complete, you may choose the option No, I
will restart my computer later if you do not wish to reboot your server.
Next, you must activate VHI PC
PC-Kits. Open the VHI PC-Kits License Manager by double
clicking the small VHI icon on the system tray (see Figure 14).
). If the icon is not there, go
to Start, All Programs, Visual Health Information, VHI PC
PC-Kits,
Kits, and open the License
Manager (for Server 2012 you can also Search for VHI or go to All Apps).
Figure 14.. The VHI PC
PC-Kits License Manager Icon
In the License Manager, choose Activate from the File menu. Activation can be done via
the Internet 24 hours a day or via telephone during normal support hours. If VHI PC-Kits
fails to activate over the internet, you can allow activate.vhikits.com through your proxy
server or firewall. After activating, cl
click the Stop button (only if you rebooted) and then
click the Start button to start the license service. You should see the message ‘Service
started successfully’ and also all your serial numbers should be displayed.
NOTE: You must activate VHI PC
PC-Kits and
nd start the license service before proceeding
to install the client workstations.
17
If using a firewall on the server, read the 'Configuring Firewalls' section of this
document.
Workstations
Now you’re ready to install VHI PC
PC-Kits to your workstations. To install VHI PC-Kits
PC
to a
workstation, place the VHI PC
PC-Kits DVD into the DVD drive. The setup program should
start automatically. If it does not, open the DVD and double click Setup.ex
Setup.exee or the Setup
that is labeled Application.
The system requirements for client
client-server
server environment workstations are as follows:



The workstation must be running Windows 7, Windows 8, Windows 8.1,
Windows 10, Windows Server 2008 SP2 or newer.
.Net 4.0 or later is required.
The workstation must ha
have between 50 MB and 900 MB of free hard drive space
(depending on how many kits you’ve purchased).
When presented with the dialog shown in Figure 9, choose Workstation.. You will then
be asked for the workstation type. Choose Connect to a database on a database server,
server
as shown in Figure 15.
Figure 15
15. Installing a Client-Server Workstation
The VHI PC-Kits setup program will then ask you whether you want to run the program
using files installed on the server ((Run from Server)) or if you want to install the program
files on the local workstation. In this example, we did not install the application files on
18
the server (See Figure 10).
). Therefore, you must choose Local Installation.. See Figure
16.
NOTE: If you choose “Run from
m Server” and have checked “Application” in the dialog in Figure 10, no
program files will be installed on the workstation. However, certain system components may still be
upgraded so that the workstation can run VHI PC
PC-Kits. Also, a PDF printer driver is installed.
Figure 16
16. Choosing to Install Program Locally
Next, the VHI PC-Kits setup program will ask you for the location of your License Server
(see Figure 17).
). In this example, this is the server machine we previously installed. You
can supply the network name, DNS name or IP address of the machine. Click Next. If
setup fails to detect the License Server, verify you entered the correct server, read the
section on firewalls, or go back to the License Server machine and verify the service is
running and that licenses are available
available.
Figure 17
17. Specifying the License Server Location
19
NOTE: Using the “Search” button to search for the License Server can be a time
consuming operation depending on various network configuration issues. It is usually
much quicker to just type in the machine’s network name.
Read and follow the remaining onscreen instructions. Click Finish when done and your
computer will be rebooted.
After verifying that the newly installed workstation runs properly, you can proceed to
install VHI PC-Kits on your remaining workstations. You can install VHI PC-Kits on as many
workstations as you want. The licenses you purchased only limit how many of those
workstations can be running the program simultaneously. You will not be required to
activate these additional workstations.
20
Upgrading from the Desktop Edition of VHI PC-Kits
You must first uninstall the Desktop edition of VHI PC-Kits before you can load the
network edition. VHI recommends that you backup your current data files before
uninstalling. Then proceed with the Workstation install as detailed above.
By default, the data files are located in:
C:\Program Files\Visual Health Information\VHI PC-Kits\Data
on a 32 bit machine,
C:\Program Files (x86)\Visual Health Information\VHI PC-Kits\Data
on a 64 bit machine,
or C:\Vhi\Data for very old versions.
After completing your workstation installs, you may want to import your data from the
Desktop edition into your shared network database. In order to import, the Desktop
edition Data folder must be located in the same folder as the Network edition vhi.exe.
You must sign into VHI PC-Kits as the Administrator user in order to import data.
For local workstation installs, your Desktop edition data files will probably be in the
correct location and the first time you open VHI PC-Kits you will be asked to import the
data. If you are not asked to import, then be sure to copy the Desktop edition Data folder
into the same folder as the vhi.exe (C:\Program Files (x86)\Visual Health
Information\VHI PC-Kits\Data).
If your Network edition workstation is running from a terminal server or application
server, you must first copy your local VHI PC-Kits Data directory to the folder on the server
where the VHI PC-Kits client vhi.exe is located before you can import it.
If you are not prompted to import the data when VHI PC-Kits is opened, go to the File
menu and choose Import Database as shown in Figure 18.
21
Figure 18. Importing a Desktop edition Database
There is a Test Import button on the Import Dialog, click it to verify that your Desktop
data is error free. You will see a report of what data can be imported. If there are any
errors, you can either, do the import and lose the data that can’t be imported, or you can
call VHI Support to see if anything can be done to complete the import without errors.
The most common import problem is a missing kit. If you had a kit in the Desktop edition
and that kit is not installed in the Network edition, then any data pertaining to that kit will
not import.
There is also a Merge data option on the Import Dialog. If you select this option, VHI PCKits will try to merge data that belongs to the same user or patient. For example, if both
databases have a user named John Smith, then the data will be merged under a single
user. The names must match exactly. If one user is John Smith and the other user is John
Smith PT, they will not be merged. You can transfer the data from one user to another
later in VHI PC-Kits.
22
Installing in a Terminal Server Environment
VHI PC-Kits Network Edition
has been designed to operate properly when running on Citrix
or Terminal Server. However, running VHI PC-Kits on a Citrix server is not actually tested
here at VHI. We do our best to design it for proper operation but we do not own a copy of
Citrix to test with. All our knowledge of VHI PC-Kits on Citrix comes from our customers.
Some things to consider in a Citrix or Terminal Server environment are,



If you have a Terminal server(s) and a separate database server, then the
recommended installation is to install the license and database components on the
database server. Then install the workstation components on the Terminal
server(s). That is, as far as VHI PC-Kits is concerned, the Terminal server is a VHI
PC-Kits workstation with the VHI PC-Kits server components residing on the
database server.
If you want to completely install the product on the Terminal server, choose
Server from the Workstation or Server dialog and install all the server
components (Licensing, Application and Database). When asked if you also want
to run the client on the machine, click Yes.
If you have multiple Terminal servers, and you don’t have a separate database
server, choose one of the Terminal servers to house the VHI PC-Kits database and
license server. Install all of the server components on that machine. Then install
the other Terminal servers as workstations. This primary Terminal server cannot
be load balanced with the other Terminal servers.
23
Understanding VHI PC-Kits Server Components
VHI PC-Kits
has three server components. These components can be installed to a single
server or spread over multiple servers.


Database Server – This component attaches an empty SQL Server database
(pckits.mdf) to SQL. You can either install the database to an existing instance of
SQL 2005 or later, or you can have setup install a new instance of SQL 2014
Express. The default name of the new instance is VHI_PCKITS. VHI PC-Kits can
be configured to use multiple SQL databases if desired. Contact technical support
for more information.
License Server – This component installs the license server which is run as a
service. It is the job of this component to serve up licensing and configuration
information to the workstations. All database settings and security settings are
configured on this server by using the VHI PC-Kits license manager. VHI PC-Kits
serial numbers are installed or removed by running setup.
This component uses WinSock over TCP/IP using port 52369. You may need to
configure firewalls or proxy servers to allow this port to be exposed to networks
requiring access to the licensing server. It is possible to reconfigure which port
VHI PC-Kits uses, if necessary. Contact technical support for more information.

Application Server – By installing the client files to a share on the server, you
create a single point of upgrade/administration for all of your VHI PC-Kits
workstations. Future installs of additional kits or minor upgrades can be done on
the server without installing on each workstation. However, major upgrades may
require setup to be run on the workstations also.
VHI strongly recommends that you run our setup on each workstation for the
initial install even if using an application server. Just creating a shortcut to the file
share will not allow you to run the client. This will insure that all system
components meet the minimum requirements. We also install a PDF printer driver
and create a registry key that tells the client where the license server is.
Starting with version 3.4 it is possible to not install the client. Instead, manually
create a shortcut to the application server. A command line parameter must be
added to specify the license server. The shortcut would be
\\appservername\pckits_app\vhi.exe -s licenseservername:52369 (52369 is the
TCP port used by the license server). However, this method does not install other
components that are required by the VHI PC-Kits client. If these components are not
already present on your workstations you will have to manually install them
before you can use VHI PC-Kits. Most of the required components can be installed
24
by downloading “Microsoft Visual C++ 2010 x86 Redistributable (SP1)”. You
can also install our PDF driver which is needed if you want to use our Email or
Export as PDF functions. Run InstallAmyuni.exe from our DVD or download to
install the PDF printer. A shortcut only install also does not create our registry
key on the client with the proper permissions where some of the user program
preferences are stored.
When you install the Application server component, a share called ‘pckits_app’
will be automatically created allowing full control to everyone. You can change
the security on this share as required and can even change its name. If you
change its name, you’ll have to enter a UNC path to it during workstation
installation when asked where you’re application server is located. Such a path
would be of the form \\server\share (minimally) and could also contain subdirectories if needed.
25
Advanced SQL Topics
VHI PC-Kits
uses OLEDB to communicate with its SQL database. It is not necessary to
create an ODBC connection.
Manually configuring the VHI PC-Kits SQL database
If you already have a SQL server and you do not want to run the VHI PC-Kits setup
program on your server, you can manually configure the database. You can also use these
instructions if you run setup and it will not detect/connect to your existing SQL server.
Do not select the database option during the VHI PC-Kits install. Instead, extract the empty
pckits.mdf database from MSDESe~1.cab located on our DVD or download and
manually attach it to SQL using SQL Management Studio. Then setup the database
logins. Here is the default database info: Database = pckits, Login = pckits_login,
Password = pckits_password, User Mapping = pckits_user, SQL script for updating the
version of the pckits database = migrate.sql.
The database name, login name, and password can all be customized if you want. Just be
sure to enter your custom values into the Database Settings in the VHI PC-Kits license
manager.
Using Windows Authentication with SQL
By default, VHI PC-Kits is configured to access the SQL server using SQL authentication.
Clients access this database using the ‘pckits_login’ SQL login. If you prefer to use
Windows Authentication in SQL, you can instruct VHI PC-Kits to use Windows
Authentication instead.
Add your Active Directory users/groups to SQL and give them access to the pckits
database. The VHI PC-Kits database contains a user role called, ‘pckits_user’ for this
purpose. In the Properties of the Active Directory users you have created in SQL, click
User Mapping. Select the pckits database and then select pckits_user.
Open the VHI PC-Kits license manager. Go to the File menu and choose Configure Client
Settings. On the Database tab, change the Authentication method to Windows.
Backing up the SQL Database
Backing up a SQL database is different than backing up files on your hard drive. Since
SQL runs as a service, the data files are usually open all the time and the files cannot be
copied. Instead, you can issue a command to SQL to dump the database to a text file that
can then be backed up normally. There are several ways to accomplish this:
26
In the PC-Kits peer-to-peer setup, you can open VHI PC-Kits on the primary workstation
that contains the database and sign in as the Administrator user. Go to the file menu and
choose Backup Database. Since this is a manual backup, you would need to remember to
do it every day or once a week or as often as you feel it is needed. To automate the
backup process, you can enter the following command into a batch file and then schedule
it to run in Task Manager:
Sqlcmd –E –S YourServerName\VHI_PCKITS -Q"backup database pckits to
disk='c:\path\pckits.bak' with init"
If you have backup software for your computer already, check to see if it is capable of
backing up a SQL database. If it is, you can tell it to backup the pckits database. If it is
not SQL compatible, then run the above command prior to running your backup software.
If you are not using SQL Express that came with PC-Kits (you already have a purchased
version of SQL) then you can schedule backups using SQL Management Studio.
27
Moving the pckits SQL database from one server to another
To move the database, backup the pckits database using SQL Management Studio. Copy
the backup to the new SQL server. Restore the backup using SQL Management Studio.
Setup the database login as described above. Open the VHI PC-Kits license manager. Go to
the File menu and choose Configure Client Settings. On the Database tab, change Source
to the name of the new SQL server. If using a named instance of SQL, use
ServerName\InstanceName. If you are also upgrading VHI PC-Kits to a new version,
upgrade the database by opening the file ‘migrate.sql’ (from our DVD or download) in
SQL Management Studio and then execute it. There is a copy of the SQL Management
Studio installer on our DVD (but not included in our download) or you can download it
from Microsoft.
Version 3 of VHI PC-Kits used MSDE 2000 (SQL 2000) by default. If you are moving the
pckits database from SQL 2000, be aware that you can only move it to a server that is
running SQL 2005 or 2008. Then you can take another backup and move it to SQL 2012
or 2014 if you wish. If you don’t currently have SQL 2005 or 2008 installed, you can
download it from Microsoft. We also have a copy of SQL 2005 on our DVD.
28
Moving the VHI PC-Kits License Server
Before moving the VHI PC-Kits License Server, you should record all the program
settings. Open the license manager. Take a screen shot of all the serial numbers. Go to the
File menu and choose Configure Client Settings. Take a screen shot of the Database,
Security, and Patient tabs.
Since the serial numbers are registered to this server, contact VHI at (800)356-0709 or
support@vhikits.com and ask us to release your serial numbers. Releasing the serial
numbers does not affect the current server until the numbers have been installed and
activated on the new server. Even then, the current server will continue to function until
the next time it is rebooted. So you can have both servers running during the transition.
Once the new server is up and running, you will have to point all your workstations (or
terminal servers) to the new license server. You can either, run setup on each workstation
and choose the Modify option, or you can edit these registry keys on the workstation:
On a 32 bit machine
HKEY_LOCAL_MACHINE\SOFTWARE\Visual Health Information\VHI PCKits\Retail\Settings\Licensing
"Server"=
or on a 64 bit machine
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Visual Health Information\VHI PCKits\Retail\Settings\Licensing
"Server"=
29
Configuring Firewalls
If you are using a firewall on your main PC in a peer-to-peer setup or on the License and
Database servers in the client-server setup, then you need to allow exceptions so VHI PCKits can communicate with the workstations.
Open your firewall settings and make exceptions for the VHI PC-Kits license server:
vhilsvr.exe or TCP port 52369 and the SQL database server: sqlservr.exe or TCP port
1433. If you have multiple instances of SQL on the same server and they are using
dynamic ports, it is best to allow sqlservr.exe as each copy of SQL will have a random
port assigned. You can try adding UDP port 1434 for the SQL browser service but that
does not always work.
These exceptions only need to be made on the server machines. You should not need to
make any changes to firewalls on the workstations. Since there are many firewall
programs, consult your firewall documentation on how to make an exception.