Digital Archive site maintenance

Plugin and Theme updates

To update the plugins and themes folders on all Digital Archive sites:

  • Open a terminal window for using one of these methods:
    • Go to cPanel for and choose Terminal
    • Use PUTTY
  • cd bin

  • Choose one of these commands:

$ sudo ./sync-digitalarchive <site-name> 
$ sudo ./sync-digitalarchive ALL 
$ sudo ./sync-digitalarchive <site-name> installation
  • Type the password for user daus
  • Type an option:
    • y to perform a dry run
    • Y to perform the sync
    • n or any other character to exit
  • Press Enter

Adding the installation argument will also sync:


The output is written to bin/logs/sync-HH-MM-SS.log

Server requests

From a terminal:

  • Choose one of these commands:
remote-request <request> <site-name>
remote-request <request> ALL
  • Requests:

Common vocabulary updates

To update the common vocabulary:

  • Make changes to one or more of the following files:
    • input-translations.csv
    • input-additional-terms.csv
    • input-nomenclature-sortEn_2020-05-18.csv (replace with latest version from Nomenclature)
  • Run
  • Test the changes locally and build again until satisifed
  • When done making changes:
    • Delete local file input-previous-digital-archive-vocabulary.csv
    • Rename local file digital-archive-vocabulary.csv to input-previous-digital-archive-vocabulary.csv
    • Upload digital-archive-vocabulary.csv to
  • Verify that digital-archive-diff.csv file was successfully FTPed to
  • Go to the vocabularly folder on
  • Verify that /vocabulry/data/digital-archive-sites.csv has the correct site information
  • Run python3

It is also possible for a developer to simulate a remote update locally via the query string:


Omeka updates

The Omeka core files are updated by the Omeka team a few times each year.

Instructions to be added here for applying Omeka updates

Running scripts

CRON jobs

Root privileges

A user with root privileges can run bash scripte that modify files on every Digital Archive installation on the server.

To assign a user root privileges via sudo: - Go to WHM and choose Manage Wheel Groupt Users - Add a user to the wheel group

A user in the wheel group can use the system's su and sudo utilities.

Making a script executable

Use the chmod command to make a script file executable. For example, you can make file foo executable with this command:

chmod +x foo

To execute the foo script type:


If a script requires root privileges, use sudo to run it. For example:

sudo ./foo

To add a job:

crontab -e


Increase max execution time

For long running foreground jobs like a reindex, you need to make sure that the PHP max_execution_time is high enough to let the job complete. The default of 30 seconds is usually too low.

  • Go to cPanel
  • In the Software section choose “Select PHP Version”
  • Click “Switch to PHP Options” at upper right
  • Click the value of max_execution_time.
  • Enter a new value, click Apply
  • Click Save

Reset a MySQL table's Auto Increment



where n will be the id for the next record created.