system-config/doc/source/survey.rst

85 lines
2.4 KiB
ReStructuredText
Raw Normal View History

: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 priviledges 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.