Skip to content

Commit

Permalink
More minor installation docs formatting/consistency edits (#2333)
Browse files Browse the repository at this point in the history
* fix note

* Fix ubuntu version used

* Update installing-crayfish.md
  • Loading branch information
seth-shaw-asu committed Jul 17, 2024
1 parent 5ba7739 commit d2d7cfa
Show file tree
Hide file tree
Showing 3 changed files with 6 additions and 7 deletions.
5 changes: 2 additions & 3 deletions docs/installation/manual/installing-crayfish.md
Original file line number Diff line number Diff line change
Expand Up @@ -289,9 +289,8 @@ Finally, we need appropriate Apache configurations for Crayfish; these will allo

Each endpoint we need to be able to connect to will get its own `.conf` file, which we will then enable.

**NOTICE**

These configurations would potentially have collisions with Drupal routes, if any are created in Drupal with the same name. If this is a concern, it would likely be better to reserve a subdomain or another port specifically for Crayfish. For the purposes of this installation guide, these endpoints will suffice.
!!! warning "Possible Route Collisions"
These configurations would potentially have collisions with Drupal routes, if any are created in Drupal with the same name. If this is a concern, it would likely be better to reserve a subdomain or another port specifically for Crayfish. For the purposes of this installation guide, these endpoints will suffice.

`/etc/apache2/conf-available/Homarus.conf | root:root/644`
```
Expand Down
4 changes: 2 additions & 2 deletions docs/installation/manual/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
!!! notice
The manual installation guide is not intended to describe *the* Islandora installation but rather *an* Islandora installation. The server created using this guide is not hardened, will not be easily scalable, and the components may not be configured in a way you consider easy to work with. A production instance of Islandora should be installed and maintained by a professional with an understanding of Linux and server administration.

This guide will contain generalized steps on installation and configuration of the various components, but will contain specific example commands for executing these steps on an Ubuntu 18.04 Server.
This guide will contain generalized steps on installation and configuration of the various components, but will contain specific example commands for executing these steps on an Ubuntu 20.04 Server.

## Some Prerequisite Knowledge

Expand Down Expand Up @@ -115,4 +115,4 @@ The most common issues you will likely run into when manually provisioning a ser
- Files or directories are not owned by the user who needs access to them, and can therefore not be written to. Check the ownership of files using `ls -la`, and ensure their ownership using `chown USER` for files, and `chown -R USER` for directories
- Replacement variables were left in place in files specified by the guide. Ensure any replacement variables such as server addresses and passwords are swapped out when writing files to the server

For any other issues, don't hesitate to email the [mailing list](mailto:[email protected]) to ask for help. If you think that a part of the installation documentation is incorrect or could be improved, please create an issue in the [documentation issues queue](http://github.com/Islandora/documentation/issues) and give it a `documentation` tag. Bear in mind that this guide is built for Ubuntu 18.04 and attempts to give generalized instructions; you will likely naturally encounter situations where your own environment needs to differ from the guide.
For any other issues, don't hesitate to email the [mailing list](mailto:[email protected]) to ask for help. If you think that a part of the installation documentation is incorrect or could be improved, please create an issue in the [documentation issues queue](http://github.com/Islandora/documentation/issues) and give it a `documentation` tag. Bear in mind that this guide is built for Ubuntu 20.04 and attempts to give generalized instructions; you will likely naturally encounter situations where your own environment needs to differ from the guide.
4 changes: 2 additions & 2 deletions docs/installation/manual/preparing-a-webserver.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ sudo su `whoami`

## PHP 8.x

!! note "Installing Alternate Versions"
!!! note "Installing Alternate Versions"
Although the instructions below will install PHP 8.3, the instructions should work for future versions by replacing the `8.3` with whatever version you are attempting to install.

### Install PHP 8.x
Expand Down Expand Up @@ -114,4 +114,4 @@ sudo service mysql status # press "q" to exit
sudo ss -tap | grep mysql
sudo service mysql restart
sudo journalctl -u mysql # helps troubleshooting
```
```

0 comments on commit d2d7cfa

Please sign in to comment.