Actions

Installation procedure for limesurvey 2.0: Difference between revisions

From LimeSurvey Manual

No edit summary
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages /> <translate>


=LIMESURVEY 2.0 - INSTALLATION GUIDE=
=LIMESURVEY 2.0 - INSTALLATION GUIDE= <!--T:1-->


<!--T:2-->
<div class="simplebox">
<div class="simplebox">


= Disclaimer=
= Disclaimer= <!--T:3-->


<!--T:4-->
The current release is not a '''stable version intended for production''', which means you are using this software at your own risk! This program is provided "as is" without warranties of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction. In no event will any copyright holder be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs). </div>
The current release is not a '''stable version intended for production''', which means you are using this software at your own risk! This program is provided "as is" without warranties of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction. In no event will any copyright holder be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs). </div>


==Requirements==
==Requirements== <!--T:5-->


<!--T:6-->
Make sure your server meets the following additional requirements:
Make sure your server meets the following additional requirements:


<!--T:7-->
Required:
Required:
* Minimum 80 MB disk space
* Minimum 80 MB disk space
Line 19: Line 24:
** mysql5 or pgsql PHP library (which is standard with hosting providers - if you have setup your own server make sure it is installed)
** mysql5 or pgsql PHP library (which is standard with hosting providers - if you have setup your own server make sure it is installed)


<!--T:8-->
Note: We assume that you don't have any PHP standard libraries explicitly deactivated (like sessions, pcre, ctype or others).
Note: We assume that you don't have any PHP standard libraries explicitly deactivated (like sessions, pcre, ctype or others).


<!--T:9-->
Optional PHP Extensions:
Optional PHP Extensions:
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas or nice charts in statistics - see [http://de3.php.net/manual/en/image.setup.php PHP GD-Library Extension documentation]
* '''GD-Library''' '''with FreeType support''' installed is needed for captchas or nice charts in statistics - see [http://de3.php.net/manual/en/image.setup.php PHP GD-Library Extension documentation]
Line 27: Line 34:
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [http://www.php.net/manual/en/zlib.setup.php PHP Zlib Extension documentation]
* '''Zlib''' (pretty standard) is needed for the [[ComfortUpdate]] - see [http://www.php.net/manual/en/zlib.setup.php PHP Zlib Extension documentation]


==Upgrading==
==Upgrading== <!--T:10-->


<!--T:11-->
If you are upgrading from an older version of limesurvey we suggest you to check out and hold close to the instructions, which can be found in our [http://docs.limesurvey.org/tiki-index.php?page=Upgrading+from+a+previous+version online manual|online manual].
If you are upgrading from an older version of limesurvey we suggest you to check out and hold close to the instructions, which can be found in our [http://docs.limesurvey.org/tiki-index.php?page=Upgrading+from+a+previous+version online manual|online manual].


==Grabbing the code==
==Grabbing the code== <!--T:12-->
# Download the latest limesurvey 2.0 release by following this [http://docs.limesurvey.org/Accessing+the+source+code&structure;=LimeSurvey+developmentg guide guide]. Look for releases marked "2.0"
# Download the latest limesurvey 2.0 release by following this [http://docs.limesurvey.org/Accessing+the+source+code&structure;=LimeSurvey+developmentg guide guide]. Look for releases marked "2.0"
# Unzip and move the contents into the document root of your webserver. You can install it in a '''sub-directory''' of the root if you wish.
# Unzip and move the contents into the document root of your webserver. You can install it in a '''sub-directory''' of the root if you wish.


==Installation==
==Installation== <!--T:13-->


<!--T:14-->
Point your web browser to the directory of your webserver where limesurvey is located.
Point your web browser to the directory of your webserver where limesurvey is located.


<!--T:15-->
eg: http://www.your_website.com/limesurvey2.0/
eg: http://www.your_website.com/limesurvey2.0/


<!--T:16-->
eg: http://localhost/limesurvey2.0/
eg: http://localhost/limesurvey2.0/


<!--T:17-->
And you should see something like this.
And you should see something like this.


<!--T:18-->
[[File:0.png]]
[[File:0.png]]


<!--T:19-->
Follow the link provided.
Follow the link provided.


===STEP 1 - Welcome===
===STEP 1 - Welcome=== <!--T:20-->


<!--T:21-->
Choosing installation Language (Website language will be set at the end of the installation process).
Choosing installation Language (Website language will be set at the end of the installation process).


[[File:1.png]]
<!--T:22-->
[[File:install_select_language_205_CY_actXcellence.png]]


===STEP 2 - License===
===STEP 2 - License=== <!--T:23-->


<!--T:24-->
If you agree with the license you may continue.
If you agree with the license you may continue.


[[File:2.png]]
<!--T:25-->
[[File:install_license_205_CY_actXcellence.png]]


=== STEP 3 - Pre-installation check===
=== STEP 3 - Pre-installation check=== <!--T:26-->


<!--T:27-->
In this step, system requirements are checked for proper running of limesurvey 2.0.
In this step, system requirements are checked for proper running of limesurvey 2.0.


<!--T:28-->
Required settings are a '''MUST''' for proceeding with the installation. All the settings should be fulfilled for the installation to proceed.
Required settings are a '''MUST''' for proceeding with the installation. All the settings should be fulfilled for the installation to proceed.


<!--T:29-->
Optional settings are required for certain features such as creating and downloading zip files.
Optional settings are required for certain features such as creating and downloading zip files.


<!--T:30-->
You '''CAN '''install limesurvey without the optional settings.
You '''CAN '''install limesurvey without the optional settings.


<!--T:31-->
If your webserver is running linux you may find yourself in the following situation where you don't have read and write permissions.
If your webserver is running linux you may find yourself in the following situation where you don't have read and write permissions.


<!--T:32-->
[[File:3.1.png]]
[[File:3.1.png]]


You can fix this problem by changing file permissions of the files or folders to 777.
<!--T:33-->
You can fix this problem by changing file permissions of the files or folders to 755.


<!--T:34-->
This can be achieved using the ftp client if you want to install limesurvey on your remote server or if you install limesurvey locally
This can be achieved using the ftp client if you want to install limesurvey on your remote server or if you install limesurvey locally


<!--T:35-->
you can issue the chmod command in the terminal,
you can issue the chmod command in the terminal,


eg: chmod 777 application/config/database.php (you must be in the limesurvery2.0 directory for this to work)
<!--T:36-->
eg: chmod 755 application/config/database.php (you must be in the limesurvery2.0 directory for this to work)


<!--T:37-->
Press check again and be sure that all your required settings are in order.
Press check again and be sure that all your required settings are in order.


<!--T:38-->
Notice: If 755 still doesn't give you write access try using 777.
<!--T:39-->
Your screen should look something similar to this.
Your screen should look something similar to this.


<!--T:40-->
[[File:3.2.png]]
[[File:3.2.png]]


===STEP 4 - Configuration===
===STEP 4 - Configuration=== <!--T:41-->


<!--T:42-->
'''Database type''': In general it's MySQL. But you can check your server for more details.
'''Database type''': In general it's MySQL. But you can check your server for more details.


<!--T:43-->
'''Database location''': ''localhost'' in most cases if the website and database are on the same server or give the ip/url (eg.193.12.34.21/www.example.com) where the database is hosted.
'''Database location''': ''localhost'' in most cases if the website and database are on the same server or give the ip/url (eg.193.12.34.21/www.example.com) where the database is hosted.


<!--T:44-->
'''Database name''': choose a name for example "limesurvey".
'''Database name''': choose a name for example "limesurvey".
*   If the database "limesurvey" already existing then the new tables will be appended to it i.e. old tables will remain in it.
*   If the database "limesurvey" already existing then the new tables will be appended to it i.e. old tables will remain in it.
*   If "limesurvey" doesn&rsquo;t exist, it will be created and populated with the new tables.
*   If "limesurvey" doesn&rsquo;t exist, it will be created and populated with the new tables.


<!--T:45-->
'''Database user/password''': Database login details. These details are required to authenticate the installer to add new tables to the database.
'''Database user/password''': Database login details. These details are required to authenticate the installer to add new tables to the database.


<!--T:46-->
'''Database prefix''': Optional you can leave it blank. It's useful if you have a shared database.
'''Database prefix''': Optional you can leave it blank. It's useful if you have a shared database.


<!--T:47-->
Your screen should look something like this.
Your screen should look something like this.


<!--T:48-->
[[File:4.png]]
[[File:4.png]]


===STEP 5 - Database settings===
===STEP 5 - Database settings=== <!--T:49-->


<!--T:50-->
If database "limesurvey" already exists you would see a screen like this:
If database "limesurvey" already exists you would see a screen like this:


<!--T:51-->
[[File:5.1.png]]
[[File:5.1.png]]


<!--T:52-->
If database "limesurvey" doesn&rsquo;t exist already you would see a screen like this:
If database "limesurvey" doesn&rsquo;t exist already you would see a screen like this:


<!--T:53-->
[[File:5.2.png]]
[[File:5.2.png]]


<!--T:54-->
Follow the steps and populate the database.
Follow the steps and populate the database.


===STEP 6 - Optional settings===
===STEP 6 - Optional settings=== <!--T:55-->


<!--T:56-->
You can fill these settings now or you can fill them later.
You can fill these settings now or you can fill them later.


<!--T:57-->
And also here you have the option to change the website language.
And also here you have the option to change the website language.


<!--T:58-->
If you choose to skip this part the following defaults are provided.
If you choose to skip this part the following defaults are provided.
*   username : admin
*   username : admin
*   password : password
*   password : password


<!--T:59-->
[[File:6.png]]
[[File:6.png]]


<!--T:60-->
'''Don&rsquo;t''' forget to change your username password later if you haven't done it now.
'''Don&rsquo;t''' forget to change your username password later if you haven't done it now.


=== Success!===
=== Success!=== <!--T:61-->


<!--T:62-->
If you can see the following screen, then you have successfully installed limesurvey2.0 in your server.
If you can see the following screen, then you have successfully installed limesurvey2.0 in your server.


<!--T:63-->
[[File:7.1.png]]
[[File:7.1.png]]


<!--T:64-->
The following errors could occur at the end of the installation:
The following errors could occur at the end of the installation:
* delete failed
* delete failed


<!--T:65-->
Solution: Remove the files manually
Solution: Remove the files manually


<!--T:66-->
After that go to your admin panel and login:
After that go to your admin panel and login:


<!--T:67-->
eg: http://www.your_website.com/limesurvey2.0/index.php/admin
eg: http://www.your_website.com/limesurvey2.0/index.php/admin


<!--T:68-->
eg: http://localhost/limesurvey2.0/index.php/admin
eg: http://localhost/limesurvey2.0/index.php/admin


= Troubleshooting=
= Troubleshooting= <!--T:69-->


<!--T:70-->
See [[Troubleshooting 2.x]]
See [[Troubleshooting 2.x]]
</translate>

Latest revision as of 22:14, 9 June 2013

LIMESURVEY 2.0 - INSTALLATION GUIDE

Disclaimer

The current release is not a stable version intended for production, which means you are using this software at your own risk! This program is provided "as is" without warranties of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction. In no event will any copyright holder be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs).

Requirements

Make sure your server meets the following additional requirements:

Required:

  • Minimum 80 MB disk space
  • MySQL 4.1.0 or later OR    Microsoft SQL Server 2000 or later OR  Postgres 8.1 or later
  • PHP 5.1.2 or later with the following modules/libraries enabled:
    • mbstring (Multibyte String Functions) extension library (see also Installation FAQ)
    • mysql5 or pgsql PHP library (which is standard with hosting providers - if you have setup your own server make sure it is installed)

Note: We assume that you don't have any PHP standard libraries explicitly deactivated (like sessions, pcre, ctype or others).

Optional PHP Extensions:

Upgrading

If you are upgrading from an older version of limesurvey we suggest you to check out and hold close to the instructions, which can be found in our online manual|online manual.

Grabbing the code

  1. Download the latest limesurvey 2.0 release by following this guide guide. Look for releases marked "2.0"
  2. Unzip and move the contents into the document root of your webserver. You can install it in a sub-directory of the root if you wish.

Installation

Point your web browser to the directory of your webserver where limesurvey is located.

eg: http://www.your_website.com/limesurvey2.0/

eg: http://localhost/limesurvey2.0/

And you should see something like this.

Follow the link provided.

STEP 1 - Welcome

Choosing installation Language (Website language will be set at the end of the installation process).

STEP 2 - License

If you agree with the license you may continue.

STEP 3 - Pre-installation check

In this step, system requirements are checked for proper running of limesurvey 2.0.

Required settings are a MUST for proceeding with the installation. All the settings should be fulfilled for the installation to proceed.

Optional settings are required for certain features such as creating and downloading zip files.

You CAN install limesurvey without the optional settings.

If your webserver is running linux you may find yourself in the following situation where you don't have read and write permissions.

You can fix this problem by changing file permissions of the files or folders to 755.

This can be achieved using the ftp client if you want to install limesurvey on your remote server or if you install limesurvey locally

you can issue the chmod command in the terminal,

eg: chmod 755 application/config/database.php (you must be in the limesurvery2.0 directory for this to work)

Press check again and be sure that all your required settings are in order.

Notice: If 755 still doesn't give you write access try using 777.

Your screen should look something similar to this.

STEP 4 - Configuration

Database type: In general it's MySQL. But you can check your server for more details.

Database location: localhost in most cases if the website and database are on the same server or give the ip/url (eg.193.12.34.21/www.example.com) where the database is hosted.

Database name: choose a name for example "limesurvey".

  •   If the database "limesurvey" already existing then the new tables will be appended to it i.e. old tables will remain in it.
  •   If "limesurvey" doesn’t exist, it will be created and populated with the new tables.

Database user/password: Database login details. These details are required to authenticate the installer to add new tables to the database.

Database prefix: Optional you can leave it blank. It's useful if you have a shared database.

Your screen should look something like this.

File:4.png

STEP 5 - Database settings

If database "limesurvey" already exists you would see a screen like this:

If database "limesurvey" doesn’t exist already you would see a screen like this:

Follow the steps and populate the database.

STEP 6 - Optional settings

You can fill these settings now or you can fill them later.

And also here you have the option to change the website language.

If you choose to skip this part the following defaults are provided.

  •   username : admin
  •   password : password

File:6.png

Don’t forget to change your username password later if you haven't done it now.

Success!

If you can see the following screen, then you have successfully installed limesurvey2.0 in your server.

The following errors could occur at the end of the installation:

  • delete failed

Solution: Remove the files manually

After that go to your admin panel and login:

eg: http://www.your_website.com/limesurvey2.0/index.php/admin

eg: http://localhost/limesurvey2.0/index.php/admin

Troubleshooting

See Troubleshooting 2.x

Retrieved from "http://manual.limesurvey.org/index.php?title=Installation_procedure_for_limesurvey_2.0&oldid=37959"