PiAnoS Administrator’s Manual

The Administrator’s Manual target two main audiences:

• administrators: persons who install, update and maintain the software

• tutors: persons who use PiAnoS as a teaching tool

Since the responsibilities are not clearly separated (administrators will need to know the interface, tutors will often perform administrative tasks) both perspectives are described together in this manual.

• Installation
  • Super-quick installation
  • Quick install
  • Long install
    • Requirements
    • Step-by-step installation on Docker
    • Step-by-step installation on Debian Linux
    • Step-by-step installation on Windows
    • Web Installer
    • Troubleshooting
• Options
  • skip_mendatory_fields_and_set_default
  • subfolders
  • homeData_as_todo_list
  • progress_bar
  • homeData_show_all_exercises_for_admin
  • show_switchUser
  • anonymous_review
  • show_marker_size_slider
  • show_marker_opacity_slider
  • markCanHaveCenter
  • initialTool
• Getting Started
  • Preparing the images
  • The administration interface
  • Creating a folder and an exercise
  • Creating a group and a user
  • Granting access to the exercise
  • Testing
• The configuration file
  • Settings reference
  • Single sign-on using Shibboleth
• Maintenance
  • General considerations
  • Backing up the database
  • Restoring the database
  • Testing your backup plan
• Upgrading
  • Preparing for upgrade
  • Choosing an upgrade strategy
  • Simple upgrade
  • Production upgrade
• Extras
  • The pianos.py Python module
  • NIST Special Database 27A
    • Background information
    • Prerequisites
    • Downloads
    • Usage
    • Examples