- Problem after an update
- Not receiving password reset emails
- GitHub token problem during MONARC update
- A blank screen is displayed
- Is it possible for a back office administrator to change the administrator user of a MONARC instance?
- Adding a new administrator without access to the MONARC Web interface
Problem after an update
After an update you may need to delete the cache of MONARC. For example if you noticed that the version number of MONARC, in the left menu, is wrong or MONARC still says that it is not up-to-date.
- delete the cache of MONARC in the folder
Not receiving password reset emails
This is very unlikely a problem of MONARC.
Check the logs in the files /var/log/syslog and /var/log/mail.log.
- check the configuration of Postfix (/etc/postfix/main.cf) on the MONARC server. Especially the address of the SMTP relay server (the line starting with relayhost);
- check the configuration of your SMTP relay server. Most of the time a rule will block the sending of the email.
GitHub token problem during MONARC update
Because of GitHub’s rate limits on their API it can happen that Composer prompts for authentication asking your token so it can go ahead with its work.
The best solution is to generate your own token and store it on the server:
- Create an OAuth token on GitHub;
- Add it to the configuration running
composer config -g github-oauth.github.com <oauthtoken>. Do this on the MONARC server and on the MONARC back office server.
A blank screen is displayed
A blank screen is generally caused by a faulty database connection.
- check manually the connection to the database;
- check the Apache error logs for database related problems. This can also be caused by a PHP library (for example Doctrine). In this case launch again the update script (scripts/update-all.sh) then delete the cache of MONARC.
Is it possible for a back office administrator to change the administrator user of a MONARC instance?
The answer is no. This is a design choice that has been made for security reason. An administrator of the back office is only able to create and delete MONARC instances (clients) on a MONARC server. The administrator has no access to the MONARC instances.
A minimum of one administrator per MONARC instance is recommended. The management of users on a specific MONARC instance is the responsibility of administrator of the instance. The administrator of the back office should not be responsible of this.
Adding a new administrator without access to the MONARC Web interface
Considering, for example, that an employee with administrator rights on MONARC recently left the company.
You must have a SSH access to the server where MONARC is installed.
If you are using MONARC without back office, simply run this command at the root of MONARC:
$ php ./vendor/robmorgan/phinx/bin/phinx seed:run -c ./module/MonarcFO/migrations/phinx.php
This will create a new administrator account with the login firstname.lastname@example.org and the password admin.
If you are using a back office, as explained in the previous section, it is not
possible to change the administrator of a MONARC instance or to add a new one.
Clients databases are separated.
A simple solution would be to update the email address of the former administrator directly in the client database (on the FO server), with your own email address. Then you will be able to use the password recovery feature of MONARC.