Difference between revisions of "Linux Web Application Installation"

From 360Works Product Documentation Wiki
Jump to navigation Jump to search
Line 1: Line 1:
This page gives general instructions on how to install 360Works web applications onto Ubuntu 20 and 22
+
This page gives general instructions on how to install 360Works web applications onto Ubuntu 20 and 22. These instructions can also be found in the download of the application in a file called Linux Installation Instructions.txt
  
==Prerequisites==
+
          _____  __    ___  __    __          _
1. sudo privileges<br>
+
        |___ / / /_  / _ \/ / /\ \ \___  _ __| | _____
2. The unzip utility installed. You can install it by running the command: <code>sudo apt install unzip</code><br>
+
          |_ \| '_ \| | | \ \/  \/ / _ \| '__| |/ / __|
3.(Optional) A working knowledge of Linux commands<br>
+
          ___) | (_) | |_| |\  /\  / (_) | |  |  <\__ \
 +
        |____/ \___/ \___/  \/  \/ \___/|_|  |_|\_\___/
  
==Instructions==
+
==================Linux Installation Instructions==================
# Download the web application onto your Linux server. You can use any method of doing so, cURL, wget, scp. We recommend downloading to the /tmp directory but anywhere that the file can be written and read from will suffice
+
 
# Unzip the .zip
+
Welcome to the 360Works MirrorSync Linux installer! This document
# Change working directory into the newly created directory. It should have the same name as the .zip
+
will guide you through the process of installing MirrorSync on your
# Run the following command: <code>sudo ./LinuxInstaller.sh</code>
+
Linux server.
# When the installer runs you will be asked a series of questions and then the install will complete
+
 
 +
Pre-Installation Requirements:
 +
------------------------------
 +
 
 +
1. An Ubuntu 20.04 or 22.04 system with either x86_64 or aarch64
 +
architecture (Note: FileMaker only supports aarch64 on Ubuntu 22.04)
 +
 
 +
2. A local SSH client (such as Terminal on macOS or PuTTY on Windows)
 +
 
 +
3. The wget utility (included with most Ubuntu distributions)
 +
 
 +
4. The unzip utility (included with most Ubuntu distributions)
 +
 
 +
5. The following system dependencies:
 +
    openjdk-17-jre-headless
 +
    tomcat9
 +
    tomcat9-admin
 +
 
 +
Step 1: Install required system dependencies
 +
--------------------------------------------
 +
 
 +
Run the following commands:
 +
    sudo apt update
 +
    sudo apt install openjdk-17-jre-headless tomcat9 tomcat9-admin
 +
 
 +
 
 +
Step 2: Obtain the 360Works product bundle
 +
------------------------------------------
 +
 
 +
Option 1: Download directly from 360Works with wget
 +
    a. SSH into your Linux server
 +
        ssh <remote_user>@<remote_host>
 +
    b. change directories to your home directory
 +
        cd ~
 +
    c. run the following command:
 +
        wget "<download_url>"
 +
    d. unzip the downloaded file
 +
        unzip <downloaded_file> -d .
 +
    e. change directories to the unzipped folder
 +
        cd <unzipped_folder>
 +
 
 +
Option 2: Transfer from another machine using scp
 +
    a. On your local machine, run the following command:
 +
        scp <local_file> <remote_user>@<remote_host>:/home/<remote_user>
 +
    b. SSH into your Linux server
 +
        ssh <remote_user>@<remote_host>
 +
    c. change directories to your home directory
 +
        cd ~
 +
    d. unzip the downloaded file
 +
        unzip <downloaded_file> -d .
 +
    e. change directories to the unzipped folder
 +
        cd <unzipped_folder>
 +
 
 +
 
 +
Step 3: Make the installer script executable
 +
--------------------------------------------
 +
 
 +
Run the following command:
 +
    chmod +x LinuxInstaller.sh
 +
 
 +
Step 4: Run the installer script
 +
--------------------------------
 +
 
 +
Run the following command:
 +
    sudo ./LinuxInstaller.sh
 +
 
 +
Step 5: Follow the on-screen instructions
 +
-----------------------------------------

Revision as of 18:50, 9 June 2023

This page gives general instructions on how to install 360Works web applications onto Ubuntu 20 and 22. These instructions can also be found in the download of the application in a file called Linux Installation Instructions.txt

         _____  __    ___  __    __           _
        |___ / / /_  / _ \/ / /\ \ \___  _ __| | _____
          |_ \| '_ \| | | \ \/  \/ / _ \| '__| |/ / __|
         ___) | (_) | |_| |\  /\  / (_) | |  |   <\__ \
        |____/ \___/ \___/  \/  \/ \___/|_|  |_|\_\___/
============Linux Installation Instructions============

Welcome to the 360Works MirrorSync Linux installer! This document will guide you through the process of installing MirrorSync on your Linux server.

Pre-Installation Requirements:


1. An Ubuntu 20.04 or 22.04 system with either x86_64 or aarch64 architecture (Note: FileMaker only supports aarch64 on Ubuntu 22.04)

2. A local SSH client (such as Terminal on macOS or PuTTY on Windows)

3. The wget utility (included with most Ubuntu distributions)

4. The unzip utility (included with most Ubuntu distributions)

5. The following system dependencies:

   openjdk-17-jre-headless
   tomcat9
   tomcat9-admin

Step 1: Install required system dependencies


Run the following commands:

   sudo apt update
   sudo apt install openjdk-17-jre-headless tomcat9 tomcat9-admin


Step 2: Obtain the 360Works product bundle


Option 1: Download directly from 360Works with wget

   a. SSH into your Linux server
       ssh <remote_user>@<remote_host>
   b. change directories to your home directory
       cd ~
   c. run the following command:
       wget "<download_url>"
   d. unzip the downloaded file
       unzip <downloaded_file> -d .
   e. change directories to the unzipped folder
       cd <unzipped_folder>

Option 2: Transfer from another machine using scp

   a. On your local machine, run the following command:
       scp <local_file> <remote_user>@<remote_host>:/home/<remote_user>
   b. SSH into your Linux server
       ssh <remote_user>@<remote_host>
   c. change directories to your home directory
       cd ~
   d. unzip the downloaded file
       unzip <downloaded_file> -d .
   e. change directories to the unzipped folder
       cd <unzipped_folder>


Step 3: Make the installer script executable


Run the following command:

   chmod +x LinuxInstaller.sh

Step 4: Run the installer script


Run the following command:

   sudo ./LinuxInstaller.sh

Step 5: Follow the on-screen instructions