ARK2/Install - Revision history

John Layt: /* Debian Stable (Stretch) */

2021-09-22T11:58:50Z

‎Debian Stable (Stretch)

John Layt: /* macOS */

2021-09-21T17:05:27Z

‎macOS

John Layt: /* macOS */

2021-09-21T17:04:54Z

‎macOS

John Layt: /* Install */

2018-11-01T19:55:14Z

‎Install

John Layt: /* Environment */

2018-11-01T19:52:45Z

‎Environment

John Layt: /* Git / GitLab */

2018-11-01T19:50:55Z

‎Git / GitLab

John Layt: /* Install */

2018-01-07T15:59:26Z

‎Install

John Layt: /* Install */

2018-01-07T15:57:45Z

‎Install

John Layt: /* macOS */

2018-01-07T10:45:44Z

‎macOS

John Layt: /* macOS */

2018-01-07T10:43:58Z

‎macOS

@@ Line 85: / Line 85: @@
 * Point your browser to localhost/phpmyadmin and sign in to confirm that PHP and MariaDB are running correctly
-=== Debian Stable (Stretch) ===
+=== Debian ===
-Debian Stretch ships with PHP 7.0 by default, but also enables the parallel install of other PHP versions using PHP-FM. PHP 5.6 and 7.1 are not in the official repositories, but the Debian maintainer has made them available in his repo pending their being pushed to Debian Backports. LP Archaeology use this combination for our servers and we strongly recommend you use this method for both simplicity and reliability.
+Since Debian Stretch, Debian has enabled the parallel install of multiple PHP versions using PHP-FM. However each release of Debian ships with a different default version and only that version is officially supported in that release. In order to install other versions such as PHP 5.6 and 7.4 you need to use the packages made available by the Debian Maintainer in his personal development repo. Check your version of Debian to determine what you need. LP Archaeology use this solution for our servers and we strongly recommend you use this method for both simplicity and reliability.
 Instructions for NodeJS: https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions
-Instructions for PHP 7.1: https://packages.sury.org/php/README.txt.  See also https://github.com/oerdnj/deb.sury.org/wiki/Managing-Multiple-Versions
+Instructions for adding PHP repo: https://packages.sury.org/php/README.txt.  See also https://github.com/oerdnj/deb.sury.org/wiki/Managing-Multiple-Versions
-Summary of install commands
+ sudo apt-get install build-essential git apache2 mariadb-client mariadb-server
-  sudo apt-get install build-essential git apache2 mariadb-client mariadb-server \
+  sudo apt-get install php7.4 php7.4-apcu php7.4-apcu-bc php7.4-bcmath php7.4-bz2 php7.4-cli php7.4-common php7.4-fpm php7.4-gd \
- php7.1 php7.1-bcmath php7.1-bz2 php7.1-cli php7.1-common php7.1-enchant php7.1-fpm php7.1-gd php7.1-intl \
+   php7.4-geoip php7.4-imagick php7.4-intl php7.4-json php7.4-mbstring php7.4-mysql php7.4-opcache php7.1-readline php7.4-sqlite3 \
- php7.1-json php7.1-mbstring php7.1-mcrypt php7.1-mysql php7.1-opcache php7.1-readline php7.1-sqlite3 \
+   php7.4-tidy php7.4-uuid php7.4-yaml php7.4-xml php7.4-zip phpmyadmin php-pear
   curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
@@ Line 110: / Line 109: @@
 Enabled FPM
-  sudo service php7.1-fpm start
+  sudo service php7.4-fpm start
-  sudo systemctl enable  php7.1-fpm
+  sudo systemctl enable  php7.4-fpm
-  sudo a2enconf php7.1-fpm
+  sudo a2enconf php7.4-fpm
   sudo a2enmod proxy_fcgi rewrite
@@ Line 160: / Line 159: @@
    </VirtualHost>
-  sudo a2ensite dime
+  sudo a2ensite mysite
   sudo apache2ctl -t

@@ Line 82: / Line 82: @@
   brew services start httpd
 </pre>
-* Point your browser to localhost:8080 and you should see the default Apache page
+* Point your browser to localhost and you should see the default Apache page
-* Point your browser to localhost:8080/phpmyadmin and sign in to confirm that PHP and MariaDB are running correctly
+* Point your browser to localhost/phpmyadmin and sign in to confirm that PHP and MariaDB are running correctly
 === Debian Stable (Stretch) ===

@@ Line 37: / Line 37: @@
 * Install the required packages from Brew:
 <pre>
-  brew install httpd
+  brew install httpd mariadb imagemagick icu4c
-  brew install mariadb
+  brew install php@7.4
-  brew install php71 php71-imagick php71-intl php71-opcache php71-xdebug
+  pecl install apcu imagick xdebug
-  brew install composer php-code-sniffer php-cs-fixer phpdocumentor phplint phpmyadmin
+  brew install composer php-code-sniffer php-cs-fixer@2 phpdocumentor phplint phpmyadmin
-  brew install nodejs
+  brew install node@14
 </pre>
 * Modify /usr/local/etc/httpd/httpd.conf to enable PHP-FPM, aliases, vhosts and rewrite by uncommenting the following lines:
@@ Line 79: / Line 79: @@
 <pre>
   brew services start mariadb
-  brew services start php71
+  brew services start php@7.4
   brew services start httpd
 </pre>

@@ Line 176: / Line 176: @@
   mkdir -p /srv/www/lib
   cd /srv/www/lib
-  git clone https://github.com/lparchaeology/ark2.git
+  git clone https://gitlab.com/arklab/arkserver.git
-Alternatively download and unzip the file from https://github.com/lparchaeology/ark2
+Alternatively download and unzip the file from https://gitlab.com/arklab/arkserver
 Then run composer to install the required PHP libraries:
-  cd ark2/
+  cd arkserver/
   composer install
   <may need github token...>

@@ Line 39: / Line 39: @@
   brew install httpd
   brew install mariadb
   brew install php71 php71-imagick php71-intl php71-opcache php71-xdebug
   brew install composer php-code-sniffer php-cs-fixer phpdocumentor phplint phpmyadmin

@@ Line 3: / Line 3: @@
 == Git / Github ==
-Development is hosted on [https://github.com/lparchaeology Github], so you will need a free Github account to contribute code.
+Development is hosted on [https://gitlab.com/arklab GitLab], so you will need a free GitLab account to contribute code.
-If you are new to Git, you may find the [https://desktop.github.com/ Github desktop application] easier to use. Alternatives are [https://www.sourcetreeapp.com/ SourceTree] and [https://www.gitkraken.com/ GitKraken].
+If you are new to Git, you may find a desktop application easier to use such as [https://www.sourcetreeapp.com/ SourceTree] and [https://www.gitkraken.com/ GitKraken], or the support built-in to your IDE like Atom.
 == Environment ==

@@ Line 213: / Line 213: @@
 If not using vhosts, for local development, edit your Apache config to alias the site folder:
-  Alias /path/to/ark2/sites/<mysite>/web
+  Alias /<site> /path/to/ark2/sites/<site>/web
   <Directory /path/to/ark2/sites/<mysite>/web>
       Options Indexes FollowSymLinks MultiViews
@@ Line 224: / Line 224: @@
 To rebuild the frontend
   cd build
-  ./build env:install
+  npm install
   ./build frontend:all <frontend>

@@ Line 209: / Line 209: @@
   vim sites/<site>/config/site.json
-If using vhosts or aliases to serve the site, see above for instructions.
+If using vhosts, see above for instructions.
   http://localhost/<site>

@@ Line 53: / Line 53: @@
 </pre>
 * Add the following after the DocumentRoot section to enable PhpMyAdmin:
 Alias /phpmyadmin /usr/local/share/phpmyadmin
 <Directory /usr/local/share/phpmyadmin/>
@@ Line 59: / Line 60: @@
      Require all granted
 </Directory>
 * Modify the DirectoryIndex section to appear as follows:
 <pre>

@@ Line 22: / Line 22: @@
 === macOS ===
-On macOS, while you can install the requirements via standalone packages such as [https://www.mamp.info/en/ MAMP], we recommend using HomeBrew as it makes installing and updating all the tools used easier.
+On macOS, while you can install the requirements via standalone packages such as [https://www.mamp.info/en/ MAMP], we recommend using HomeBrew as it makes installing and updating all the tools used easier. Using macOS is only recommended for local hosting or development purposes only, internet-connected production sites should be run on a properly supported server installation, such as Debian Stretch.
 * Install XCode from the App Store and run it to accept the license, or from the command line: <pre>sudo xcodebuild -license accept</pre>
@@ Line 44: / Line 44: @@
   brew install nodejs
 </pre>
 === Debian Stable (Stretch) ===