Base de conhecimento

Jelastic provides an add-on that allows you to install packages requiring sudo permissions without needing root access.

Additional information

The Yum Packages Installer add-on allows you to install packages not provided by default in Jelastic containers (RPM packages, development tools, etc.) using yum. It offers an alternative for installing packages when direct root access is not available.

All the information required to use this add-on is described in the readme of the add-on.

Examples of common actions performed via the add-on:

• Install compilation tools: gcc autoconf make
• Install an external RPM: provide the full URL of the RPM in the installation field.

This guide provides instructions for creating a multi-datacenter high-availability infrastructure with Jelastic Cloud.

Preamble

• The principle of a multi-datacenter high-availability infrastructure is to replicate all necessary elements (web server, database server, and load balancer) in another datacenter to ensure the operation of your sites and apps in case of unexpected events (traffic spikes, hardware failure, network outage, etc.).
• The advantages of a multi-datacenter high-availability infrastructure are numerous:
  • In case of an unexpected event on a server, another server immediately takes over; your sites and apps remain accessible.
  • In case of a disruption with a component of a datacenter, the replicated infrastructure in the other datacenter immediately takes over; your sites and apps remain accessible.
  • In case of significant traffic spikes, the traffic is distributed between the two infrastructures by load balancers; your sites and apps remain accessible and fast.

Setting up a high-availability infrastructure with Jelastic Cloud

For the purposes of this example, 2 web servers with 2 load balancers will be set up, each of these elements being hosted in Switzerland in a different Infomaniak datacenter.

Before proceeding, log in to the administration interface of your Jelastic Cloud server:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click on Log in to Jelastic Cloud:
   

1. Creating web servers

A web server hosts the content of your sites (php files, images, pdfs, etc.).

Here are the actions to perform to create the first server:

1. Click on New environment.
2. Click on the PHP tab.
3. In App. Servers, choose for example an Apache server.
4. Adjust the environment resources according to your needs.
5. Choose Geneva DC2 for the server location.
6. Rename the environment to easily identify it later (for example DC2-apache).
7. Click on Create.

Create the second web server in another datacenter:

1. Click on New environment.
2. Click on the PHP tab.
3. In App. Servers, choose for example a Apache server.
4. Adjust the environment resources according to your needs.
5. Choose Geneva DC3 for the server location.
6. Rename the environment to easily identify it later (for example DC3-apache).
7. Click on Create.

2. Creation of load balancers

A load balancer allows you to distribute the load and traffic of your sites between your web servers.

Here are the actions to perform to create the first server:

1. Click on New environment.
2. Click on the PHP tab.
3. In Load Balancing, choose for example an NGINX server.
4. Adjust the environment resources according to your needs.
5. Choose Geneva DC2 for the server location.
6. Rename the environment to easily identify it later (for example DC2-nginx).
7. Click on Create.

Create the second load balancer in another datacenter:

1. Click on New environment.
2. Click on the PHP tab.
3. In Load Balancing, choose for example an NGINX server.
4. Adjust the environment resources according to your needs.
5. Choose Geneva DC3 for the server location.
6. Rename the environment to easily identify it later (for example DC3-nginx).
7. Click on Create.

3. Configuration of load balancers and domain name

Now, you just need to tell the load balancers which web servers they should distribute the traffic to.

Start by creating the load-balancer.conf file on both load balancers:

1. Connect via SSH to the DC2-nginx server by clicking on the Web SSH button of the environment.
2. Open the load-balancer.conf file: nano /etc/nginx/conf.d/load-balancer.conf.
3. Adjust the file code with the URL of your web servers:

   • http {
     upstream backend {
     server apache-dc2.jcloud-ver-jpc.ik-server.com;
     server apache-dc3.jcloud.ik-server.com;
     }
     server {
     listen 80;
     location / {
     proxy_pass http://backend;
     }
     }
     }

4. Repeat these 3 steps for the DC3-nginx server.

Modify the load balancers configuration file:

1. Connect via SSH to the DC2-nginx server by clicking on the Web SSH button of the environment.
2. Create the following configuration file: nano /etc/nginx/nginx.conf.
3. Adjust the server configuration file URL:

   • user nginx;
     worker_processes auto;
     worker_rlimit_nofile 2048;
     load_module modules/ngx_stream_module.so;
     #load_module modules/ngx_http_modsecurity_module.so;
     error_log /var/log/nginx/error_log info;
     events {
     worker_connections 2048;
     use epoll;
     }
     include /etc/nginx/conf.d/load-balancer.conf;

4. Restart the NGINX service: sudo /etc/init.d/nginx restart.
5. Repeat these four steps for the server DC3-nginx.

It is now necessary to indicate to your domain name on which servers the traffic should be redirected.

Prior to this, install a public IP address on your load balancers:

1. Deploy the server node DC2-nginx.
2. Hover over the Public IP line and click on the + that appears on the right.
3. Add a public IPv4.
4. Repeat these 3 steps for the server DC3-nginx.

At this stage, all you have to do is create two A records in the DNS zone of your domain name with the public IP of your two load balancers.

To ensure that changes are quickly taken into account, it is recommended to configure the A records with a TTL of 5 minutes.

In this example, the domain redirects your visitors to the load balancers, which in turn redirect the traffic to the web servers.

4. High availability infrastructure test

To test the proper functioning of your infrastructure, enter your domain name in a web browser and try in turn to disable an element of your infrastructure (one of the two load balancers, one of the two web servers). If everything works, you should still be able to access the content hosted on one of the two web servers.

Este guia diz respeito à aplicação móvel kCheck (aplicação para smartphones ou tablets iOS/Android), criada para simplificar os procedimentos de verificação de identidade e reforçar a segurança da sua conta Infomaniak.

Introdução

• Por razões de segurança, para garantir a identidade da pessoa que efetua um pedido específico à Infomaniak, um procedimento de verificação de identidade pode ser ativado nos seguintes casos (lista não exaustiva):
  • esquecimento da palavra-passe da conta Infomaniak (conta de utilizador)
  • esquecimento do endereço de e-mail de acesso
  • desativação da autenticação de dois fatores (2FA)
  • desbloqueio de uma conta Infomaniak
  • durante o primeiro pagamento de receitas para o produto Bilheteira
  • durante a encomenda de um produto (suspeita de spam ou fraude, nome da marca, etc.)
• Esta aplicação permite-lhe transferir com segurança os elementos solicitados.
• A Infomaniak respeita a sua privacidade: as informações transmitidas através da aplicação kCheck serão guardadas até ao tratamento completo do seu pedido; em todos os casos, serão automaticamente eliminadas após 72 horas caso este pedido não seja tratado.

Iniciar a verificação de identidade

Pré-requisitos

• Um código QR ou um link fornecido pela Infomaniak.
• A aplicação móvel kCheck instalada no seu dispositivo iOS (iPhone, etc.) ou Android.
• Uma ligação à Internet no dispositivo móvel.

Pode então fazer verificar a sua identidade com o kCheck:

1. Inicie o aplicativo kCheck no seu celular.
2. Toque em Iniciar.
3. Toque em Ler código QR.
4. Aponte a câmera para o código QR fornecido.
5. Insira o seu número de telefone.
6. Digite o código de confirmação recebido.
7. Autorize a geolocalização (obrigatório para continuar o processo).
8. Selecione o tipo de documento de identificação que você possui (carteira de identidade ou passaporte).
9. Siga as instruções para fotografar o seu documento de identificação.
10. Tire uma selfie (sua) com o seu documento de identificação na mão, à sua frente.

Seus documentos serão então transmitidos de forma segura para o suporte da Infomaniak. Essas solicitações são tratadas com prioridade, com um tempo médio de resposta de 2 horas durante o horário de atendimento.

Se o seu pedido estiver bloqueado...

Por motivos de segurança, alguns pedidos podem ser bloqueados automaticamente.

No momento do seu pedido, um e-mail é enviado para o endereço de e-mail de login da sua conta Manager Infomaniak. Este e-mail contém o procedimento para desbloquear o seu pedido. Caso não o encontre, é possível reenviá-lo a partir do seu Manager, clicando em Reenviar o procedimento a partir da barra vermelha que informa sobre o bloqueio.

Pré-requisitos

• Abrir o e-mail contendo o procedimento de desbloqueio.
• O aplicativo móvel kCheck instalado no seu dispositivo iOS (iPhone, etc.) ou Android.
• Uma conexão de internet no dispositivo móvel.

Em seguida, pode iniciar o processo de desbloqueio com o kCheck:

1. Abra a aplicação kCheck no seu telemóvel.
2. Toque em Iniciar.
3. Toque em Ler código QR.
4. Leia o código QR presente no e-mail.
5. Siga o processo de desbloqueio até ao fim.

Casos particulares

• Caso não haja qualquer ação da sua parte num prazo de 10 dias, o pedido será automaticamente cancelado e o pagamento será integralmente reembolsado no método de pagamento utilizado.
• Caso não tenha um dispositivo móvel para seguir este processo, contacte o suporte da Infomaniak.

This guide details how to back up the data from your folders and nodes on Jelastic Cloud using the OpenStack Swift protocol on Swiss Backup, the backup solution in an independent Swiss cloud.

Introduction

• To back up the data, an extension for Virtuozzo (Jelastic Cloud) is available in the node's add-ons.
  • Learn more about the extension (add-on) on Github.

Configure the Swiss Backup extension on Jelastic Cloud

Prerequisites

• Use Jelastic Cloud (at least one Jelastic environment must be active with the extension installed for your backups to be visible).
• Have an Swiss Backup Infomaniak account with an available device quota (minimum 1) for a Cloud backup.
• Add 1 device of type Cloud to obtain the OpenStack Swift parameters.

To add the extension useful for Swiss Backup on Jelastic Cloud:

1. Log in to the Jelastic Cloud Dashboard of your server.
2. Go to the node's add-ons section:
   
3. Search for and install the Backup / Restoration extension:
   
    

Two types of backup are then possible and detailed below:

1. Back up specific folders.
2. Create a snapshot of an entire node.

Back up specific folders

To back up specific directories:

1. Enter the username and password according to the information specific to your device.
2. Check Backup your data.
3. Check Backup specific folders
4. Enter the absolute path of the folders to be backed up in the Folders to backup field; it is possible to specify several folders by separating each path with a comma, for example: /root/admin/, /home/user1/, /jelastic/containers/ (in this example, 3 folders have been specified)…
   

Next, you need to define the frequency of the backups (see below).

Back up an entire node

To back up an entire node:

1. Enter the username and password for your Swift device on Swiss Backup.
2. Check Backup your data.
3. Check Backup all files to back up the entire file system of a node; some files are automatically excluded:
   • the /dev, /proc, /sys, /run directories
   • file systems that are not mounted as part of the root partition, including virtual file systems
     

Next, you need to define the frequency of the backups.

Define the frequency and retention policy for backups

Two options are available for performing the backup:

1. daily (at 8 PM UTC)
2. every hour (at the beginning of the hour, for example at 1 PM, 2 PM, etc.)

You can define the retention period for your backups in years, months, days, and hours. To keep your backups indefinitely, simply set the parameters to 0.

For example, if you perform backups every hour and set a retention policy of 1 year, 2 months, 4 days, 2 hours, this means that each backup will be available for a period of 1 year, 2 months, 4 days, 2 hours (=10322 backups). Note that backups are deleted every Sunday at 10:30 PM (UTC).

Restore backups

Restore data from a node

1. Log in to the Jelastic Dashboard of your server.
2. You will probably need to re-install (restart) the add-on from the Marketplace:
   1. Click on Marketplace.
   2. Search for “backup”…
   3. Click on the "Backup / Restoration" add-on:
      
3. Once the extension has been added and the username and password for your Swift device on Swiss Backup have been entered, check Restore your data.
4. Select the node that contains the backup to be restored.
5. Select the backup to be restored and the folder for restoration.
6. Click on the Restore button:
   

Restore specific folders from a snapshot (CLI)

Each backup corresponds to a unique ID. You can include and exclude folders from your snapshots during a restore. To view your snapshots:

1. . /home/.config/swissbackup/openrc.sh
2. restic snapshots
   
3. Use --exclude and --include to restrict the restore to a subset of files in the snapshot; for example, to restore a single file: restore 79766175 --target /tmp/restore-work --include /work/foo

There are case-insensitive variants of --exclude and --include called --iexclude and --iinclude. These options behave the same way but ignore the case of the paths.

Modify the backup configuration

To do this:

1. Log in to the Jelastic Dashboard of your server.
2. Once the extension has been added and the username and password for your Swift device on Swiss Backup have been entered, modify the configuration as desired.

The backup schedule is defined by a cron job, and backups are performed using the restic tool.

To manually modify the backup schedule (CLI), as the root user, run the crontab -l command to display the current schedules:

• The line containing retention-all.sh corresponds to the backup task.
• The line containing purge.sh corresponds to the backup retention task.

Example:

Modify the schedule using the crontab -e command.

You can modify the line containing the retention-all.sh or retention.sh script; these scripts launch your backups. Note: the cron jobs are designed to avoid causing problems between backups and multiple deletions. Pay attention to the time required for backups and deletions…

• Learn more about cron jobs: crontab.guru
• Learn more about restic: restic.net

Manually Delete Backups (CLI)

To do this:

1. Source the configuration file:
   . /home/.config/swissbackup/openrc.sh
2. Display the available backups:
   restic snapshots
3. Delete the desired backup:
   restic forget IdBackup --prune
4. Delete all backups of a file except one:
   restic forget --tag folders --keep-last 1 --prune

Remove the Backup Schedule

This button allows you to delete the schedule for your backup:

Uninstall the Swiss Backup extension

You must delete the backup schedule (see above) before you can delete the Swiss Backup extension:

This guide explains how to customize the time slot(s) during which Infomaniak can perform maintenance to update your services (new features, fixes, etc.).

Preamble

• This feature is only available for:
  • Cloud Servers
  • Cloud VPS / Lite VPS
  • Jelastic Cloud
• Without any indication from you, scheduled maintenance is usually performed by Infomaniak between 10 PM and 6 AM.

Modify the scheduled maintenance period

To do this:

1. Click here to access the service for which you want to schedule maintenance on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on Scheduled Maintenance in the left sidebar or on the central page depending on the service concerned (below Jelastic):
   
   • Same principle for a VPS:
     
4. Click the buttons to define, in blue, a preferred intervention slot.
5. Validate by clicking the button at the bottom:
   

This guide details how to transfer an Infomaniak Jelastic Cloud environment from one account to another; you can also refer to the official Jelastic documentation (in English only).

Prerequisites

• An environment can be transferred from any type of Jelastic Cloud account (trial, beta, deactivated, etc.); however, it is essential that the recipient of the transfer has a paid account.
• Also ensure that the destination account has not reached:
  • the maximum number of cloudlets per container
  • the maximum number of compute nodes available for an environment
  • the maximum number of environments on the account
• Use the user email address of the destination account, which is found under the user section in the Jelastic dashboard of the destination account:
  

Transfer procedure

To perform the transfer:

1. Log in to your Jelastic Cloud platform (you are leaving the Infomaniak Manager).
2. Click on the Settings button next to the environment to be transferred:
   
3. From the Settings menu, select the Change Owner option.
4. Enter the email address of the destination account, then click Send:
   
5. If the destination account exists and meets the transfer criteria, a notification indicating the sending of the request will appear.
6. An icon will appear next to the environment to be transferred until the transfer request is accepted by the new owner.
7. Once the transfer request is accepted, the environment is removed from your account.

Once the transfer is complete, it is possible to cancel the Jelastic product from your account, all credits still available at the time of cancellation will be automatically transferred to your Infomaniak prepaid account.