These installation procedures and scripts are not covered by Jalios software support, and only the installation and operation manual produced by the Jalios R&D team is authentic.
However, these procedures have been tested several times by Jalios consultants. We believe it is appropriate to share them with the Jalios community. We are also looking forward to receiving feedback from our technical partners and customers through comments.
File : Jinstall-3.3.1.zip
MD5 : d57ac5996121a0383caa3b8cf2ea1039
SHA1: 6d39b7976f4f44ffbd06cdcef7d6ad5ece231fbd
SHA256: 999133218472b1ed8f53f9049b24e5a95e74854005bbeeec5fcf31d9e9aa55e2
Jinstall is an automatic procedure installing the application components of JPlatform:
This procedure is based on RedHat Ansible, a tool that automates configuration management and application deployment.
Distributions supported by the scripts.
Jinstall Win is the automatic installation procedure dedicated to Microsoft Windows systems.
The package(s) to install via the package manager
python3
: version 3.5 or highersudo
privilegesIn the case of an installation on several instances (front-end, application, services), the entire installation procedure is to be performed on 1 instance only.
This step is only necessary if you are installing on several instances.
To facilitate and automate the remote authentication, we will generate private/public keys for each remote machine.
(If ever done) Generate a private/public key :
ssh-keygen
Then authenticate to create an SSH key with the remote machine (repeat for each remote instance) :
ssh-copy-id -p 22 ssh_user@server.example.com
You can test the authentication :
ssh ssh_user@ssh_user@server.example.com python3 --version
The expectation is no password prompt.
Télécharger l'archive de Jinstall depuis Community.
Download the Jinstall archive from Community.
Extract the archive in a dedicated directory :
mkdir ~/Jinstall
unzip Jinstall-X.Y.Z.zip -d ~/Jinstall
Restrict access rights to the owner of the directory :
chmod 700 ~/Jinstall
Move into the directory:
cd ~/Jinstall
Python packages for installation will be installed via PyPI in a virtual environment (can be removed at the end of the installation).
On Debian & Ubuntu, install these components :
sudo apt install python3-pip python3-venv -y
Create a virtual environment :
python3 -m venv venv_jinstall
Place yourself in the environment :
source venv_jinstall/bin/activate
The appearance of the terminal has been changed accordingly.
Update pip
:
python3 -m pip install --upgrade pip
Install dependencies :
python3 -m pip install -r requirements.txt
You can customize the installation architecture (directory, memory, URL, ...).
Put in the files directory your WAR to deploy and your SSL certificates, to have a HTTPS URL.
Edit the files associated to the different components you want to deploy:
Identify the FQDN (or IP) of the remote servers where to perform the installation.
Installation architecture:
inventory_local.yml
fileinventory_remote.yml
file.Then rename this file to inventory.yml
.
Let's check that the accesses are well established.
Run the ping test command:
ansible all -i inventory.yml -m ping
The expected result is a ok received successfully for each remote server.
Install software components. You will be prompted for the elevation of privileges password (sudo
):
ansible-playbook -i inventory.yml playbooks/install.yml -K
The installation must end without
failed
operations. Example:
PLAY RECAP ****************************************************************************************************
example.com: ok=123 changed=78 unreachable=0 failed=0 skipped=34 rescued=0 ignored=0
Exit the virtual environment:
deactivate
The appearance of the terminal returns to normal.
Remove the virtual environment:
rm -rf venv_jinstall
Also remove the Jinstall directory:
cd ~
rm -rf ~/Jinstall
After installation here are the available services.
Software | Service | Status after installation | Information |
---|---|---|---|
Apache HTTPD | [apache2 | httpd] | started | systemctl status [apache2 | httpd] |
Tomcat JPlatform | jplatform | not started | systemctl status jplatform |
Tomcat JOD | jodconverter | not started | systemctl status jodconverter |
LibreOffice | libreoffice | not started | systemctl status libreoffice |
PostgreSQL | postgresql | started | systemctl status postgresql |
The Apache HTTPD service name is
apache2
for Debian & Ubuntu andhttpd
for RedHat & RockyLinux.
Commands to run on remote servers.
Start services (not yet started):
sudo systemctl start jplatform jodconverter libreoffice
View the JPlatform logs:
sudo -u jplatform tail -f /opt/jalios/app/tomcat/jplatform/webapps/ROOT/WEB-INF/data/logs/jcms.log
See How to build your inventory