Click here for a video tutorial of the installation procedure.
*.*If you want to launch Concerto image on Amazon EC2 instance, you can search for: Ubuntu 13.04 - Concerto v4.0.0.beta5 in your EC2 Management Console AMI search engine. After setting up Concerto instance it is recommended to update Concerto version to the latest available using the guide below.
This tutorial assumes that Apache is your HTTP server
Download the latest Concerto v4 package.
Copy the contents of the package to your Apache public www directory
As a user with root access do:
Start R by typing: R
Then type install.packages("rjson") at the R prompt, afterwards quit R with
q()
cd /var/www/concerto/lib/R
... replace /var/www/concerto/ with your Concerto installation directory path
R CMD build concerto
R CMD INSTALL -l /usr/lib/R/library concerto
Create new Concerto master MySQL database
Edit {installation_dir}/SETTINGS.php file.
Run http://yourdomain/{concerto_directory}/setup and correct any reported problem.
Run:
sudo visudo
... and add this lines:
www-data ALL=(%concerto) NOPASSWD: /usr/bin/R
www-data ALL=(%concerto) NOPASSWD: /bin/kill
Replace www-data with your PHP process user name (corresponds to $php_user variable from SETTINGS.php), concerto with your Linux group name for Concerto Linux users (corresponds to $r_users_group variable from SETTINGS.php) and /usr/bin/R with path to R executable (corresponds to $path_r_exe variable from SETTINGS.php)
If you see line with:
Defaults requiretty
... then comment it out.
As a root user run:
crontab -e
... and add following lines:
* * * * * /usr/bin/php /var/www/concerto/cron/users.php
... and:
0 0 1 * * /usr/bin/php /var/www/concerto/cron/autocomplete.php
(where /var/www/concerto/ is your Concerto installation directory)
Concerto v3.x and lower are not compatible with v4.x. You need to make a clean installation first if you want to move to v4.x.
Download the latest Concerto v4 package.
Copy the contents of the package to your Concerto installation directory
As a user with root access do:
cd /var/www/concerto/lib/R
... replace /var/www/concerto/ with your Concerto installation directory path
R CMD build concerto
R CMD INSTALL -l /usr/lib/R/library concerto
Edit {installation_dir}/SETTINGS.php file.
Run http://yourdomain/{concerto_directory}/setup and correct any reported problem.
This file contains all configurable options that needs to be set before you can run Concerto on your system.
| VARIABLE NAME | DESCRIPTION | EXAMPLE VALUE |
|---|---|---|
| $db_host | MySQL server host | "localhost" |
| $db_port | MySQL server port | 3306 |
| $db_master_user | MySQL user name with ALL privileges and GRANT option | "root" |
| $db_master_password | MySQL password for user with ALL privileges and GRANT option | "topsecret" |
| $db_master_name | Concerto master MySQL database name ( user need to create it manually prior to running /setup ) | "concerto" |
| $db_users_name_prefix | prefix for MySQL user names created by Concerto ( workspace id will be appended to it ) - SET IT ONLY ONCE PRIOR TO RUNNING /setup | "concerto" |
| $db_users_db_name_prefix | prefix for MySQL database names created by Concerto ( workspace id will be appended to it ) - SET IT ONLY ONCE PRIOR TO RUNNING /setup | "concerto" |
| $path_external | Concerto full URL ending with slash character ('/') | "http://domain.com/concerto/" |
| $path_r_script | Rscript executable path | "/usr/bin/Rscript" |
| $path_r_exe | R executable path | "/usr/bin/R" |
| $path_php_exe | php executable path | "/usr/bin/php" |
| $path_sock | socks directory path ending with slash character ('/'), leave blank for default - /{concerto_installation_path}/socks/ | "/var/concerto_socks" |
| $path_data | data directory path ending with slash character ('/'), leave blank for default - /{concerto_installation_path}/data/ | "/var/concerto_data" |
| $server_socks_type | socket server type ( UNIX or TCP, UNIX highly recommended ) | "UNIX" |
| $server_host | choose host to connect to ( only when TCP ) | "127.0.0.1" |
| $server_port | choose port used for connection ( only when TCP ) | "8888" |
| $r_instances_persistant_instance_timeout | after set period of instance inactivity in seconds the instance will be serialized and closed | 900 |
| $r_instances_persistant_server_timeout | after set period of server inactivity in seconds the server will be closed ( new instances can restart it anytime ) | 1200 |
| $r_max_execution_time | maximum R execution time after which instance will be terminated ( prevents infinite loops in R on server ) | 30 |
| $unix_locale | Unix locale LANG variable. Must be installed on the system. Leave blank for none/default | "en_GB.UTF8" |
| $timezone | PHP timezone settings | "Europe/London" |
| $mysql_timezone | MySQL timezone settings, leave blank to make it the same as $timezone | "+0:00" |
| $public_registration | is open registration from login form allowed | false |
| $cms_session_keep_alive | prevents session expiry when in panel | true |
| $cms_session_keep_alive_interval | time interval between session keep alive requests in miliseconds | 300000 |
| $remote_client_password | password required by remote clients to use this Concerto server | "topsecret" |
| $r_users_name_prefix | prefix for Linux users created by Concerto ( user id will be appended to it ) - SET IT ONLY ONCE PRIOR TO RUNNING /setup | "concerto" |
| $r_users_group | Linux group name for users above | "concerto" |
| $php_user | PHP process user name | "www-data" |
| $php_user_group | PHP process user group | "www-data" |
| $log_server_events | socket communication info and test server php errors will be printed to a text file in data directory | false |
| $log_server_streams | socket server streams will be logged too | false |
| $log_js_errors | logs all test specific js errors from client side | true |
| $log_r_errors | logs all test specific R errors | true |
ALWAYS RUN /setup AFTER CHANGING SETTINGS IN THIS FILE!
When uninstalling it is highly recommended to first:
* * * * * /usr/bin/php /var/www/concerto/cron/users.php - using default settings it
fires every minute