system-config/doc/source/survey.rst
François Magimel 46260a79ee Fix spelling mistakes and reST typos in the doc
Change-Id: I61d9780f3f1937c6e8d326a670c40fb6a931dbce
2018-12-08 19:13:53 +01:00

85 lines
2.4 KiB
ReStructuredText

:title: Survey
.. _survey:
Survey
######
Survey runs an instance of the LimeSurvey software, an open source survey
tool written in php.
At a Glance
===========
:Hosts:
* https://survey.openstack.org
:Puppet:
* file:`modules/openstack_project/manifests/survey.pp`
:Projects:
* https://www.limesurvey.org/
:Bugs:
* https://www.limesurvey.org/community/bug-tracker
Overview
========
Apache is used with a Trove backend.
Sysadmin
========
After initially provisioning the server, enable the Authwebserver plugin via mysqlclient:
.. code-block:: bash
insert into plugins (name, active) values ('Authwebserver', 1);
insert into plugin_settings (plugin_id, plugin_settings.key, plugin_settings.value) values (1, 'strip_domain', '""');
insert into plugin_settings (plugin_id, plugin_settings.key, plugin_settings.value) values (1, 'serverkey', '"REMOTE_USER"');
insert into plugin_settings (plugin_id, plugin_settings.key, plugin_settings.value) values (1, 'is_default', '"1"');
Log in as admin to auto-create your account:
Admin sign-in: https://survey.openstack.org/admin
Elevate your account to Superadmin via mysqlclient:
.. code-block:: bash
insert into permissions (entity, entity_id, uid, permission, read_p) values ("global", 0, 2, "superadmin", 1);
(where the 2 in this example should be replaced with whatever the uid index
value is in the users table for your OpenID-autocreated account)
Refresh your browser. When logged in via the web-ui you should now have
superadmin privileges allowing you to set the following values:
Configuration > Global Settings > Email Settings
Default site admin email: infra-root@openstack.org
Administrator name: admin
Configuration > Global Settings > Bounce Settings
Default site admin email: infra-root@openstack.org
Save and Close
check admin name and email information on front page: survey.openstack.org
to confirm change
Admin Survey User
=================
Log in via https://survey.openstack.org/admin using OpenStackID.
Navigate to your 'My Account' settings at:
https://survey.openstack.org/index.php/admin/user/sa/personalsettings
Change your Email from 'autouser@test.test' to the email you would like to
use for the use of surveys.
Change your Full Name from 'autouser' to your Full Name that survey
participants can recognize.
Save and Close using the button in the top right hand corner.