cms3 installation guide(2)

The CMS3.0 is an open-source clinic management system project jointly implemented by the Hong Kong MedicalAssociation (HKMA) and the Information and software Industry Association (ISIA), with the funding support fromthe Office of the Government Chief Information Officer (OGCIO) under the Sector-specific Programme (SSP) for

the Medical and Health Sector, and was developed by the Mobigator Technology Group.

CMS3 Installation Guide

CMS3 Installation Guide2

© 2010 Mobigator Technology Group

Table of Contents

Part I Introduction 4

................................................................................................................................... 41 Requirement

Part II Get CMS 3.0 5

Part III CMS 3.0 Server Installation 6

................................................................................................................................... 61 Install CMS 3.0 Server

Part IV Configure CMS 3.0 Client after Installation 14

................................................................................................................................... 141 Login CMS 3 .0 Through HTTPS

................................................................................................................................... 192 Modify Clinic Setting

................................................................................................................................... 193 Create User

Part V CMS 3.0 Server Advanced Installation 22

................................................................................................................................... 221 Install Java

................................................................................................................................... 222 Install MySQL

................................................................................................................................... 223 Install CMS 3.0

................................................................................................................................... 244 Create Server Certificate

................................................................................................................................... 255 Configure CMS 3.0 Database

................................................................................................................................... 256 Use cronolog (Optional)

................................................................................................................................... 267 Use swap in Linux (Optional)

Part VI Update CMS 3.0 27

................................................................................................................................... 271 Update Installer

................................................................................................................................... 302 War File

Part VII Troubleshoot for Deployment 34

................................................................................................................................... 341 Install CMS 3.0 with MySQL Already Installed

................................................................................................................................... 342 Can't Startup MySQL Server

................................................................................................................................... 403 I can't connect to CMS 3.0

................................................................................................................................... 424 Configure CMS 3.0 Database

................................................................................................................................... 435 Login CMS 3 .0 Through HTTP

................................................................................................................................... 446 Get Host IP and Host Name

................................................................................................................................... 467 Set Host IP and Host Name

................................................................................................................................... 538 Open Command Prompt or Terminal

................................................................................................................................... 559 Shut down Tomcat

................................................................................................................................... 5810 Start up Tomcat

................................................................................................................................... 6211 Disable UAC

................................................................................................................................... 6312 Q & A

Part VIII Reference Link 65

3Contents

3




1 Introduction

This document contains the installation instructions for CMS 3.0

1.1 Requirement

Server:

# Recommended Environment Minimal Requirement

1 Intel Core 2 Xeon Processor 3.0GHz,

Intel Core 2 E7400 (2.8GHz), or equivalent

Pentium 4 2.4GHz or above

2 3GB of DDR2 800MHz RAM 1GB of Memory

3 SATA II 7.2K RPM 16MB Cache with 40GB free space 6GB of disk space

4 100Mbp Network Controller 100 Mbps Network Controller

5 Windows 2003 Server Standard / Linux Kernel 2.6 or above Windows XP Home

Client:

# Recommended Environment Minimal Requirement

1 Intel Core 2 Duo Processor E5200 (2.5GHz) or equivalent Pentium 4 2GHz or above

2 2GB of Memory 1GB of memory

3 SATA II 7.2K RPM 16MB Cache, 10GB free space 6GB of disk space

4 100Mbp Network Controller 100 Mbps Network Controller

5 Windows XP, Linux Kernel 2.6 or above Windows XP Home

6 19" LCD supporting 1280x1024 resolutionScreen support 1024x768resolution

Extra requirement for advanced installation

· Java JDK 6 or above· MySQL 5.0 or above· Tomcat 6.0 or above· Areca Backup 7.0.6 or above· Cronolog version 1.6 or above· 7-Zip 4.65 or above(Windows) / p7zip 4.65 or above(Linux)

Get CMS 3.0 5


2 Get CMS 3.0

The latest version can be downloaded from http://cms3.mobigator.com/

http://cms3.mobigator.com/



3 CMS 3.0 Server Installation

This part includes how to set up CMS 3.0 in your physical machine. It involves the installation guide forMySQL, Tomcat, etc.

3.1 Install CMS 3.0 Server

1. Enter http://cms3.mobigator.com/pages/index.asp?pg=user and download CMS 3.0 server package

2. Extract the zip file by 7-zip

Remark: You must use 7-zip to extract the files to avoid "File path too long" error whileusing other program to do.

3. Open CMS3For Vista or Windows 7 user, please use one of the following method to install CMS 3.0Method A: Right click on the CMS3.exe and select "Run as Administrator" Method B: Disable UAC

http://cms3.mobigator.com/pages/index.asp?pg=user

http://www.7-zip.org

CMS 3.0 Server Installation 7


4. Click Next

5. Click I Agree



6. Click NextNotes: If you have installed MySQL previously, please uncheck "Install MySQL 5.1"

7. Click Install



8. Click Accept

9. Click Next



10. Click Next

11. Click Finish



12. Click Next

13. Type in your information and Certificate password, then click Next



14. Create a root password for MySQL, then click Next

15. when you see this windows, press any key on your keyboard to continue



16. Type in the root password you have created, then click NextNotes: If you have installed MySQL previously, please select a correct MySQL Foldere.g. C:\Program Files\MySQL\MySQL Server 5.1

17. Click Finish

18. Restart your PC



4 Configure CMS 3.0 Client after Installation

This part includes how to configure CMS 3.0 Client

4.1 Login CMS 3 .0 Through HTTPS

1. Enter CMS 3.0 Client folder

2. Enter server ip or hostname in "Hostname". If you are using our host server, enter the port we have given to you in "Port" Otherwise, enter 443 in "Port"

Configure CMS 3.0 Client after Installation 15


3. Setup document printer, label printer and card printer. Click "Save" and restart CMS3.exe

4. Click "Cancel"



5. Select "Security Setting" in the bottom right menu

6. In the "Servers" tab, click "Add Exception"



7. Enter the hostname and port in "Location", click "Get Certificate"



8. Click "Confirm Security Exception"

9. Restart CMS3.exe



4.2 Modify Clinic Setting

1. Admin -> Clinic Setting

2. Double click on the pre-set clinic

3. Modify the setting and click update

4.3 Create User

We will provide a administrator account for you at the beginning. You need to use this account to loginCMS 3.0 and create other accounts.

1. Use the admin account to login CMS 3.0



2. Select "ADMIN" in the top menu bar

3. In the left menu, expand the "User" folder and select "User"

4. Click on "New" button to create a new user



5. Fill in the fields if necessary. Remember to check "Active" if you want to enable the account now.

6. Click "Create" button and complete the creation of user.



5 CMS 3.0 Server Advanced Installation

This part includes how to set up CMS 3.0 in your physical machine.

5.1 Install Java

Donwload Java (JDK Version):1. Enter http://www.java.com

2. Click on the download button from the menu and follow the installation guide.

5.2 Install MySQL

Download MySQL:http://dev.mysql.com/downloads/

After installed MySQL, you need to create a user and database for CMS 3.0 server.

1. Open command prompt or terminal

2. Type "mysql -uroot -ppassword" root is the root user and password should be replaced by your root password

3. In mysql>, type "create database cms3 character set utf8;"

4. Type "GRANT ALL ON cms3.* TO cms3@'localhost' IDENTIFIED BY 'cms3';" Note that you MUST type the above steps identically.

5. Now, the cms3 database and user are created. Next, you need to install our CMS 3.0 server.

5.3 Install CMS 3.0

1. Enter http://cms3.mobigator.com/ and download CMS 3.0 tomcat package for your operating system

2. Unzip the zip into {Tomcat Home Directory}. For example, Linux: /usr/local/tomcat/ Windows: C:\Program File\Tomcat\

3. Now, we need to set Tomcat server run as a service.

Windows User a. Open command line and change the current directory to {Tomcat Home Directory}/bin Type service.bat install CMS3

Ubuntu User a. Open /etc/init.d/tomcat by typing

http://www.java.com

http://dev.mysql.com/downloads/


CMS 3.0 Server Advanced Installation 23


sudo vi /etc/init.d/tomcat

b. Paste the following and save the script

# Tomcat auto-start## description: Auto-starts tomcat# processname: tomcat# pidfile: /var/run/tomcat.pid

export JAVA_HOME=/usr/lib/jvm/java-6-sun

case $1 instart)sh /usr/local/tomcat/bin/startup.sh;; stop) sh /usr/local/tomcat/bin/shutdown.sh;; restart)sh /usr/local/tomcat/bin/shutdown.shsh /usr/local/tomcat/bin/startup.sh;; esac exit 0

c. You need to make the script executable by running sudo chmod 755 /etc/init.d/tomcat

d. Type the following commands to add tomcat server run as service at startup

sudo ln -s /etc/init.d/tomcat /etc/rc1.d/K99tomcat sudo ln -s /etc/init.d/tomcat /etc/rc2.d/S99tomcat

Fedora User a. Open /etc/init.d/tomcat by typing nano /etc/init.d/tomcat using root



b. Pasta the following and save the script

#!/bin/bash# chkconfig: 2345 10 90# description: Start, Stop and Restart TomcatServer# Tomcat auto-start## processname: tomcat# pidfile: /var/run/tomcat.pid

case $1 instart)sh /usr/local/tomcat/bin/startup.sh;; stop) sh /usr/local/tomcat/bin/shutdown.sh;; restart)sh /usr/local/tomcat/bin/shutdown.shsh /usr/local/tomcat/bin/startup.sh;; esac exit 0

c. You need to make the script executable by running chmod a+x tomcat in /etc/init.d/ folder

d. Type the following command to add tomcat server run as service at startup chkconfig --add tomcat

4. Reboot your machine to apply the changes

5. The tomcat service should be run automatically after restarted

5.4 Create Server Certificate

To create server certificate, you need to install java first

1. Type the followingkeytool -genkey -alias cms3 -keyalg RSA -keystrore /usr/local/tomcat/conf/cms3.bin

CMS 3.0 Server Advanced Installation 25


2. Answer the questions and press enter

3. cms3.bin is now in the conf folder

4. Use editor to open server.conf in same folder, change keystorePass attribute to your keystorepassword

5. Save and restart tomcat

5.5 Configure CMS 3.0 Database

If you want to set the database on the other machine, you properly need to change the databasesetting.

To change the it, you can modify the following file

Tomcat\webapps\CMS3\WEB-INF\classes\datasource.properties

5.6 Use cronolog (Optional)

Cronolog is simple filter program that reads log file entries from standard input and writes each entry tothe output file specified by a filename template and the current date and time.

You can download cronolog from http://cronolog.org/

To use Cronolog, you need to replace this string in the catalina.sh

org.apache.catalina.startup.Bootstrap "$@" start \>> "$CATALINA_BASE"/logs/catalina.out 2>&1 &

with this:

org.apache.catalina.startup.Bootstrap "$@" start 2>&1 \| cronolog "$CATALINA_BASE"/logs/catalina.%Y-%m-%d >> /dev/null &

http://cronolog.org/



5.7 Use swap in Linux (Optional)

Swap is a Linux tool to allow using more memory than the physical one.

1. Type the following command in terminal to create a file the size you want. For example, 2GB. sudo dd if=/dev/zero of=/home/cms3/2GB.swap bs=4M count=512

2. Format the swap file to create a swapping device, type sudo mkswap /home/cms3/2GB.swap

3. Add the swap to the running system, type sudo swapon /home/cms3/2GB.swap

4. To make the change permanent for each reboot, you need to edit /etc/fstab sudo gedit /etc/fstab and add the following line at the end of the file /home/cms3/2GB.swap none swap sw 0 0

5. Save the file and reboot your machine to apply the changes

Update CMS 3.0 27


6 Update CMS 3.0

This part includes how to update CMS 3.0 through two methods:· By update installer· By war file

6.1 Update Installer

The update installer is for Windows user only. The installer will help you to stop and start the CMS 3.0 automatically.

1. Get the latest update installer from http://cms3.mobigator.com/

2. Extracts it and open the folder

3. Run CMS 3.0 Update installer, click Next




4. Click I Agree

5. Select the CMS 3.0 server folder and click Install

Update CMS 3.0 29


6. Wait the process to complete and click Finish



6.2 War File

For Windows user

1. Get the latest war file from http://cms3.mobigator.com/

2. Shutdown tomcat

3. Place the war file into {Tomcat Home Directroy}/webapps folder

4. Rename it to CMS3.war if necessary.

5. Extract all files into CMS3 folder


Update CMS 3.0 31


6. Delete the war file.

7. Start up Tomcat Server

For Linux user

1. Get the latest war file from http://cms3.mobigator.com/




2. Shutdown tomcat

3. Put the CMS3.war file into {Tomcat Home Directory}/webapps

4. Rename the war file to CMS3.war if needed

Update CMS 3.0 33


5. Extract all files into {Tomcat Home Directory}/webapps/CMS3

6. Delete the war file.

7. Start up Tomcat Server



7 Troubleshoot for Deployment

7.1 Install CMS 3.0 with MySQL Already Installed

See the red color notes mentioned in "Install CMS 3.0 Server"

7.2 Can't Startup MySQL Server

Error in configuring the server

If you can't see or wait too long to see the following message, please follow below.MySQL Instance Configured... Service started...

All Windows Versions

1. Please keep the current window and click Start -> MySQL -> MySQL Server 5.x -> MySQL Server

Troubleshoot for Deployment 35


Config Wizard

2. Click Next

3. Click Remove Instance and Next



4.Click Execute

5. Back to MySQL Window and click BackNote: If you are not using our CMS 3.0 Installer, please rerun this configuration tool to set a



new config

6. Click Next again, and you can pass the third step now.



Error in Apply security settings



1. You may type a wrong password, click skip and back to previous page

2. Type your password again in "Current root password" field



3. You should be succeed now

7.3 I can't connect to CMS 3.0

If you can't connect CMS 3.0 through the CMS 3.0 client, you can do the followings. Note that you don'tneed to go through all the steps. If you can access CMS 3.0 by performing serval steps, you can stopdoing the others. But you should perform the step in order.

Method 1. Check if the server is started. Enter {Tomcat Home Directory}/logs. Search for the filebeginning with "catalina". You need to open this file with today timestamp(e.g. Today is Mar 30, 2009,the file you should open is catalina.2009-03-30.log). If you can't see the startup info text, pleaserestart your Tomcat server. (you need to shut down and start up tomcat)

Method 2. Set the hostname to the host ip address directly.



Method 3. Try to ping host ip address by opening a terminal and type "ping hostip"(e.g. "ping192.168.100.39"). If you can see the reply message, it should be ok.

Method 4. Open port 8080 in firewall.Step 1: Start -> Control Panel -> Windows Firewall -> Exceptions tab

Step 2: Click Add Port -> Name the port and type 8080 in Port Number -> click OK



If the problem still exists, please contact us.

7.4 Configure CMS 3.0 Database

If you want to set the database on the other machine, you properly need to change the databasesetting.

To change the it, you can modify the following file

Tomcat\webapps\CMS3\WEB-INF\classes\datasource.properties



7.5 Login CMS 3 .0 Through HTTP

Note: This is disabled in our default package due to security reason. If you would like to use,please go through admin manual for how to enable this feature. Otherwise, you can skip thispart and click here

1. Enter http://cms3.mobigator.com/pages/index.asp?pg=user and download CMS 3.0 client. Unzip itafter downloaded

2. Enter CMS 3.0 Client folder and open

3. Open the CMS 3.0 client and you may see this page at first time. Fill up the information or set asdefault. Save the config. (Click here to know how to get hostname or ip)

http://cms3.mobigator.com/pages/index.asp?pg=user



4. You can now see the login page, type the admin account to login. The default account is Username: admin Password: admin If you can't get the access from other machine, please click here

5. Type your username and password to enter CMS 3.0. For how to create or modify account, pleasesee the next session.

7.6 Get Host IP and Host Name

Get Host IP addressWindowsType ipconfig in windows command prompt

LinuxType ifconfig in terminal



Get the Host NameWindowsRight click on My Computer and select "Properties". Change tab "Computer Name" and look for "Fullcomputer name".

LinuxType hostname in terminal



7.7 Set Host IP and Host Name

Before login to CMS 3.0, you need to configure the host ip first.

Set Host IPFor windows user

1. [Start] -> [Control Panel] -> [Network Connections]



2. Right click on your connection ( Normally Local Area Connection ), and then select "Properties"

3. Select "Internet Protocol(TCP/IP)" and click "Properties"



4. Type your settings in ip, subnet mask, etc. Note that the following is just an example, and may not be worked in your machine.

5. Click ok and wait for a moment.



6. Double click on the connection and change to "Support" tab to see if the settings have been applied.The IP in here will be used for accessing CMS 3.0.

6. Reboot the machine

For Ubuntu user

1. Use your favorite text editor to open "/etc/network/interfaces"

2. You can see your primary network interface in this file.



3. Now, you can add or modify with the following infoauto eth%%iface eth%% inet static

address [Your IP Address]netmask [Netmask]network [Network]broadcast [Broadcast]gateway [Gateway]

Note: %% is a number. 4 for this example.

4. Save the changes and type "sudo /etc/init.d/networking restart" to reconfigure the IP


For Fedora user

1. Use your favorite text editor to open "/etc/sysconfig/network-scripts/ifcfg-eth0"

2. You can see your primary network interface in this file.

3. Now, you can add or modify with above setting.



4. Save the changes and type "/etc/init.d/network restart" to reconfigure the IP


Set Host NameFor Windows user

1. Right click on my computer and select "Properties"

2. Choose tab "Computer Name" and click button "Change". Type your prefered host name in



computer name.

3. Click ok. You may need to reboot the machine to apply the changes.

For Ubuntu user

1. Open terminal and use your text editor to modify /etc/hostname

2. Change the host name in this file and save.

3. Reboot your machine to apply the changes.

For Fedora user

1. Open terminal and use your text editor to modify /etc/sysconfig/network

2. Change the host name in this file and save.

3. Reboot your machine to apply the changes.



7.8 Open Command Prompt or Terminal

How to open command prompt or terminalWindowsType cmd in "Start"->"Run"

Ubuntu"Applications"->"Accessories"->"Terminal"

Fedora"Applications"->"System Tools"->"Terminal"



7.9 Shut down Tomcat

For Windows user

There are two types of methods for shutting down Tomcat

If the server is started up when machine is on or started in service manually

1. Click Start -> Right click on My Computer -> Manage

2. Expand Services and Applications -> Services -> Select Apache Tomcat CMS3



3. Double click on it or right click -> properties, click stop

If you start up the Tomcat Server by running startup.bat

1. Close the Tomcat window



For Linux user

1. Open terminal, change the current directory to {Tomcat Home Directory} and type "sudo ./shutdown.sh". About 2 minutes later, the server should be stopped.



7.10 Start up Tomcat

For Windows user

There are two types of methods to start up Tomcat manually

Use service to start up

1. Click Start -> Right click on My Computer -> Manage

2. Expand Services and Applications -> Services -> Select Apache Tomcat CMS3



3. Double click on it or right click -> properties, click Start



Startup tomcat by using bat file

1. Enter {Tomcat Home Directory}/bin folder

2. Run startup.bat

3. If success, the following message will be displayed. If you can't get this, please report this to us.



For Linux user

1. Open terminal and change the current directory to {Tomcat Home Dirdectory}/bin.

2. type "sudo ./startup.sh"

3. After the following message has been shown, you still need to wait for few minutes( about 6 minutes)



7.11 Disable UAC

This section is useful for Windows Vista or Windows 7 user

1. Open Control Panel

2. Under User Accounts and Family settings, click on "Add or remove user accounts"

3. Click "go to the main User Accounts page" at the bottom

4. Select "Change security settings"

5.Uncheck the box "Use User Account Control(UAC) to help protect your computer" and click ok

6. Restart your machine



7.12 Q & A

Q. Tomcat server can't be started

A. Sometimes, you need to kill the java process manually by using task manager(Windows) or systemmonitor(Ubuntu). If the problem still exists, you may need to reboot the host machine.

Reference Link 65


8 Reference Link

JavaJava - http://www.java.com/

MySQLMySQL: http://www.mysql.com/MySQL forum: http://forums.mysql.com/

TomcatTomcat: http://tomcat.apache.org/Tomcat help page: http://tomcat.apache.org/findhelp.htmlTomcat FAQ: http://wiki.apache.org/tomcat/FAQASF Bugzilla: https://issues.apache.org/bugzilla/

http://www.java.com/

http://www.mysql.com/

http://forums.mysql.com/

http://tomcat.apache.org/

http://tomcat.apache.org/findhelp.html

http://wiki.apache.org/tomcat/FAQ

https://issues.apache.org/bugzilla/

cms3 installation guide(2)

Documents