Problem: It is tricky to get ronn running on CentOS during dev-tools phase of ansible playbook

[ross-spencer]

Expected behaviour

dev-tools can be deployed using ansible.

Current behaviour

ruby-ronn is used to build the dev-tools manual pages. It can currently be installed pretty easily at the user-level, but with elevated privileges like those required by ansible, we're seeing a few problems:

[root@analyst-ross-vm ~]# ronn
cannot load such file -- rdiscount.so

Steps to reproduce

Run the CentOS playbook on a new CentOS VM and observe that it will fail when it gets to the point of trying to first run ronn and then building the pages.

Your environment (version of Archivematica, operating system, other relevant details)

/etc/system-release
CentOS Linux release 7.6.1810 (Core) 

Workaround

@scollazo and @mamedin suggested three workarounds, I followed one:

1. Install nodejs-ronn manually:

   yum install nodejs-ronn
   ln -s /usr/bin/ronn-nodejs /usr/local/bin/ronn

2. Don't install dev-tools:

   ansible-playbook -i hosts <your-playbook> --limit <your-env> --extra-vars="archivematica_devtools_install=false"

3. Remove doc recipe from MakeFile: here

Relates to https://github.com/archivematica/Issues/issues/68

---

For Artefactual use:

Before you close this issue, you must check off the following:

• [ ] All pull requests related to this issue are properly linked
• [ ] All pull requests related to this issue have been merged
• [ ] A testing plan for this issue has been implemented and passed (testing plan information should be included in the issue body or comments)
• [ ] Documentation regarding this issue has been written and merged
• [ ] Details about this issue have been added to the release notes (if applicable)

[scollazo]

ronn is used to generate manpages that, afaik , are pretty outdated. I think we could get rid of those, and point people to the archivematica-docs

[mamedin]

But ansible-archivematica-src role is failing now. The gem ansible module is not working fine:

https://github.com/artefactual-labs/ansible-archivematica-src/blob/stable/1.11.x/tasks/am-devtools.yml#L36-L43