move install script into ./scripts ; update Instructions

Author: tr-electronic-edv

INSTALL/INSTALL.ubuntu2404.md

@@ -6,7 +6,7 @@ Installation on Ubuntu 24.04
 Install some utilities, database, webserver
 ```bash
 sudo apt update
-sudo apt-get install -y curl jq mariadb-client mariadb-server apache2
+sudo apt-get install -y zip unzip git gettext curl jq mariadb-client mariadb-server apache2
 ```
 
 Install PHP and its dependencies (the default php version in Ubuntu 24.04 is php8.3):
@@ -16,7 +16,7 @@ sudo apt-get install -y php php-cli php-common php-mysql php-zip php-gd php-mbst
 
 # 2. Monarc files
 
-Run the [get_and_unpack_the_latest_release.sh](./get_and_unpack_the_latest_release.sh) script with `sudo`
+Run the [install_latest_fo_release.sh](../scripts/install_latest_fo_release.sh) script with `sudo`
  to download the latest Monarc release and unpack it into `/var/lib/monarc/`.
 
 > The script is built to be used in the CI/CD pipelines and will fail with a clear error if the release is not reachable or the deploy directory already exits.
@@ -169,11 +169,9 @@ Configure the database connection (use the secured password set on the DB user c
 ## 4.5 Migrate the MONARC DB
 
 ```bash
-php ./vendor/robmorgan/phinx/bin/phinx migrate -c module/Monarc/FrontOffice/migrations/phinx.php
-php ./vendor/robmorgan/phinx/bin/phinx migrate -c module/Monarc/Core/migrations/phinx.php
+bash ./scripts/upgrade-db.sh
 ```
 
-
 ## 4.6 Create initial user
 
 ```bash

INSTALL/UPDATE.ubuntu.md

@@ -19,6 +19,9 @@ curl -sL $MONARCFO_RELEASE_URL -o /var/lib/monarc/releases/`basename $MONARCFO_R
 mkdir /var/lib/monarc/releases/`basename $MONARCFO_RELEASE_URL | sed 's/.tar.gz//'`
 # Unarchive the release:
 tar -xzf /var/lib/monarc/releases/`basename $MONARCFO_RELEASE_URL` -C /var/lib/monarc/releases/`basename $MONARCFO_RELEASE_URL | sed 's/.tar.gz//'`
+# Copy existing configuration to the new release.
+cp "$PATH_TO_MONARC/config/autoload/local.php" \
+   "/var/lib/monarc/releases/`basename $MONARCFO_RELEASE_URL | sed 's/.tar.gz//'`/config/autoload/local.php"
 # Update the release symlink:
 ln -sfn /var/lib/monarc/releases/`basename $MONARCFO_RELEASE_URL | sed 's/.tar.gz//'` $PATH_TO_MONARC
 # Migrate the DB:

INSTALL/get_and_unpack_the_latest_release.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+BASEDIR="/var/lib/monarc"
+RELEASES="$BASEDIR/releases"
+APP_LINK="$BASEDIR/fo"
+DATA_DIR="$BASEDIR/fo-data"
+
+function error() { echo "Error: $1" > /dev/stderr; exit 1; }
+
+# ensure no existing release is present
+if [ -f "$APP_LINK/config/autoload/local.php" ]; then
+    echo "Existing Monarc installation found! Run the UPDATE script instead:";
+    echo "    https://github.com/monarc-project/MonarcAppFO/blob/master/INSTALL/UPDATE.ubuntu.md";
+    error "Aborting installation.";
+fi
+
+# Ensure base directories exist
+mkdir -p "$RELEASES" "$DATA_DIR"/{cache,DoctrineORMModule/Proxy,LazyServices/Proxy,import/files}
+
+# Get latest version
+VERSION=$(curl -s https://api.github.com/repos/monarc-project/MonarcAppFO/releases/latest | jq -r '.tag_name')
+if [ -z "$VERSION" ] || [ "$VERSION" = "null" ]; then
+    error "Failed to resolve app release version"
+fi
+RELEASE_NAME="MonarcAppFO-${VERSION}"
+ARCHIVE_URL="https://github.com/monarc-project/MonarcAppFO/releases/download/${VERSION}/${RELEASE_NAME}.tar.gz"
+
+# Extraction target
+TARGET_DIR="$RELEASES/$RELEASE_NAME"
+test -d "$TARGET_DIR" && error "$TARGET_DIR already exists!"
+mkdir -p "$TARGET_DIR"
+
+echo "Downloading the latest Monarc version $VERSION"
+# --strip-components=1 prevents the "folder inside a folder" issue
+curl -L "$ARCHIVE_URL" | tar -xzf - -C "$TARGET_DIR" --strip-components=1
+
+# if data folder exist in release - remove it to allow symlink
+rm -rf "$TARGET_DIR/data"
+# Link data folder into release folder
+ln -sfn "$DATA_DIR" "$TARGET_DIR/data"
+
+# Link the release into the app folder
+ln -sfn "$TARGET_DIR" "$APP_LINK"
+
+# change owner
+chown -R www-data:www-data /var/lib/monarc
+
+echo "Monarc version $VERSION files was installed successfully!"
+echo "No database or web-server configuration changes were made."
+echo "Follow the installation instruction for the next steps."