2021-07-26 10:39:47 +02:00
|
|
|
= mote SOP
|
|
|
|
|
|
|
|
|
|
mote is a MeetBot log wrangler, providing an user-friendly interface for
|
2023-12-20 11:15:46 -08:00
|
|
|
viewing logs produced by Fedora's matrix meetings.
|
2021-07-26 10:39:47 +02:00
|
|
|
|
|
|
|
|
Production instance: http://meetbot.fedoraproject.org/ Staging instance:
|
|
|
|
|
http://meetbot.stg.fedoraproject.org
|
|
|
|
|
|
|
|
|
|
== Contents
|
|
|
|
|
|
2021-09-07 14:10:07 +02:00
|
|
|
* <<_contact_information>>
|
|
|
|
|
* <<_deployment>>
|
|
|
|
|
* <<_description>>
|
|
|
|
|
* <<_configuration>>
|
|
|
|
|
* <<_database>>
|
|
|
|
|
* <<_managing_mote>>
|
|
|
|
|
* <<_suspending_mote_operation>>
|
|
|
|
|
* <<_changing_motes_name_and_category_definitions>>
|
2021-07-26 10:39:47 +02:00
|
|
|
|
|
|
|
|
== Contact Information
|
|
|
|
|
|
|
|
|
|
Owner::
|
|
|
|
|
cydrobolt
|
|
|
|
|
Contact::
|
|
|
|
|
#fedora-admin
|
|
|
|
|
Location::
|
|
|
|
|
Fedora Infrastructure
|
|
|
|
|
Purpose::
|
2023-12-20 11:15:46 -08:00
|
|
|
matrix meeting coordination
|
2021-07-26 10:39:47 +02:00
|
|
|
|
|
|
|
|
== Deployment
|
|
|
|
|
|
|
|
|
|
If you have access to rbac-playbook:
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
sudo rbac-playbook groups/value.yml
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
== Forcing Reload
|
|
|
|
|
|
|
|
|
|
There is a playbook that can force mote to update its cache in case it
|
|
|
|
|
gets stuck somehow:
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
sudo rbac-playbook manual/rebuild/mote.yml
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
== Doing Upgrades
|
|
|
|
|
|
|
|
|
|
Put a new copy of the mote rpm in the infra repo and run:
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
sudo rbac-playbook manual/upgrade/mote.yml
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
== Description
|
|
|
|
|
|
|
|
|
|
mote is a Python webapp running on Flask with mod_wsgi. It can be used
|
|
|
|
|
to view past logs, browse meeting minutes, or glean other information
|
2023-12-20 11:15:46 -08:00
|
|
|
relevant to Fedora's matrix meetings. It employs a JSON file store cache,
|
2021-07-26 10:39:47 +02:00
|
|
|
in addition to a memcached store which is currently not in use with
|
|
|
|
|
Fedora infrastructure.
|
|
|
|
|
|
|
|
|
|
== Configuration
|
|
|
|
|
|
|
|
|
|
mote configuration is located in `/etc/mote/config.py`. The
|
|
|
|
|
configuration contains all configurable items for all mote services.
|
|
|
|
|
Alterations to configuration that aren't temporary should be done
|
|
|
|
|
through ansible playbooks. Configuration changes have no effect on
|
|
|
|
|
running services -- they need to be restarted, which can be done using
|
|
|
|
|
the playbook.
|
|
|
|
|
|
|
|
|
|
== Database
|
|
|
|
|
|
|
|
|
|
mote does not currently utilise any databases, although it uses a file
|
|
|
|
|
store in Fedora Infrastructure and has an optional memcached store which
|
|
|
|
|
is currently unused.
|
|
|
|
|
|
|
|
|
|
== Managing mote
|
|
|
|
|
|
2021-09-07 14:10:07 +02:00
|
|
|
mote is ran using mod_wsgi and `httpd`, hence, you must manage the `httpd`
|
2021-07-26 10:39:47 +02:00
|
|
|
service to change mote's status.
|
|
|
|
|
|
2021-09-07 14:10:07 +02:00
|
|
|
== Suspending mote operation
|
2021-07-26 10:39:47 +02:00
|
|
|
|
|
|
|
|
mote can be stopped by stopping the `httpd` service:
|
|
|
|
|
|
|
|
|
|
....
|
|
|
|
|
service httpd stop
|
|
|
|
|
....
|
|
|
|
|
|
|
|
|
|
== Changing mote's name and category definitions
|
|
|
|
|
|
|
|
|
|
mote uses a set of JSON name and category definitions to provide
|
|
|
|
|
friendly names, aliases, and listings on its interface. These
|
|
|
|
|
definitions can be located in mote's GitHub repository, and need to be
|
|
|
|
|
pulled into ansible in order to be deployed.
|
|
|
|
|
|
|
|
|
|
These files are `name_mappings.json` and `category_mappings.json`. To
|
|
|
|
|
deploy an update to these definitions, place the updated name and
|
2021-09-07 14:10:07 +02:00
|
|
|
category mapping files in
|
|
|
|
|
https://pagure.io/fedora-infra/ansible/blob/main/f/roles/mote/templates[ansible/roles/mote/templates].
|
|
|
|
|
Run the playbook in order to deploy your changes.
|
