Islandora-Collaboration-Group / ISLE

Islandora Enterprise (ISLE) is a community project that addresses two of the most significant pain-points in Islandora: installation and maintenance.
https://Islandora-Collaboration-Group.github.io/ISLE/
GNU General Public License v3.0
32 stars 34 forks source link

Documentation change requests #85

Closed dwk2 closed 6 years ago

dwk2 commented 6 years ago

Documentation change requests from an ISLE install test on December 19, 2017, on a new vm:

This section of documentation tweaks is from this URL:

1) DOC: adduser islandora (with password isle2017) CORRECTION: must also state how to set password! Existing text: adduser islandora (with password isle2017) add code format: adduser islandora passwd islandora isle2017

2) DOC: Create Docker group groupadd docker RESULT: groupadd: group 'docker' already exists

3) DOC: Add islandora user to wheel grop sudo usermod -aG wheel islandora TYPO: grop = group, right?

4) DOC: Exit out of the ssh session from the host server as the root user and shell back in as islandora SUGGESTION: Break this into two statements: Exit out of the ssh session from the host server as the root user exit SSH into host server as islandora

5) SUGGESTION: At very extreme end of "1.4. -Testing - Host Server Build - Centos" (and the other flavors, do this too), put an instruction (and hyperlink) to return to the "1.4. -Testing - Alpha Quickstart Guide"

https://islandora-collaboration-group.github.io/ISLE/1_system_process_overview/1_4_testing/alpha_quickstart/

6) DOC: The instruction that follows is confusing, as the quickstart guide never says when to run this command, only when not to run it. DO NOT RUN docker-compose up -d during the initial install process RESULT: initially, while counter-intuitive, I opted to not run any containers! That's not the result we want from that warning message above.

7) DOC: docker pull islandoracollabgroup/isle-mysql RESULT: failed to register layer: ApplyLayer exit status 1 stdout: stderr: write /usr/share/perl/5.24.1/Locale/Codes/Language_Codes.pm: no space left on device

8) DOC: docker pull islandoracollabgroup/isle-fedora RESULT: failed to register layer: ApplyLayer exit status 1 stdout: stderr: write /usr/share/perl/5.24.1/Locale/Codes/Language_Codes.pm: no space left on device

9) DOC: docker pull islandoracollabgroup/isle-apache RESULT: failed to register layer: ApplyLayer exit status 1 stdout: stderr: write /usr/lib/jvm/java-8-oracle/jre/lib/amd64/libjfxwebkit.so: no space left on device

NOTE: Discovered flaw in our (Williams) server setup. requested that our mount be repartition to be "/opt" instead of "/opt/isle". This will prevent running out of space on "/opt".

dwk2 commented 6 years ago

Closing this issue. I added documentation and pull requests for PRs 89-93 to cover these updates. I created a new issue #94 that contains the bugs that Gavin will need to fix in the scripts.