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. CMagSysSetup.exe 2. QMagSysSetup.exe 3. FlashPlayer10.exe 4. MySqlConnectorODBC351.msi 5. MySqlSetup.exe 6. SQLyog525.exe (or newer version) 7. CMagSysBckp.sql 8. RockeyOCX.exe & msi 9. Rockey Windows Drivers (32 bit/64 bit) 10..NET Framework 2.0 (dotnetfx.exe) 11. TeamViewerQS.exe Installation is performed on three type of PC/Laptop 1. C-MagSys server PC (PC that is used to host the database. Only one PC per branch) 2. C-MagSys client PC (PC used as client for C-MagSys. Can be more than one PC) 3. 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. First ensure that you are logged in as an Administrator or a user with Administrator privileges. 2. Go to the Control Panel, and double click the Windows Firewall icon. 3. Choose the Allow a program through Windows Firewall option and click the Add port button. 4. Enter MySQL into the Name text box and 3306 (or the port of your choice) into the Port number text box. - 12 -
5. Also ensure that the TCP protocol radio button is selected. 6. If you wish, you can also limit access to the MySQL server by choosing the Change scope button. 7. 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. Open Control Panel. 2. Under the User Accounts and Family Safety, select Add or remove user accounts. 3. Click on the Got to the main User Accounts page link. 4. Click on Turn User Account Control on or off. You may be prompted to provide permission to change this setting. Click Continue. 5. 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 C- MagSys 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. Click Test to test the connection. 6. Click Ok to complete. - 18 -
Configure the ODBC for MySQL (64 bit Windows) 1. Open C:\Windows\System32 folder (or any Windows installation folder) 2. Find and double-click the Odbcad32.exe. 3. The same ODBC Data Source administrator window will appear. 4. 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). 4. Browse to locate the CMagSysBckp.sql file which contains the dump file for initial database setup for C-MagSys application. Click Execute to proceed. - 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. 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. 2. Click on Admin menu. 3. Click on Configuration menu. The following screen will appear 4. Enter the clinic name and all the other fields details. 5. 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. 6. 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 -