Greenmine/install: Difference between revisions

From Woozle Writes Code
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:


I'll use the following shorthand:
I'll use the following shorthand:
* '''{{arg|www}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>)
* '''{{arg|$HOME}}''' = the home folder for all of the domain-user's files
* '''{{arg|gm}}''' = the Greenmine base folder (I usually put it at ~/site/git/greenmine
* '''{{arg|$WEB}}''' = the public HTML folder (typically <code>public_html</code> or <code>www</code>) inside {{arg|$HOME}}
* '''{{arg|uhome}}''' = the home folder for the domain's files (outside of {{arg|www}})
* '''{{arg|$ft}}''' = the Ferreteria base folder (My convention: {{arg|$HOME}}/site/git/ferreteria)


{|
See [[conventions/vdomain]] for more explanation.
 
{| border=1
|-
|-
! Action / Intention !! Example Commands
! Action / Intention !! Commands !! Where You End Up
|-
|-
| Set up folder structure
| Set up folder structure
|
|-
cd {{arg|uhome}}
| || cd {{arg|uhome}} || {{arg|uhome}}
|-
| ||
  mkdir site
  mkdir site
  cd site
  cd site
  mkdir git
  mkdir git
cd git
| {{arg|uhome}}/site/git
|-
|-
| Install Greenmine & Ferreteria
| Install Greenmine & Ferreteria
|
|
cd git
  git clone git@gitlab.com:woozalia/greenmine.git
  git clone git@gitlab.com:woozalia/greenmine.git
| {{arg|uhome}}/site/git
|-
| colspan=3 | Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
|-
| || <code>ln -sv greenmine/ferreteria
|-
| colspan=3 | [[htyp:Ferreteria/install|Install Ferreteria]] (skip the <code>git clone</code> step; we've already done that here).
|-
| colspan=3 | Set up more folder structure: config folders
|-
| || <code>cd {{arg|uhome}}/site</code> || {{arg|uhome}}/site
|-
| ||
mkdir config
cd config
mkdir greenmine
cd greenmine
mkdir portable
| {{arg|uhome}}/site/config/greenmine/portable
|-
| colspan=3 | Make soft links from <code>{{arg|gm}}/config/portable/*</code> to <code>{{arg|uhome}}/config/greenmine/portable/</code>.
|-
|-
| Make soft links from <code>www</code> to <code>greenmine/
| IN PROGRESS
ln -sv ../../../
|}
|}


Revision as of 17:42, 11 November 2021

The previous draft of installation instructions is here, for reference. Ferreteria is now included as a submodule of Greenmine, which affects folder locations and negates the need to clone it separately.

I'll use the following shorthand:

  • <$HOME> = the home folder for all of the domain-user's files
  • <$WEB> = the public HTML folder (typically public_html or www) inside <$HOME>
  • <$ft> = the Ferreteria base folder (My convention: <$HOME>/site/git/ferreteria)

See conventions/vdomain for more explanation.

Action / Intention Commands Where You End Up
Set up folder structure
cd <uhome> <uhome> 
mkdir site
cd site
mkdir git
cd git
<uhome>/site/git
Install Greenmine & Ferreteria 
git clone git@gitlab.com:woozalia/greenmine.git
<uhome>/site/git
Link to Ferreteria from a standard location, so we can use the standard Ferreteria installation instructions.
ln -sv greenmine/ferreteria
Install Ferreteria (skip the git clone step; we've already done that here).
Set up more folder structure: config folders
cd <uhome>/site <uhome>/site 
mkdir config
cd config
mkdir greenmine
cd greenmine
mkdir portable
<uhome>/site/config/greenmine/portable
Make soft links from <gm>/config/portable/* to <uhome>/config/greenmine/portable/.
IN PROGRESS 
ln -sv ../../../

documentation in progress

TODO: document creation of database and tables

Retrieved from "https://wooz.dev/mw/index.php?title=Greenmine/install&oldid=913"