> For the complete documentation index, see [llms.txt](https://doc.simax.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.simax.fr/parametrage/installation/les-prerequis-pour-une-installation.md).

# Les prérequis pour une installation

*Ce document regroupe et harmonise les procédures d’installation de SIMAX et de configuration de SIMAX sur serveur et du Client Web. Il présente les prérequis, les étapes d’installation et de configuration, ainsi que les mises à jour nécessaires.*

## **Installation de SIMAX**

### **Prérequis**

**Systèmes d’exploitation requis :**

* Windows dans une version supportée par Microsoft
* Possibilité d’utiliser une distribution linux encore maintenue pour le serveur Web

**Configuration et accès réseau :**

* Dossier partagé configuré sur le serveur pour modèles d’édition, accessible en lecture par tous les utilisateurs
* Ports ouverts requis : 8051 (SIMAXOnline) et 3306 (MySQL)
* Droits administrateurs nécessaires sur le serveur

**Bases de données compatibles et configuration MySQL :**

* Compatibilité : MySQL (recommandé), SQL Server, DB2
* MySQL doit être installé et configuré avec :
  * Création d’un utilisateur SIMAX avec droits complets (host='%')
  * max\_allowed\_packet = 16 Mo
  * Version minimum 8.0

**Logiciels et suites compatibles :**

* Suites bureautiques compatibles : MS Office, OpenOffice, LibreOffice
* Serveur web conforme à la documentation pour le client Web
* Apache Web Server 2.4+ avec mod\_rewrite
* PHP 8.2 avec extensions : CTYPE, CURL? FilenInfo, GD2, Intl, JSON, LibXML, MBString, OPENSSL, XML (facultatifs : EXIF, Tokenizer, IConv, POSIX, APCU)
* Configuration PHP recommandée :
  * memory\_limit ≥256M
  * post\_max\_size ≥16M
  * upload\_max\_filesize ≥16M
  * date.timezone défini
* Installation préalable de NOUTOnline
* Navigateurs récents (Edge, Firefox, Chrome, Safari, Opera)

### **Liste des fichiers nécessaires**

| **Composant**            | **Fichier**            |
| ------------------------ | ---------------------- |
| SIMAXOnline              | SIMAXOnline x64 .zip   |
| Client Windows           | ClientWindows x64 .zip |
| Modèles d’édition        | modeles\_edition.zip   |
| Base de données initiale | SIMAXVU.zip            |
| Client Web               | ClientWeb .zip         |

### **Installation de SimaxOnline**

{% stepper %}
{% step %}

#### Décompresser SIMAXOnline

Décompresser SIMAXOnline dans : `C:\Program Files\SIMAX\`
{% endstep %}

{% step %}

#### Renommer et renseigner `info.simax`

Renommer `info.simax.dist` → `info.simax` et renseigner :

* Licence SIMAX
* Société, chemin du partage
* Connexion MySQL (adresse, base, utilisateur, mot de passe)
  {% endstep %}

{% step %}

#### Charger la base SQL

Charger la base SQL fournie et créer un schéma « messages »
{% endstep %}

{% step %}

#### Ouvrir une invite de commande en administrateur

* `simaxonline.exe -i -U=utilisateur@domaine.local -P=monmotdepasse`
* `simaxonline.exe -i -SystemLocalAccount` (Force l'utilisateur Système Local ;&#x20;

{% hint style="warning" %}
***Attention : ce compte a des droits restreints sur les fichiers)***
{% endhint %}
{% endstep %}

{% step %}

#### Configurer le service

Configurer le service : `sc config SIMAXOnline depend= MySQL`
{% endstep %}

{% step %}

#### Démarrer le service

Démarrer le service depuis Windows Services
{% endstep %}

{% step %}

#### Accéder à l’application

Accéder via navigateur : `http://127.0.0.1:8050` (admin/admin)
{% endstep %}
{% endstepper %}

## **Installation du Client Web SIMAX**

* Apache Web Server 2.4+ avec mod\_rewrite
* PHP 8.2 avec extensions : CTYPE, CURL, FileInfo, GD2, Intl, JSON, LibXML, MBString, OPENSSL, XML (facultatifs : EXIF, Tokenizer, IConv, POSIX, APCU)
* Configuration PHP recommandée :
  * memory\_limit ≥256M
  * post\_max\_size ≥16M
  * upload\_max\_filesize ≥16M
  * date.timezone défini
* Installation préalable de NOUTOnline
* Navigateurs récents (Edge, Firefox, Chrome, Safari, Opera)

### **Installation**

{% stepper %}
{% step %}

#### Extraire les archives

Extraire `ClientWeb_Vendor.zip` et `ClientWeb.zip` dans un répertoire (contient vendor, app, src, web)
{% endstep %}

{% step %}

#### Configurer le VirtualHost Apache

Configurer le VirtualHost Apache (voir documentation Apache/Symfony)
{% endstep %}

{% step %}

#### Redémarrer Apache

Redémarrer Apache : 2.4
{% endstep %}

{% step %}

#### Vérifier la page de prérequis

Vérifier la page de prérequis : <http://monserveur/monsite/requitements.php>
{% endstep %}

{% step %}

#### Vérifier les versions minimales

* MySQL : 8.0 Minimum
* Sqlserveur : 2012 Minimum
  {% endstep %}
  {% endstepper %}

### **Configuration du site web**

* Accéder à : `http://monserveur/monsite/admin/`
* Identifiants par défaut : `admin / admin` (à modifier immédiatement)
* Créer un fichier `.env.local` à la racine du site avec : `ADMIN_WHITE_IPS='["127.0.0.1","::1","10.234.179.0/24","votre ip"]'`
* Gérer l’activation de la messagerie dans l’administration du site (case « Messagerie activée ? »)
* Dans le menu `SIMAXOnline -> Connexion`, renseigner les informations sur l'emplacement de SIMAXOnline si besoin

### **Mise à jour du site PHP**

* Décompresser le nouveau Client Web (ZIP) et remplacer les fichiers
* Lancer le fichier `cleanup_after_update.bat` (windows) ou `cleanup_after_update.sh` (linux)
* PHP : 8.2

## **Installation sur Poste Utilisateur**

{% stepper %}
{% step %}

#### Créer un dossier SIMAX

Créer un dossier SIMAX sur le poste.
{% endstep %}

{% step %}

#### Décompresser le client

Décompresser le fichier ZIP du client dans ce dossier
{% endstep %}

{% step %}

#### Créer le fichier de configuration

Créer un fichier de configuration « info.simax » avec :

```ini
[SERVEUR]
SIMAXONLINE=<nom NETBIOS du serveur ou adresse IP>
```

{% endstep %}

{% step %}

#### Lancer SIMAX

Lancer SIMAX et vérifier que la fenêtre de login s’affiche
{% endstep %}
{% endstepper %}

## **Configurations minimales recommandées**

| Nombre d’utilisateurs | RAM    | CPU            | Disque                                            |
| --------------------- | ------ | -------------- | ------------------------------------------------- |
| 2 à 5                 | 8 Go   | CPU 4 threads  | disque SSD, taille en fonction du projet >= 256Go |
| 6 à 30                | 16 Go  | CPU 8 threads  | disque SSD, taille en fonction du projet >= 256Go |
| 31 à 100              | 32 Go  | CPU 12 threads | disque SSD, taille en fonction du projet >= 512Go |
| 100 à 300             | 64 Go  | CPU 16 threads | disque SSD, taille en fonction du projet >= 512Go |
| 300 à 500             | 128 Go | CPU 32 threads | disque SSD, taille en fonction du projet >= 1TO   |

En cas de configuration avec serveur web linux, prévoir 8Go.

## **Considérations réseau et performance**

* Qualité du réseau : ping serveur ≤10 ms pour usage client Windows
* Pour débits inférieurs : utilisation recommandée en mode TSE ou Remote App
* Si le serveur n’est pas dédié, adapter la configuration en fonction de l’existant et de la mémoire disponible
* Utiliser une version de SQL Server supporté par Microsoft : <https://learn.microsoft.com/fr-fr/troubleshoot/sql/releases/download-and-install-latest-updates>" \t "<https://intranet.nout.fr/\\_blank>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://doc.simax.fr/parametrage/installation/les-prerequis-pour-une-installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
