CUBRID Web Manager Installation Instructions

If you have CUBRID 8.4.3 or 9.1 already installed, you do not need to install CUBRID Web Manager (CWM) separately as it is already embedded. For CUBRID 8.4.0, 8.4.1, and 9.0, read on.

If you want use CUBRID inside a virtual machine, you may want to check the following tutorial which automates the installation process and installs CUBRID, CWM and the necessary drivers for you.

• Create a CUBRID Database VM with Vagrant and Chef Cookbook under 5 minutes

Prerequisites

There are two prerequisites to work with CWM:

1. CUBRID Database
   CUBRID Web Manager works as a server-side plug-in for CUBRID Database Server, therefore it requires CUBRID 8.4.0 or later which has already been installed. Sometimes, a Broker and database server run on different hosts. No matter how, CWM must be installed on the host where the server is installed. 
2. Browser
   CWM is a Web-based GUI application. Therefore, it should be used in a Web browser. For your better experience, we strongly recommend to use the latest version of Chrome, Safari, Firefox or Internet Explorer.

Download

CUBRID Web Manager can be installed by simply downloading CWM installation package compatible with the CUBRID Server installed on your system.

If CUBRID is not installed

If there is no CUBRID DB server and Web manager in your system, then:

• Download the latest version of CUBRID Database Server from:
  • http://www.cubrid.org/?mid=downloads&item=cubrid&os=detect
  • Or http://ftp.cubrid.org/CUBRID_Engine/ 
    
    Then follow CUBRID Installation Instructions.
• Download the latest CUBRID Web Manager from:
  • http://www.cubrid.org/?mid=downloads&item=cubrid_web_manager&os=any&cubrid=any
  • Or http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Web_Manager/
    
    Then follow the installation instructions below.

If CUBRID is already installed

If CUBRID Database Server 8.4.0 or later has already been installed, then download CUBRID Web Manager package from http://www.cubrid.org/?mid=downloads&item=cubrid_web_manager&os=any&cubrid=any or http://ftp.cubrid.org/CUBRID_Tools/CUBRID_Web_Manager/. Then follow the installation instructions below.

Install CUBRID Web Manager

Installing CWM is very easy. Stop the cubrid service then simply extract the files from the installation package to the same directory where CUBRID is installed, and its done.

• Make sure CUBRID Database Server is installed in $CUBRID/ home directory.
• Stop CUBRID Manager Service completely on the server by running cubrid manager stop command.
• Decompress CWM installation package (unzip on Windows or untar on Linux) to the same folder where CUBRID Server has been installed ($CUBRID/). The CWM installation package includes three folders (bin, conf, share).
  Files and sub-folders in (bin, conf, share) should be copied and overwrite corresponding old folders (/home/CUBRID/bin, /home/CUBRID/conf, /home/CUBRID/share) completely.

Configure

You can edit the conf/cm_httpd.conf text file in order to configure httpd service for Web manager. Note that if any configuration is changed, CUBRID Manager Service must be restarted.

• Required:
  • On linux, if you login as 'root' user, CM httpd service will require 'root' permission. Therefore, you should change the user permission setting in this file. For instance, change #user nobody; to user root;
• Optional:
  • The default TCP listening port of CM httpd is 8282 for HTTPS/SSL. It can be changed in this file.

See more optional variables.

Start CUBRID Web Manager

If you installed and configured Web manger successfully in your server, start CUBRID Manager Service with cubrid manager start command. Then browse https://cubrid-server-ip:8282 in your Web browser. Notice that HTTPS is used because it listens to SSL port 8282. Now enjoy!

How to use Web Manager?

You can learn how to use Web Manager thru its manual. Basically it is similar with other Web tools such as phpMyadmin, SIDU and so on.  See the manaul : http://www.cubrid.org/wiki_tools/entry/cubrid-web-manager-manual

APPENDIX

How to manually stop/start CUBRID Manager HTTPD service?

If you want to stop using Web manager with httpd, you can stop CM httpd service only in prompt. It will never affect other CM server services.

Command to stop httpd:

cub_cmhttpd stop

Command to start httpd:

cub_cmhttpd start