New Installation

File Extraction and Disk Usage

zCI is a small program, it just need less than 1 MB of harddisk space. Extract zci-*.zip to any directory.

Database Setup

  1. For MySQL, installing MySQL Control Center is suggested that enable administrator to manage database and execute SQL command on query window. Following directions assume MySQL Control Center is used.
  2. To create database and tables for MySQL, execute mysqlscript.sql on engine directory. It will automatically create a database named zci and necessary tables.
  3. For other database software, create the database schema manually then execute the "CREATE TABLE ..." statements on mysqlscript.sql without "type=InnoDB" phrase.
  4. Set/create a database user for zCI application also the host where the database will be accessed from. The host should be the IP address or DNS name of the zCI web server.
  5. Set priviledge of the user@host (step 4) to be able to "SELECT, DELETE, INSERT, UPDATE" on zci database created on step 2.
  6. Test database connectivity from the web server.

Add-on Softwares

Clients using Microsoft Windows 95/98 or NT 4.0 do not have windows scripting and CIM schema by default. Please install MS Windows Scripting Host 5.6 and MS WMI Core 1.5. For simplicity, download both programs then put it on add-ons directory without changing their file names. URLs for download are:

Windows Scripting Host : http://www.microsoft.com/downloads/details.aspx?FamilyId=0A8A18F6-249C-4A72-BFCF-FC6AF26DC390&displaylang=en

WMI Core : http://www.microsoft.com/downloads/release.asp?releaseid=18490

Web Server Setup

  1. Install PHP. Activate DBX and MySQL extensions by uncommenting "extension=php_dbx*" and "extension=php_mysql*" in php.ini. For other database software, activate proper extensions.
  2. Edit zciconfig.php on root directory, edit the parameters of dbx_connect clause to match : the database server IP,database user and password.

return dbx_connect(DBX_MYSQL,"<DB server IP>","zci","<DB USER>","<PASSWORD>");

Example: return dbx_connect(DBX_MYSQL,"10.1.2.3","zci","myzcidbuser","myzcidbpassword");

  1. Set proper path/virtual directory for zCI in web server configuration. If using IIS, do not forget to give Execute permission for Script only.
  2. Set the default file to "index.html".
  3. Set webserver permission for admin and supervisor subdirectory because it contains PHP scripts to do data editing. Access to them will need authentication using HTTP-Authentication. IIS webserver permission can be based on file system permission. For Apache, put proper .htaccess file on that subdirectories. If having difficulties in this step, we suggest renaming the admin and supervisor subdirectories for data security reason.
  4. Test the webserver by browsing to top zCI path and manage subdirectory. If the path is correct, welcome page will be displayed also the home display of management pages.

  1. To test database connectity, click "Registered Devices" on left menu of management pages, then click "Search " button on right display. If no error messages displayed, the database connection is successful.
  2. If encountering PHP MySQL client error, please upgrade PHP to the latest-stable daily snapshot version of PHP. Open http://www.php.net and click "Snapshot" on top menu.
  3. Disable display_errors in PHP by editing php.ini file. Give comment mark (';') for display_errors. This step is likely have to be done if using newer versions of PHP because they have tighter checks of variable existence. This case will not affect zCI functionality.

Client Programs Setup

Client programs consists of only 1 small file. It is reside on the engine directory and named takedata.js. Here are the steps to set it up:

  1. Open engine directory.
  2. Open takedata.js for editing.
  3. You will see value-assigning statement for zcipath on the beginning of the file.
  4. Type the path of zCI's URL in the <zcipath> then save the JS file.

var zcipath="http://<your zCI path>/";

Example:

var zcipath="http://localhost/zci/";

  1. For use in login script and you want autoclose feature, find the line containing : var hiddenflag=false;. Change it to var hiddenflag=true;. This feature needs Microsoft Internet Explorer.
  2. To be generic and can be implemented in any organization, zCI do not has facilities to determine physical location of device, such as department name and city of the office. It is suggested to include such information on the device name. For example, a computer that is located on Jakarta, Indonesia and being used by user Zamroni can be named ID-JKT-ZAMRONI1.

Font and Colour Scheme

There are 2 CSS files in frontend subdirectory that you can edit to change display scheme of zCI Management Pages. The page contain of 3 frames, i.e. top frame, left frame and right frame. File content.css is used by right frame and leftmenu.css is used by left frame.