Documentation: How to build a Multisite in ISLE

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: How to build a Multisite in ISLE #372

Open bondjimbond opened 4 years ago

bondjimbond commented 4 years ago

Issue description

Multisites are possible in ISLE, but the documentation for how to build them does not exist. I have a collection of steps from @dwk2, but they are incomplete.

Steps collected so far

TRANSFER MYSQL DATABASES (from production to local)
- Can be found in the basic migration docs
TRANSFER live rsync'ed /html/ from isle-dev to Local
- More or less found in the basic migration docs? But we need a way to create new multisites (not just migrating existing ones)
MySQL Commands: Backup all databases
- Found in the basic migration docs
Step 9: Import the Production MySQL Drupal database on your local ISLE
- Found in basic migration docs
SSH KEY GENERATION:
- Unclear
CREATE SYMLINKS FOR ALL SITES
- Very unclear how exactly this works

Missing: Fedora Drupal filter, fixing the Hosts file to correctly incoming requests, setting up VHosts, probably some others??

I have tried following the directions I have, but cannot get any further than a 404.

dwk2 commented 4 years ago

re: How to create new multisites: Please see this method: https://github.com/Islandora-Collaboration-Group/drush-sitespinner

bondjimbond commented 4 years ago

@dwk2 Trying this now... Instructions unclear.

Copy the provided sample alias file to ~/.drush/ (note: alias files are typically installed here, and the full path will resolve approximately to: /home/islandora/.drush/) cp sitespinner/examples/sitespinner-sample.aliases.drushrc.php ~/.drush/sitespinner-sample.aliases.drushrc.php

Result: cp: cannot create regular file '/root/.drush/sitespinner-sample.aliases.drushrc.php': No such file or directory

There is no ~/.drush/ directory in the ISLE Apache container... so where should it go?

bondjimbond commented 4 years ago

I'm getting stymied by various inconsistencies in the Sitespinner docs vs. the ISLE environment.

First:

in ISLE there is no drush/commands folder.
which drush gets you /usr/local/bin/drush
There's no drush directory
So is Sitespinner just installed to /usr/local/bin/sitespinner?

Assuming that /usr/local/bin/sitespinner works, I have cloned it there. However...

Assuming it is, I have cloned it there.. The only user allowed to work there is root (which is the user that you come into the container as anyway, in a local install). So following those steps, I try the command drush sitespinner @sitespinner-mysite.template @sitespinner-mysite.mysite and I get the error sh: 1: sudo: not found - because I'm already root, and root can't sudo.

Removing sudo from all the commands in sitespinner.drush.inc doesn't do anything; I guess the commands are cached somehow? And drush cc doesn't fix it; the drush cache is cleared, but the same error comes up.