CGI

CGI tools

This section describes web-based (CGI) access to MyARM measured data. There are basically two CGI programs provided by MyARM. The first myarmquery.cgi can be used to query any recorded ARM data and the second myarmview.cgi is used to get an overview of the measured and recorded ARM data. The following section briefly describes how to install these CGI programs on an Apache web-server. The next two sections describe these CGI programs in detail. In appendix "Configuring CGI tools" the configuration properties for the CGI programs are described in detail.

Installation for Apache

To install the CGI programs into an Apache web-server

1. Copy the CGI programs to the CGI directory of the httpd program,
2. Copy the files myarmcgi.css, querybg.png, navbar.png, headbar.png, viewbg.png, hbar.png and vbar.png to the DocumentRoot of your webserver.
3. Enable .htaccess reading in the CGI directory.
4. Add the following lines to the .htaccess file (assuming myarm is installed in /opt/myarm and MySQL is used as storage backend):

   <Files myarmquery.cgi>
      SetEnv LD_LIBRARY_PATH /opt/myarm/lib
      SetEnv MYARM_ROOT /opt/myarm
      SetEnv MYARM_VAR_DIR /opt/myarm/var
      SetEnv MYARM_CONFIG_URL file:////opt/myarm/conf/mysql.conf
      SetEnv MYARM_LICENSE_KEY <your_license_key>
      SetEnv MYSQL_UNIX_PORT /var/run/mysqld/mysqld.sock
   </Files>
   
   <Files myarmview.cgi>
      SetEnv LD_LIBRARY_PATH /opt/myarm/lib
      SetEnv MYARM_ROOT /opt/myarm
      SetEnv MYARM_VAR_DIR /opt/myarm/var
      SetEnv MYARM_CONFIG_URL file:///opt/myarm/conf/mysql.conf
      SetEnv MYARM_LICENSE_KEY <your_license_key>
      SetEnv MYSQL_UNIX_PORT /var/run/mysqld/mysqld.sock
   </Files>

Installation Hints

The following list gives some hints for the apache configuration needed to setup the MyARM CGI programs correctly. For a detailed description please read the web-server manual.

• Make sure you have the AllowOverride directive setup correctly (FileInfo enabled) for the cgi-bin directory thus apache will read the .htaccess.
• Make sure that you have loaded the mod_env module.

Below some MyARM specific hints are listed which may help you setting up the CGI programs.

• If you use MyARM configuration files including environment variables, make sure that these variables are also set in the appropriate sections in the .htaccess file.
• Make sure that the appropriate data sinks can be accessed from the user running the apache web server:

  MySQL

  setup correct privileges for the apache user and the MyARM database.

  SQLite

  setup correct file permissions for the SQLite database files.