- 1 - C-MagSys and Q-MagSys Components Installation Guide (20

C-MagSys and Q-MagSys Components Installation Guide (20 January 2010)
C-MagSys and Q-MagSys Components Overview at Clinic
The following are files used for this installation:
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
CMagSysSetup.exe
QMagSysSetup.exe
FlashPlayer10.exe
MySqlConnectorODBC351.msi
MySqlSetup.exe
SQLyog525.exe (or newer version)
CMagSysBckp.sql
RockeyOCX.exe & msi
Rockey Windows Drivers (32 bit/64 bit)
.NET Framework 2.0 (dotnetfx.exe)
TeamViewerQS.exe
Installation is performed on three type of PC/Laptop
1.
2.
3.
C-MagSys server PC (PC that is used to host the database. Only one PC per branch)
C-MagSys client PC (PC used as client for C-MagSys. Can be more than one PC)
Q-MagSys PC (PC used to host queue management system. Only one PC per branch)
-1-
Pre-requisites for Installation
1. Network (LAN) between PCs is ready.
2. Check if the Windows is a 32-bit version. If 64-bit, please contact me.
Installation steps for C-MagSys server PC:
1. Install MySQL database - MySqlSetup.exe (if 64 bit, use the 64 bit version)
2. Add port for MySQL
3. Install SQLyog - SQLyog525.exe
4. Import C-MagSys Database - CMagSysBckp.sql
5. Install ODBC for MySQL - MySqlConnectorODBC351.msi
6. Configure the MySQL ODBC
7. Install C-MagSys - CMagSysSetup.exe
8. Configure clinic parameters.
9. Copy TeamViewerQS.exe to desktop
Installation steps for C-MagSys client PC:
1. Install ODBC for MySQL - MySqlConnectorODBC351.msi
2. Configure the MySQL ODBC
3. Install C-MagSys - CMagSysSetup.exe
4. Copy TeamViewerQS.exe to desktop
Installation steps for Q-MagSys PC:
1. Install ODBC for MySQL - MySqlConnectorODBC351.msi
2. Configure the MySQL ODBC
3. Install QMagSysQMS - QMagSysSetup.exe
4. Copy TeamViewerQS.exe to desktop
Additional Installation
1. If PC is attached with MyKad Reader (or just install in all PC, so that the users can use any PC to read
the MyKad later).
a. Install RockeyOCX.exe – double click the file and follow instructions.
b. Install Rockey Windows Driver. Choose the 32 bit or 64 bit driver depending on the Windows
version installed. Double click the file and follow instructions.
c. This Rockey OCX requires at least .NET 2.0 framework pre-installed. If it is not installed, use
dotnetfx.exe to install this framework. Double click the file and follow instructions.
d. Note 1: Please install the reader driver first before you connect the MyKad Reader. If any
problem, disconnect the MyKad Reader, un-install the driver (use Start > All Program >
Rockey200 Driver > Uninstall), reboot the PC, install the driver again and then connect back the
MyKad Reader.
e. Note 2: This reader is only for MyKad (not for MyKid or any other smart card).
IMPORTANT:
1. Please check if the PC is installed with firewall program that sometime require the user to
explicitly tell the firewall program to allow access for any application to access the network, etc.
2. Please use user with “ADMINISTRATOR” rights to perform this installation
3. If the doctor request to delete all the existing drug records, login as “admin” into C-MagSys and
open “Administration” > “Drugs”. There will be a button “Delete All Drugs” to delete all drug
records.
Note: Print this page as your checklist during the installation
-2-
MySQL Installation
Note 1: If Windows Vista, please disable the UAC first before performing MySQL installation. Refer to the
last section of “Add Port for MySQL” for steps of doing this (page 13).
Note 2: Please check the version of the Windows, if 64 bit Windows, please use 64 bit version of MySql
installation file.
1.
Double-click MySqlSetup.exe to start MySql installation. You will be guided by a wizard to
perform this entire process. Choose the setting as shown in the following screens.
2.
Click “Next”
-3-
3.
Click “Next”
4.
Click “Next”
-4-
5.
Installation is in progress.
6.
Click “Next” – skip the Sign-up process
-5-
7.
Click “Finish”
8.
Click “Next” – continue to configure the MySQL service
-6-
9.
Choose “Detailed Configuration” and click “Next”
10.
Choose “Server Machine” and click “Next”
-7-
11.
Click “Next”
12.
Installation path – you may also choose other drive to install MySQL. Click “Next” to proceed.
-8-
13.
Click “Next”
14.
Click “Next”– let the port number to be 3306.
-9-
15.
Click “Next”
16.
Click “Next”
- 10 -
17.
Enter password and re-confirm. Make sure you write down this password for ODBC
configuration later on. Click “Next” to proceed.
18.
Finalizing the installation.
19.
Complete.
- 11 -
Add Port for MySQL
Microsoft Windows XP and later include a firewall which specifically blocks ports. If you plan on using
MySQL through a network port then you should open and create an exception for this port before
performing the installation. To check and if necessary add an exception to the firewall settings:
1.
2.
First ensure that you are logged in as an Administrator or a user with Administrator privileges.
Go to the Control Panel, and double click the Windows Firewall icon.
3.
4.
Choose the Allow a program through Windows Firewall option and click the Add port button.
Enter MySQL into the Name text box and 3306 (or the port of your choice) into the Port number
text box.
- 12 -
5.
6.
7.
Also ensure that the TCP protocol radio button is selected.
If you wish, you can also limit access to the MySQL server by choosing the Change scope button.
Confirm your choices by clicking the OK button.
Additionally, when running the MySQL Installation Wizard on Windows Vista, ensure that you are logged
in as a user with administrative rights.
Note
When using Windows Vista, you may want to disable User Account Control (UAC) before performing the
installation. If you do not do so, then MySQL may be identified as a security risk, which will mean that you
need to enable MySQL. You can disable the security checking by following these instructions:
1.
2.
3.
4.
5.
Open Control Panel.
Under the User Accounts and Family Safety, select Add or remove user accounts.
Click on the Got to the main User Accounts page link.
Click on Turn User Account Control on or off. You may be prompted to provide permission to
change this setting. Click Continue .
Deselect or uncheck the checkbox next to Use User Account Control (UAC) to help protect your
computer. Click OK to save the setting.
You will need to restart to complete the process. Click Restart Now to reboot the machine and apply the
changes. You can then follow the instructions below for installing Windows.
- 13 -
Install ODBC Connector
1. Double-click on the MySqlConnectorODBC351.msi to start the installation wizard. Follow the
instructions given in order to complete this process.
2.
Click “Next” to proceed.
3.
Click “Next” to proceed
- 14 -
4.
Click “Next” to proceed
5.
Click “Next” to proceed
- 15 -
6.
Click “Finish”
- 16 -
Configure the ODBC for MySQL (32 bit Windows)
1.
Go to Windows Administrative Tools and open ODBC Datasource Administrator wizard
2.
Click “Add” to open a new screen
3.
Select MySQL ODBC 3.51 Driver (you must perform this connector installation first – step 4 in CMagSys installation)
4.
Provide all details for cmagsys database connection. You can change the “Server”, “User” and
“Password” accordingly. But use “cmagsys” for “Data Source Name”.
- 17 -
“Server” can also take up the name of the PC/Server or just put “localhost” for the same pc
where you install the MySql database (server pc).
If the server is a remote pc, then the value should be the server/pc name, i.e. “ServerPC”. Do not
use IP address to replace the PC name as it might dynamically change on next PC logon.
You may perform “ping” test to this location to make sure network is ok.
Enter “root” for the “User” field. For the “Password” field enter the password you set during the
MySql database setup.
5.
6.
Click “Test” to test the connection.
Click “Ok” to complete.
- 18 -
Configure the ODBC for MySQL (64 bit Windows)
1.
2.
3.
4.
Open C:\Windows\System32 folder (or any Windows installation folder)
Find and double-click the Odbcad32.exe.
The same ODBC Data Source administrator window will appear.
Configure the data source as above instructions.
Install SQLyog
1.
Double-click the SQLyog525.exe (or any new SQLyog installation package) to start the installation
wizard. Follow the wizard instructions to complete the installation.
2.
Click “Next”.
- 19 -
3.
License agreement. Click “Next” to proceeed.
4.
Click “Next”.
- 20 -
5.
Default installation path. You may choose other folder if you wish to.
6.
Installation is in progress.
- 21 -
7.
Installation completed.
- 22 -
Import C-MagSys Database Backup
1.
Start SQLyog application. Use Start menu or desktop shortcut to launch the SQLyog.
2.
Enter the pc server details and the password you set during MySQL installation. Click “Connect”
to proceed.
3.
From the menu bar at the top, click “DB” and choose “Restore from SQL Dump” (menu caption
may vary due to different version of SQLyog).
Browse to locate the “CMagSysBckp.sql” file which contains the dump file for initial database
setup for C-MagSys application. Click “Execute” to proceed.
4.
- 23 -
5.
Once completed, click “Close”.
- 24 -
C-MagSys Installation
1.
Double-click CMagSysSetup.exe to start the installation wizard.
2.
Enter password for the installation and click “Next”.
- 25 -
3.
Click “Next”.
4.
License agreement. Please read and click “Yes” if you agree to install.
- 26 -
5.
System information. Click “Next” to proceed.
6.
Customer information. Enter the serial number and click “Next”.
- 27 -
7.
Installation folder. You may choose other folder if required.
8.
Program folder at Start Menu.
- 28 -
9.
Installation is in progress.
10. Installation completed.
- 29 -
11. Configure the CMagSys.ini
i.
Open file CMagSys.ini in the ”Data” folder of CMagSys installation folder.
ii.
String “MYKAD_READER”: value is “Y” if MyKad reader is attached or “N” if not attached
at this PC.
iii.
String “QUE_ACTIVE”: value is “Y” if Q-MagSys is installed at this clinic or “N” if not
installed.
iv.
String “QMGMT_PATH”: value is the shared folder of the Q-MagSys installation folder.
Example: “\\qmspc\Q-MagSys\”. Make sure you include “\” at the end of the path
string. Ignore this setting if Q-MagSys is not installed.
v.
String “SVR_PATH”: value is the shared folder of the C-MagSys SERVER PC installation
folder. Example: “\\svrpc\C-MagSys\”. Make sure you include “\” at the end of the path
string. This server C-MagSys installation folder should be set as a shared folder earlier. If
the PC being configured is the server PC, put the value as the C-MagSys installation
folder, example: “C:\Program Files\C-MagSys\”.
vi.
String “WKS_ID”: value is an integer and should be unique for all PC used at the clinic.
Please put “1” for the server PC and the rest with other unique number, i.e. “2”,”3” and
so on. Failure to do this will result severe problem in C-MagSys application.
vii.
Save this file.
Note: Do not use IP address to replace the PC name as it might dynamically changed on next PC
logon.
12. Share the C-MagSys folder (only for server PC).
i.
Open Windows Explorer and browse to C-MagSys installation folder, i.e: C:\Program
Files\C-MagSys.
ii.
Right-click this folder and choose “Sharing and Security…”
iii.
Click the “Sharing” tab and check the “Share this folder on the network”. Give the
“Share name” as “CMagSys” (do not put “-“).
iv.
Tick the checkbox for “Allow network users to change my files”.
- 30 -
v.
C-MagSys installation is now complete.
- 31 -
Configure Clinic Parameters
1.
2.
3.
4.
5.
6.
Start C-MagSys application and login using “admin” user id. You can only use this id to enable you
to modify the fields in this screen.
Click on “Admin” menu.
Click on “Configuration” menu. The following screen will appear
Enter the clinic name and all the other fields details.
For the clinic id, enter the first two numbers with your agent code (get this from S-Core) and the
other four numbers with running number of the number of clinic you have installed with C-MagSys.
Example: Your agent code is “12”. This is the clinic number 20 you have installed with C-MagSys.
Then the clinic id should be “120020”.
Click “Update” to save this setting.
- 32 -
Q-MagSys Installation
1.
Double-click QMagSysSetup.exe to start the installation wizard.
2.
Enter the password for installation and click “Next”.
- 33 -
3.
Click “Next”.
4.
License agreement. Click “Yes” if you agree and proceed.
- 34 -
5.
Click “Next”.
6.
Enter the serial number and click “Next”.
- 35 -
7.
Installation location. You may choose other folder if required.
8.
Select “Typical” and click “Next”.
- 36 -
9.
Program folder. Click “Next”.
10. Installation complete.
- 37 -
11. Configure the QMagSys.ini
i.
Open file QMagSys.ini in the QMagSys installation folder.
ii.
Find this string: SVR_PATH WRITE YOUR SERVER PATH HERE
iii.
Replace the string “WRITE YOUR SERVER PATH HERE” to the location of C-MagSys server
PC folder. Example: “\\svrpc\cmagsys\”. Make sure you include “\” at the end of the
path string.
iv.
This server C-MagSys folder should be set as a shared folder earlier.
v.
Save this file.
Note: Do not use IP address to replace the PC name as it might dynamically changed on next PC
logon.
12. Share the Q-MagSys folder.
i.
Open Windows Explorer and browse to Q-MagSys installation folder, i.e: C:\Program
Files\Q-MagSys.
ii.
Right-click this folder and choose “Sharing and Security…”
iii.
Click the “Sharing” tab and check the “Share this folder on the network”. Give the
“Share name” as “QMagSys” (do not put “-“).
iv.
Check also the “Allow network users to change my files”.
v.
Note: This screen capture and the process explained is using Windows XP. Other version
of Windows the process and screen experience are slightly different.
13. Q-MagSys installation is now complete.
- 38 -