Use the installation guide provided below if you have any problems or questions during Thyme's
installation. Otherwise, the installation itself will walk you through the required steps.
If you have any questions that are not answered here, please do not hesitate to contact
support@extrosoft.com.
- 1.0 config.php not writable
If you receive this message, it means that PHP can not write to config.php. Thyme needs to
write to this file in order to store it's configuration.
If you are using a hosting provider (if you pay someone to host your web site), you can probably
do this using a file manager provided in the control panel for your site. Make the permissions 666
(or 0666 if asked for 4 digits)
for config.php
If you've used an FTP program to transfer Thyme, you should be able to change file permissions through it
by navigating to the location of config.php (/home/regionfi/public_html/07R10/thyme/include), right clicking on config.php
and selecting 'Change permissions', 'chmod', or 'Properties'. The permissions on this file should
be set to 666 (or 0666 if asked for 4 digits).
If you or someone at your organization has direct access to this web server, you (or they) can follow
the instructions below to change the permissions of config.php.
The installation guide has detected that your web server is running on Unix (Linux, FreeBSD, etc..) or
MacOSX. To make config.php writable by your web server, execute the following from a command prompt
on the server:
chmod 0666 /home/regionfi/public_html/07R10/thyme/include/config.php
If you receive a 'permission denied' error, you will have to 'su' to root. For more information
on how to do this, please consult your operating system's manual.
config.php should now be writable by your web server and you may continue with the installation.
- 2.1 Step 1 - Database Configuration
This is where you configure Thyme to connect to your database.
If you do not know what to enter here, you will need to contact your web hosting
provider for instructions on how to create a database. Most web hosting providers
provide a database section in your hosting control panel. If you have this section in
your hosting control panel, you may create a database and database username/password there.
As an
advanced configuration option,
Thyme may even create a user
and database for you if you do not already have those configured.
Please do not use this unless you know what you are doing.
If you wish for Thyme to create a database for you, the user entered in the "Database Configuration"
section must have access to do so. If this user not have access to create a database, you may
enter an alternate user/password pair under "Advanced Install Options",
and Thyme will connect and create a database
as that user. If you do not know a username/password
that has access to create a database, you will have to use an existing database. Thyme will
also attempt to grant all access to the database for the user entered under
"Database Configuration" if this option is selected.
Thyme may create the user entered under "Database Configuration" if you wish it to do so. The
username/password under "Advanced Install Options" must have access to create users.
Errors:
- _connect() :: Unknown MySQL Server Host 'host'
- _connect() :: pg_connect(): Unable to connect to PostgreSQL server: unknown host name: host
- _connect() :: mssql_connect(): Unable to connect to server host
The name you've entered for Host under "Database Configuration" can not be found.
Check the spelling of the host you've entered.
- _connect() :: Access denied for user
'user@host' to database
'database'
- _connect() :: pg_connect(): PostgreSQL server: FATAL 1: Password authentication failed for user "user"
- _connect() :: pg_connect(): PostgreSQL server: FATAL 1: IDENT authentication failed for user "user"
- _connect() :: mssql_connect(): Login failed for user 'user'
-
The username you've entered is unable to connect to the database. This can happen if:
- The username you've entered does not have access to connect to the database
- The username you've entered does not exist
- The password you've entered for the user is not correct
- The database you've entered does not exist
If you are using MySQL, you may select the 'Create User' option
under "Install Options" and Thyme
will create this user for you. If the user already exists, this will reset
their password to the password you've entered and grant them all permissions
for the database. Also check that the database exists.
In some PostgreSQL configurations this may happen if you've set up your database
for password authentication, the PostgreSQL database is running on the same host,
and you've entered a hostname in the "Host" field. Leave "Host" blank under
"Database Configuration" and try again.
- query() :: Access denied for user:
'user@host' to database
'database'
- User 'user' can not perform action on
tables in the 'database' database.
The username you've entered does not have access to perform the query or SQL command.
The query should appear below this message. You will have to choose a different user,
that has a higher level of access.
If the above did not help, you will have to manually set up your database. See the
Database Setup section of the FAQ on Thyme's web site.
- 2.2 Step 2 - Database Table Install
Thyme will detect which version you have installed (if any) and upgrade or install the
tables in your database.
Errors:
Note: when going back to Step 2 either by pressing the back button on a browser, or by clicking
'Previous' from within the installation, it will tell you that the current database scheme is up
to date. This is because it had already performed the necessary steps to update or install
tables when you went on to Step 3.
- 2.3 Step 3 - Config Options
This step of the installation sets configurable options. It is well documented and
should not fail or give any errors.
- 2.4 Step 4 - Adding the Thyme scheduled job
The Thyme scheduled job is a PHP script which needs to run in order to; send out event reminders, send event
subscriptions, send notifications of updated or added events, and update remote RSS feeds (don't worry if
you don't know what RSS feeds are). Something needs to be told to run this script every 5 minutes.
Why so often? Events can happen in 5 minute intervals. Running this job
is no more intensive than visiting any database driven web-page.
Instructions for scheduling this job appear during Thyme's installation. If you need assistance, please
do not hesitate to contact
support@extrosoft.com
- 3.0 - PHP Settings
Thyme requires the following PHP settings:
- magic_quotes_sybase "off"
This is off by default, however, some sites may have it turned on.
Thyme recommends the following PHP settings:
If using attachments, Thyme requires the following settings:
(assuming you want an 8M limit on event attachments)
- file_uploads "1"
- upload_max_filesize "8M"
- post_max_size "9M" (NOTE: upload_max_filesize + (at least) 1M)
- max_input_time 120
If using apache, we recommend you set this in httpd.conf or an .htaccess file. See the file
htaccess-example in Thyme's base directory. The configuration settings are
in the format of:
# required
###########
php_value magic_quotes_gpc "0"
php_flag magic_quotes_sybase Off
# dependent on event attachment size
#
# Set post_max_size to at least 1M
# over your upload_max_filesize
####################################
php_value post_max_size "11M"
php_value upload_max_filesize "10M"
php_value max_input_time "120"
NOTE: file_uploads can not be set in an .htaccess file
and must be set in php.ini.
If your apache configuration supports this, you may simply create a copy of that file in the
same directory named
.htaccess and edit it to suite your needs. Most
web hosting providers' configurations will allow for this.
If you are not using apache or your configuration does not allow for an .htaccess file that
can change php settings, you will have to set these in php.ini. You may use the phpinfo.php
script distributed with Thyme to obtain the location of your php.ini file
(located here:
phpinfo.php). It is in the first section and named
'
Configuration
File (php.ini) Path'.
Simply find and change the values. Note that in some
cases you may have to set a value to "Off" instead of "0" or "On" instead of "1". Use
the setting's current value to determine this.
If php.ini does not exist in the location specified by phpinfo.php, you may have to
create it by copying 'php.ini-recommended' from PHP's base dir to the location specified by
phpinfo.php and renaming it to 'php.ini'. Then you may edit the appropriate values.