Installation de S-Filer Portal

S-Filer Portal est composé de trois éléments :

Le serveur
La passerelle
L'interface de ligne de commande (CLI)

Le serveur et la passerelle peuvent être installés en mode console ou en mode graphique. Typiquement, le mode console est utilisé dans un environnement UNIX, tandis que le mode graphique est utilisé dans le monde Windows. Les procédures d'installation de ces deux composants sont très similaires. L'administrateur doit simplement spécifier la configuration de base à travers une série de questions. Une fois l'installation des composants terminée, il est toujours possible de reconfigurer les paramètres d'installation. Chaque composant une fois installé peut être désinstallé tout aussi facilement. L'installation des applications web (fichier war) est tout aussi simple et consiste principalement à copier les fichiers aux bons endroits sur le système cible.

Configurations du système

Si vous travaillez dans un environnement Linux, vous devez vous assurer que les paquets fontconfig et libfontconfig.so.1 sont installés car ils sont requis par Java et ne sont pas inclus dans l'OpenJDK 11. Ceci s'applique à la fois au serveur et à la passerelle.

Vous pouvez exécuter les commandes suivantes avec yum ou rpm pour vérifier s'ils sont installés.

shell

yum list installed fontconfig

shell

rpm -qa \| grep fontconfig

Par exemple, si votre distribution prend en charge yum, vous pouvez utiliser les commandes suivantes pour les installer.

shell

yum install fontconfig
yum install libfontconfig.so.1

Contenu du paquet

Le client reçoit dans sa communauté de support S-Filer le paquet approprié à son environnement.

Le serveur

Ce chapitre vous présente l'installation de S-Filer Portal Server ainsi que la configuration de base. Avant de commencer, il est recommandé d'imprimer la liste de contrôle fournie dans l'annexe 1 à la fin de ce document et de remplir chaque champ au fur et à mesure de l'installation.

Installation du serveur

Le serveur S-Filer Portal est le composant principal. C'est le premier composant à installer.

Installation à l'aide du programme d'installation

Vous pouvez lancer l'installateur en cliquant directement sur l'exécutable sfiler-server-installer.exe. Pour les versions Windows Core, vous pouvez utiliser le paramètre -i console sur la ligne de commande :

shell

sfiler-server-installer.exe -i console.

Après avoir lancé le programme d'installation, celui-ci vous invite à fermer toutes les applications en cours d'exécution afin d'éliminer toute source de conflit. Une fois toutes les applications fermées, vous devez cliquer sur le bouton Next pour passer à l'étape suivante.

Vous êtes alors invité à lire et à accepter la licence d'utilisation du produit S-Filer Portal. Pour accepter la licence, appuyer sur le bouton Suivant. Si vous désirez plus d'information sur la licence, contacter votre support technique.

Après avoir accepté la licence, vous devez sélectionner le type d'installation. Une "Installation complète" installera tous les composants et fichiers de configuration requis. Si vous installez S-Filer pour la première fois, veuillez sélectionner cette option. Une "Mise à jour" mettra à jour votre installation existante de S-Filer avec les nouvelles fonctionnalités et laissera vos fichiers de configuration intacts.

Ensuite, vous devez entrer le répertoire de destination. Vous pouvez parcourir votre système de fichiers à l'aide du bouton Choisir. Une fois le répertoire spécifié, cliquez sur le bouton Next pour passer à l'étape suivante. Si vous souhaitez revenir à l'emplacement par défaut, cliquez simplement sur le bouton Restore Default Folder.

Enfin, vous devez choisir un dossier temporaire qui sera utilisé par le serveur. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

Il faut maintenant valider les paramètres du programme d'installation avant qu'il ne commence à copier les fichiers sur le système cible. Si les paramètres sont valides, cliquez sur le bouton Install pour poursuivre l'installation.

Vous pouvez suivre la progression de l'installation grâce à la barre de progression située au bas de la fenêtre. Pour éviter tout problème potentiel, S-Filer Portal installe son propre JRE (Java Runtime Environment).

A la fin de l'installation, si tout s'est bien passé, un message apparait indiquant que l'installation est terminée. Si une erreur survient pendant l'installation, notez-la et contactez le support technique.

L'installation est terminée.

Installation à l'aide de la ligne de commande

Pour démarrer l'installation, exécutez le fichier sfiler-server-installer.bin. Assurez-vous d'avoir les permissions adéquates sur le fichier exécutable. Si ce n'est pas le cas, exécutez la commande suivante :

shell

chmod 755 sfiler-server-installer.bin

Une fois que les droits sur le fichier sont appropriés, lancez l'installation directement à partir de la ligne de commande.

shell

./sfiler-server-installer.bin

La première étape du programme d'installation vous invite à choisir la langue.

shell

[root@localhost tmp]# ./sfiler-server-installer.bin                 
                                                                      
Preparing to install                                                  
                                                                      
Extracting the JRE from the installer archive...                     
                                                                      
Unpacking the JRE...                                                 
                                                                      
Extracting the installation resources from the installer archive...  
                                                                      
Configuring the installer for this system's environment...          
                                                                      
Launching installer...                                               
                                                                      
===================================================================== 
                                                                      
Choose Locale\...                                                     
                                                                      
----------------                                       
                                                                      
->1- English                                                         
  2- Español                                                            
  3- Français                                                           
                                                                      
CHOOSE LOCALE BY NUMBER:

L'installation vous invite ensuite à fermer toutes les applications en cours afin d'éliminer tout conflit éventuel. Appuyez sur ENTRÉE pour passer à l'étape suivante.

shell

=====================================================================
S-Filer Server (created with InstallAnywhere)                         
---------------------------------------------------------------------                                                                      
Preparing CONSOLE Mode Installation...                               
 
===================================================================== 
Introduction                                                          
------------                                               
                                                                      
InstallAnywhere will guide you through the installation of S-Filer    
Server.                                                               
                                                                      
It is strongly recommended that you quit all programs before          
continuing with this installation.                                                    
                                                                      
Respond to each prompt to proceed to the next step in the             
installation. If you want to change something on a previous step, type 'back'.       
                                                                      
You may cancel this installation at any time by typing 'quit'.      
                                                                      
PRESS <ENTER> TO CONTINUE:

Le texte de la licence s'affiche. Vous devez accepter les conditions d'utilisation de la solution pour poursuivre l'installation. Appuyez sur Y (pour Oui) pour passer à l'étape suivante. Si vous souhaitez obtenir plus d'informations sur la licence, veuillez contacter le service d'assistance.

Après avoir accepté la licence, vous êtes invité à indiquer le type d'installation du serveur. Une "Installation complète" installera tous les composants et fichiers de configuration requis. Si vous installez S-Filer Portal pour la première fois, veuillez sélectionner cette option. Une "Mise à jour" mettra à jour votre installation existante de S-Filer avec les nouvelles fonctionnalités et laissera vos fichiers de configuration intacts.

shell

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y
=========================================================================

Choose Install Set
------------------

Please choose the Install Set to be installed by this installer

->1- Complete Installation
->2- Update

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
 :

Ensuite, vous êtes invité à indiquer le répertoire d'installation du serveur. Pour accepter le répertoire par défaut, appuyez sur la touche ENTRÉE dans le répertoire cible si souhaité.

shell

===============================================================================
Choose Install Folder
---------------------

If you are upgrading, please choose your existing install directory

Where would you like to install?

  Default Install Folder: /usr/local/sfiler-server

ENTER AN ABSOLUTE PATH, OR PRESS \<ENTER\> TO ACCEPT THE DEFAULT
  :

Vous devez maintenant choisir un dossier temporaire qui sera utilisé par le serveur. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement choisi.

shell

===============================================================================
Temporary folder
----------------

Enter the location of the temporary folder that will be used by the
server. If

the folder doesn't exist, it will be created. Please confirm that you
have write permissions in the selected location.

Please Choose a temporary folder (Default: /tmp):

Il vous sera alors demandé le nom et l'endroit où vous souhaitez ajouter le script de démarrage du serveur. Vous avez deux options ; l'une est de le placer dans le répertoire /etc/init.d ou de le créer dans le répertoire d'installation.

shell

===============================================================================
Startup script name
-------------------

Enter the name of the startup script. If you are installing on a machine
that already has a server installed, be careful to choose a different file
name that was used in previous installations.

Startup script name (Default: sfiler):
===============================================================================
Choose the startup script path
------------------------------

Select the path where you would like to have the startup script. If you
have root access, select option 1, otherwise choose option 2 to install them
in the install folder.

->1- /etc/init.d
  2- Installed Folder (non root access)

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS \<ENTER\> TO ACCEPT THE
DEFAULT:

L'étape suivante consiste simplement à confirmer les paramètres sélectionnés.

shell

===============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    S-Filer Server

Install Folder:
    /usr/local/sfiler-server

Link Folder:
    /root

Disk Space Information (for Installation Target):
    Required: 514,210,874 Bytes
    Available: 32,034,263,040 Bytes

PRESS <ENTER> TO CONTINUE:

Si les paramètres sont corrects, appuyez simplement sur ENTRÉE pour terminer l'installation du serveur S-Filer Portal.

shell

=========================================================================
Ready To Install
----------------

InstallAnywhere is now ready to install S-Filer Server onto your system
at the following location:

    /usr/local/sfiler-server

PRESS <ENTER> TO INSTALL:

On peut alors suivre la progression de l'installation.

shell

=========================================================================
Installing...
-------------

La dernière étape confirme que l'installation a réussi. En cas de problèmes, veuillez contacter l'assistance.

shell

=========================================================================
Installation Complete
---------------------

Congratulations. S-Filer Server has been successfully installed to:
    /usr/local/sfiler-server
PRESS <ENTER> TO EXIT THE INSTALLER:

Important : N'oubliez pas de noter toute modification des valeurs par défaut dans la liste de contrôle fournie à la fin de ce manuel.

Configuration de la base de données

Si votre base de données prend en charge UTF8, utilisez toujours l'encodage de caractères UTF8.

Nous utilisons Liquibase (une bibliothèque tierce) pour la configuration initiale des tables, puis pour les mises à jour des produits. Liquibase simplifie les mises à jour du produit car il connaît votre version actuelle et applique automatiquement les changements à la base de données pour qu'elle fonctionne avec la version que vous mettez à jour.

Nous avons eu des administrateurs de bases de données qui voulaient le faire eux-mêmes, mais ils ont fini par voir que Liquibase fait un très bon travail de suivi et d'application des modifications aux bases de données.

La première étape de configuration consiste à modifier quelques lignes dans le fichier [Dossier d'installation]/server/conf/sfiler.conf (créé en copiant le fichier sfiler.conf.template dans le même répertoire).

Voici un exemple des lignes à modifier dans le fichier (voir les sections ci-dessous pour les valeurs à entrer dans ces champs) :

shell

cfg.server.local.config.user=[USER]
cfg.server.local.config.password=[PASSWORD]                         
cfg.server.local.config.hibernate.dialect=[DIALECT]                 
cfg.server.local.config.driver=[DRIVER]                             
cfg.server.local.config.url=[URL]

Configuration pour MySQL

Téléchargez manuellement les pilotes JDBC pour MySQL et sauvegardez le fichier jar fourni dans le dossier [répertoire d'installation]/server/ext/lib. Vous pouvez télécharger ce pilote ici : https://dev.mysql.com/downloads/connector/j/

Le fichier ressemblera à ceci : mysql-connector-java-8.0.19.jar.

Variable	Valeur
USER	Nom de l'utilisateur de la base de données à utiliser
PASSWORD	Le mot de passe de l'utilisateur de la base de données (notez que l'application masquera automatiquement ce mot de passe après son démarrage, vous pourriez donc voir une valeur différente après cela)
DIALECT	org.hibernate.dialect.MySQL5InnoDBDialect
DRIVER	com.mysql.cj.jdbc.Driver
URL	jdbc:mysql://[HOST]:[PORT]/[DATABASE] (Remplacez les variables dans l'URL) Utilisez à la fin de l'URL pour maintenir l'encodage utf8 (sinon le pilote utiliserait la valeur par défaut latin1) et définir le fuseau horaire du serveur: ?useUnicode=true&characterEncoding=utf8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=UTC
HOST	Nom du serveur MySQL
PORT	Le port sur lequel MySQL écoute (par défaut: 3306)
DATABASE	Le nom de la base de données à utiliser

Configuration pour SQL Server

Pour SQL Server, il existe cinq possibilités de déploiement différentes :

Serveur utilisant l'instance par défaut fonctionnant sur un port statique avec l'authentification native SQL (pas un compte Windows)
Serveur utilisant une instance nommée avec authentification native SQL
Serveur utilisant l'instance par défaut fonctionnant sur un port statique avec une authentification Windows (pas de compte de domaine)
Serveur utilisant une instance spécifique s'exécutant sur un port statique avec Windows (un compte de domaine est utilisé)
Serveur utilisant une instance nommée avec authentification Windows

Serveur utilisant l'instance par défaut fonctionnant sur un port statique avec une authentification native SQL (pas un compte Windows)

Téléchargez manuellement les pilotes JDBC pour SQL Server et enregistrez le fichier jar fourni dans le dossier [répertoire d'installation]/server/ext/lib. Vous pouvez télécharger ce pilote ici :

https://docs.microsoft.com/en-us/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15

Le fichier ressemblera à ceci : mssql-jdbc-12.6.1.jre11.jar.

Variable	Valeur
USER	Le nom de l'utilisateur de la base de données à utiliser
PASSWORD	Mot de passe de l'utilisateur de la base de données (notez que l'application masquera automatiquement ce mot de passe après son démarrage, vous pourriez donc voir une valeur différente après cela)
DIALECT	org.hibernate.dialect.SQLServer2012Dialect
DRIVER	com.microsoft.sqlserver.jdbc.SQLServerDriver
URL	jdbc:sqlserver://localhost:1433;DatabaseName=sfiler;encrypt=false;sendStringParametersAsUnicode=false
HOST	Nom du serveur SQL
PORT	Port statique de l'instance (par défaut: 1433)
DATABASE	Le nom de la base de données à laquelle se connecter.

Server utilisant une instance nommée avec l'authentification native SQL

Dans ce cas, le pilote Microsoft doit être utilisé. Il doit être téléchargé sur le site web de Microsoft :

https://docs.microsoft.com/en-us/sql/connect/jdbc/overview-of-the-jdbc-driver?view=sql-server-ver15

Le pilote Microsoft JDBC 7.2 et plus est nécessaire pour fonctionner avec java

Exécutez le fichier exécutable pour décompresser les fichiers dans un dossier spécifique. Copiez les fichiers suivants dans le dossier [répertoire d'installation]/server/ext/lib

[lieu de décompression]/sqljdbc_7,4/enu/mssql-jdbc-7.4.1.jre11.jar

[lieu de décompression]/sqljdbc_7.4/enu/auth/x64/sqljdbc_auth.dll (Pour Windows 64 bits)

[lieu de décompression]/sqljdbc_7.4/enu/auth/x86/sqljdbc_auth.dll (Pour Windows 64 bits)

Variable	Valeur
USER	Le nom de l'utilisateur de la base de données à utiliser
PASSWORD	Mot de passe d'utilisateur (notez que l'application masquera automatiquement ce mot de passe après son démarrage, vous pourriez donc voir une valeur différente après cela)
DIALECT	Dépend de la version de SQL Server: org.hibernate.dialect.SQLServer2008Dialect (SQL Server 2008 et supérieur)
DRIVER	com.microsoft.sqlserver.jdbc.SQLServerDriver
URL	jdbc:sqlserver://[HOST];instanceName=[INSTANCE];databaseName=[DATABASE]; Remplacez les variables dans l'URL
HOST	Nom de SQL Server
INSTANCE	Le nom de l'instance de la base de données
DATABASE	Le nom de la base de données à laquelle se connecter.

Server utilisant l'instance par défaut fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé)

Dans ce cas, le pilote Microsoft doit être utilisé. Il doit être téléchargé à partir du site web de Microsoft :

https://docs.microsoft.com/en-us/sql/connect/jdbc/overview-of-the-jdbc-driver?view=sql-server-ver15

Le pilote Microsoft JDBC 7.2 ou supérieur est nécessaire pour fonctionner avec Java.

Exécutez le fichier exécutable pour décompresser les fichiers dans un dossier spécifique. Copiez les fichiers suivants dans le dossier [répertoire d'installation]/server/ext/lib

[lieu de décompression]/sqljdbc_7,4/enu/mssql-jdbc-7.4.1.jre11.jar

[lieu de décompression]/sqljdbc_7.4/enu/auth/x64/sqljdbc_auth.dll (pour Windows 64 bits)

[lieu de décompression]/sqljdbc_7.4/enu/auth/x86/sqljdbc_auth.dll (pour Windows 32 bits)

Variable	Valeur
USER	Non utilisé (dans cette configuration, ce champ est ignoré)
PASSWORD	Non utilisé (dans cette configuration, ce champ est ignoré)
DIALECT	DIALECT Dépend de la version de SQL Server: org.hibernate.dialect.SQLServer2008Dialect (SQL Server 2008 et supérieur)
DRIVER	com.microsoft.sqlserver.jdbc.SQLServerDriver
URL	jdbc:sqlserver://[HOST]:[PORT];databaseName=[DATABASE];integratedSecurity=true (Remplacez les variables dans l'URL)
HOST	Nom de SQL Server
PORT	Port statique de l'instance (par défaut: 1433)
DATABASE	Le nom de la base de données à laquelle se connecter.

Note

Avec cette configuration, le service Windows pour le serveur S-Filer doit être exécuté en utilisant le compte de domaine configuré pour la base de données.

Serveur utilisant une instance spécifique fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé)

https://sourceforge.net/projects/jtds/files/

Le fichier ressemblera à ceci : jtds-1.3.1.jar.

Variable	Valeur
USER	Le nom de l'utilisateur Windows de la base de données à utiliser
PASSWORD	Mot de passe de l'utilisateur Windows de la base de données (notez que l'application masquera automatiquement ce mot de passe après son démarrage, vous pourriez donc voir une valeur différente après cela)
DIALECT	Dépend de la version de SQL Server: org.hibernate.dialect.SQLServerDialect (SQL Server 2000 et supérieur)
DRIVER	net.sourceforge.jtds.jdbc.Driver
URL	jdbc:jtds:sqlserver://[HOST]:[PORT];databaseName=[DATABASE]; InstanceName=[INSTANCE];useNTLMv2=[FLAG];domain=[WINDOWS DOMAIN] (Remplacez les variables dans l'URL)
HOST	Nom du SQL Server
PORT	Port statique de l'instance (par défaut: 1433)
DATABASE	Le nom de la base de données à laquelle se connecter.
INSTANCE	Il s'agit du nom de l'instance MSSQL que vous souhaitez utiliser
FLAG	Doit être réglé sur true pour utiliser l'authentification Windows
WINDOWS DOMAIN	Le nom du domaine des utilisateurs Windows

Note

Avec cette configuration, le service Windows pour le serveur S-Filer doit être exécuté en utilisant le compte de domaine configuré pour la base de données.

Serveur utilisant une instance nommée avec authentification Windows

Dans ce cas, le pilote Microsoft doit être utilisé. Il doit être téléchargé à partir du site web de Microsoft :

https://docs.microsoft.com/en-us/sql/connect/jdbc/overview-of-the-jdbc-driver?view=sql-server-ver15

Le pilote Microsoft JDBC 7.2 et supérieur est nécessaire pour fonctionner avec Java 11. Exécutez le fichier exécutable pour décompresser les fichiers dans un dossier spécifique. Copiez les fichiers suivants dans le dossier [répertoire d'installation]/server/ext/lib

[lieu de décompression]/sqljdbc_7,4/enu/mssql-jdbc-7.4.1.jre11.jar

[lieu de décompression]/sqljdbc_7.4/enu/auth/x64/sqljdbc_auth.dll (pour Windows 64 bits)

[lieu de décompression]/sqljdbc_7.4/enu/auth/x86/sqljdbc_auth.dll (pour Windows 32 bits)

Variable	Value
USER	Non utilisé (dans cette configuration, ce champ est ignoré)
PASSWORD	Non utilisé (dans cette configuration, ce champ est ignoré)
DIALECT	Dépend de la version de SQL Server: org.hibernate.dialect.SQLServer2008Dialect (SQL Server 2008 et plus récent)
DRIVER	com.microsoft.sqlserver.jdbc.SQLServerDriver
URL	URL jdbc:sqlserver://[HOST];instanceName=[INSTANCE];databaseName=[DATABASE];integratedSecurity=true (Remplacez les variables dans l'URL)
HOST	Le nom du serveur SQL
INSTANCE	Le nom de l'instance de base de données
DATABASE	Le nom de la base de données à laquelle se connecter.

Note

Avec cette configuration, le service Windows pour le serveur S-Filer doit être exécuté en utilisant le compte de domaine configuré pour la base de données.

Configuration pour Oracle

Téléchargez manuellement les pilotes JDBC pour Oracle et enregistrez-les dans le dossier [répertoire d'installation]/server/ext/lib. Vous pouvez télécharger ce pilote ici : https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

Le fichier ressemblera à ceci : ojdbc8-12.2.0.1.jar.

Variable	Value
USER	The name of the database user to use
PASSWORD	The password for the database user (note that the application will hide this password automatically after it has started, so you may see a different value after it has started)
DIALECT	Depends on the version of Oracle database: org.hibernate.dialect.OracleDialect (Oracle prior to version 8) org.hibernate.dialect.Oracle8Dialect (Oracle 8) org.hibernate.dialect.Oracle9Dialect (Oracle 9) org.hibernate.dialect.Oracle9iDialect (Oracle 9i) org.hibernate.dialect.Oracle10gDialect (Oracle 10 and newer)
DRIVER	oracle.jdbc.driver.OracleDriver
URL	jdbc:oracle:thin:@[HOST]:[PORT]:[XE](Replace the variables in the URL)
HOST	The name of the Oracle Server
PORT	The port on which Oracle is listening (default: 1521)
XE	The XID of the configuration database instance

Initialisation de la base de données

L'outil utilisé pour initialiser la base de données est sfiler-config-cli, qui est automatiquement installé avec le serveur. Il existe un script appelé sfiler-config-cli (.bat pour Windows et .sh pour Linux) situé dans le dossier [répertoire d'installation]/server.

Note

Avant de lancer la commande permettant d'initialiser la base de données, assurez-vous d'avoir bien déposé dans le répertoire [répertoire d'installation]/server/ext/lib le pilote JDBC correspondant à votre base de données.

Vous devez exécuter la commande suivante :

shell

sfiler-config-cli.[bat/sh] -l db_user_name -p *db_password* update-db-schema

Les paramètres db_user_name et db_password représentent les informations d'identification qui seront utilisées pour se connecter à la base de données et effectuer les modifications. Cela nécessitera des accès de type alter, create, drop et autres. Assurez-vous donc que l'utilisateur de la base de données spécifié dans la commande a un rôle d'administrateur.

Si vous souhaitez que l'on vous demande le mot de passe au lieu de l'indiquer sur la ligne de commande, n'utilisez pas l'option -p, n'indiquez aucune option pour le mot de passe.

Attribution d'un nom d'instance à votre serveur S-Filer

L'instance est un nom unique qui sera utilisé pour identifier votre serveur S-Filer. Vous pouvez attribuer un nom d'instance à votre serveur S-Filer en spécifiant celui-ci dans le fichier [répertoire d'installation]/server/conf/sfiler.conf. Vous devez modifier la ligne suivante :

shell

cfg.server.local.config.instanceName=[INSTANCE_NAME]

Note

Si vous choississez de modifier le nom d'instance, assurez-vous que celui-ci soit identique au nom attribuer dans la console administrative.

Création d'un fichier de service systemd

Configuration de la console d'administration

Par défaut, la console d'administration de S-Filer Portal n'est pas configurée pour utiliser le protocole SSL. Si vous voulez activer le SSL, vous pouvez le faire avant de démarrer le serveur S-Filer Portal en utilisant l'outil sfiler-config-cli. Il existe un script appelé sfiler-config-cli (.bat pour Windows et .sh pour Linux) situé dans le dossier [répertoire d'installation]/server.

Importation d'une clé privée existante avant le démarrage du serveur

Vous pouvez importer une clé privée existante avant de démarrer le serveur en utilisant l'outil sfiler-config-cli. Il existe un script appelé sfiler-config-cli (.bat pour Windows et .sh pour Linux) situé dans le dossier [répertoire d'installation]/server.

Vous devez exécuter la commande suivante :

shell

sfiler-config-cli.\[bat/sh\] -l *db_user_name* -p *db_password* import-certificate-file -a *alias* -pw *keystore_password* -f *path/to/key_pair* -apply-configurator

Les paramètres db_user_name et db_password représentent les informations d'identification qui seront utilisées pour se connecter à la base de données et effectuer les modifications. L'alias est un nom unique qui sera stocké dans la base de données pour identifier cette clé. Le mot de passe keystore_password est le mot de passe protégeant le fichier keystore qui sera importé. L'argument '-f' est le chemin d'accès au fichier keystore contenant la clé privée à importer.

Générer une clé privée avant de démarrer le serveur

Vous générez une clé privée avant de démarrer le serveur en utilisant l'outil sfiler-config-cli. Il existe un script appelé sfiler-config-cli (.bat pour Windows et .sh pour Linux) situé dans le dossier [répertoire d'installation]/server.

Vous devez exécuter la commande suivante :

shell

sfiler-config-cli.\[bat/sh\] -l *db_user_name* -p *db_password* generate-key-pair -a *alias* -ks *key_size* -h *host* -d *duration* -apply-configurator

Les paramètres db_user_name et db_password représentent les informations d'identification qui seront utilisées pour se connecter à la base de données et effectuer les modifications. L'alias est un nom unique qui sera stocké dans la base de données pour identifier cette clé. La taille de la clé est la taille de la clé qui sera générée (les valeurs prises en charge sont 2048 et 4096). L'hôte deviendra l'attribut CN de la clé générée. La durée est la période de validité (en années) de la clé qui sera générée (la valeur doit être comprise entre 1 et 10).

Configuration de la clé privée dans la console d'administration

Note

La console administrative ne sera accessible que si le serveur S-Filer Portal est démarré.

Si vous préférez, vous pouvez utiliser la console administrative pour configurer sa propre clé privée SSL. Vous devrez d'abord démarrer le serveur S-Filer Portal et accéder à la console d'administration à l'aide d'une URL non sécurisée :

http://server-host:8090/Login.action

Dans l'arborescence de gauche, vous pouvez accéder à l'option "Console administrative".

Le panneau de configuration de la console d'administration s'affiche alors et vous permet de modifier certaines informations.

Port : Le port utilisé pour accéder à la console d'administration.
SSL : Détermine si les communications avec la console administrative administrative utiliseront le protocole SSL.
Clé privée SSL/TLS : Si SSL est activé, vous devez choisir la clé privée qui sera utilisée pour les communications SSL. Vous devez ajouter cette clé dans le gestionnaire de certificats (utilisez le lien Gestion des certificats dans l'arborescence de gauche) avant de la sélectionner dans la liste déroulante.

L'option Autoriser les algorithmes de chiffrement SSL/TLS faible peut être réglée sur Oui pour activer les algorithmes de chiffrement faibles qui ont été supprimés dans S-Filer Portal 4.5.3. La valeur par défaut est Non.

Cliquez sur "Sauvegarder" une fois que vous avez fini de configurer la console d'administration.

Vous devez redémarrer le serveur S-Filer Portal après avoir modifié l'une ou l'autre de ces propriétés.

Démarrez votre serveur S-Filer Portal

Windows

Allez dans le gestionnaire de services et démarrez le serveur. Localisez le service appelé S-Filer Server et démarrez-le.

Linux

Sur la ligne de commande, exécutez :

shell

service sfiler start

Selon votre version d'UNIX (Linux, Solaris, BSD ou autre), il est possible que certains ajustements soient nécessaires dans le script de démarrage. il est possible que certains ajustements soient nécessaires dans le script de démarrage. La version version distribuée a été validée pour les environnements de type Red Hat.

Configuration du serveur

Selon votre version d'UNIX (Linux, Solaris, BSD ou autre), il est possible que certains ajustements soient nécessaires dans le script de démarrage. La version distribuée a été validée pour les environnements de type Red Hat.

https://server-host:8090/Login.action

La connexion au configurateur se fait à l'aide des informations d'identification de la base de données. L'utilisateur spécifié pour se connecter sera l'utilisateur qui effectuera les modifications dans la base de données. Étant donné que le configurateur n'utilise que des requêtes de manipulation de données (insertion, mise à jour, suppression), il est conseillé de ne pas utiliser ici un utilisateur ayant un rôle d'administrateur.

Utilisateur : L'utilisateur de la base de données
Mot de passe : Le mot de passe de la base de données

Configuration initiale de S-Filer Portal

Le panneau de configuration initiale s'affiche et vous devez y saisir certaines informations.

Server Name : Entrez un nom pour votre instance de serveur. Ce nom doit correspondre à celui défini dans le paramètre cfg.sfiler.instance.name du fichier [Installer folder]/server/conf/sfiler.conf. La valeur par défaut dans le fichier de configuration est Server1 ; veillez donc à la mettre à jour si vous choisissez un autre nom. Dans cet exemple, nous utiliserons "mycompany_server".
Adresse IP : Entrez l'adresse ou le nom d'hôte de la machine de votre serveur s-filer
Port : Il s'agit du port que le serveur S-Filer Portal écoutera pour communiquer avec les autres composants. La valeur par défaut est "8088".
SSL : Détermine si les communications avec le serveur utiliseront le protocole SSL.
Clé privée SSL/TLS : Si SSL est activé, vous devez choisir la clé privée qui sera utilisée pour les communications SSL. Vous devez ajouter cette clé dans le gestionnaire de certificats (utilisez le lien Gestion des certificats dans l'arborescence de gauche) avant de la sélectionner dans la liste déroulante.
Administrator Email : Entrez l'adresse électronique de la personne qui administrera S-Filer Portal.
Licence : Entrez la licence qui vous a été fournie par Okiok. Elle est représentée par une longue chaine de caractères comprenant des chiffres et des lettres.
Langue par défaut : Entrez la langue que vous voulez utiliser dans la console d'administration de S-Filer Portal.
Authentification interne : Entrez un nom pour le mécanisme d'authentification de la base de données interne. La valeur par défaut est "Business Partners".

Important

Après avoir créé l'instance de serveur dans le configurateur et modifié la propriété cfg.sfiler.instance.name dans le fichier [Dossier d'installation]/server/conf/sfiler.conf (si nécessaire), vous devez redémarrer le serveur.

Définition des règles de proxy

Il est possible de relayer les demandes de transfert vers la passerelle ou de configurer un serveur web (Apache ou IIS) pour effectuer cette tâche. La principale raison d'utiliser l'application du serveur web est que celui-ci possède déjà des certificats d'entreprise et du matériel cryptographique. En déléguant les demandes de relais à la passerelle S-Filer Portal, il est nécessaire de configurer correctement tous les certificats et le matériel cryptographique requis pour établir les règles du proxy qui se trouvent dans le Proxy dans le paquet d'installation. Un sous-répertoire contient des exemples de configuration pour Apache IIS.

Règles de proxy pour Apache

Pour configurer les règles de proxy pour Apache, vous devez vous assurer que les modules mod_proxy et mod_proxy_http sont installés et actifs. Par défaut, Apache est distribué avec deux modules. Cependant, il se peut qu'ils ne soient pas activés. Pour les activer, ouvrez le fichier de configuration principal d'Apache httpd.conf ou apache.conf selon votre système d'exploitation et assurez-vous que les modules suivants sont activés (supprimez le symbole de commentaire #).

mod_proxy
mod_proxy_http

Il faut ensuite déployer le fichier sfiler.conf sous l'arbre de configuration d'Apache. Dans la plupart des cas, copier le fichier dans le répertoire conf.d est suffisant. Si ce répertoire n'existe pas, il faut insérer le contenu de sfiler.conf directement dans la configuration d'Apache.

shell

<IfDefine SSL>
  SSLProxyEngine on
</IfDefine>

ProxyRequests off

#server
ProxyPass /sfiler/server/ http://domainName:8088/
ProxyPassReverse /sfiler/server/ http://domainName:8088/

#web interface
ProxyPass /sfiler/ http://domainName:8081/sfiler/
ProxyPassReverse /sfiler/ http://domainName:8081/sfiler/

<Location /domainName/>
  Order allow,deny
  Allow from all
</Location>

Vous devez remplacer domainName par l'URL appropriée et modifier les ports si vous n'utilisez pas le port par défaut 8088 pour le serveur et 8081 pour la passerelle.

Proxy pour IIS

Le proxy via IIS est réalisé à l'aide de l'Application Request Routing de Microsoft.

Vous devez télécharger Microsoft Application Request Routing.

Fichier requestRouter_amd64.msi version 3 et rewrite_amd64_en-US.msi version 2.

Pour installer Application Request Routing

Ouvrez une invite de commande avec des droits d'administrateur.
Arrêtez les processus WAS et WMSVC en entrant ce qui suit :

shell

net stop was /y
net stop w3svc /y

Exécutez requestRouter_amd64.msi :
Accepter le contrat de licence de l'utilisateur final (EULA).
Terminez l'installation
Installer le module de réécriture d'URL d'IIS.
Exécuter rewrite_amd64_fr-US.msi
Accepter le contrat de licence utilisateur final (CLUF) et installer le logiciel.
Terminez l'installation.
Lancez les processus WAS et W3SVC en entrant ce qui suit :

net start was
net start w3svc

Une fois installé, vous verrez le cache de routage des demandes d'application, ouvrez cette fonctionnalité.

Allez dans les paramètres du proxy du serveur

Activer le proxy et laisser tous les autres champs avec les valeurs par défaut et appliquer le changement. L'avertissement est correct.

Dans votre site Web, il y aura une icône de réécriture d'URL, cliquez sur cette icône pour ajouter une règle.

Cliquez sur Add rule(s)

Ajouter la règle Le motif est sfiler/(.\*)

L'URL de réécriture pour S-Filer Portal s'assure que dans les propriétés de l'action, toutes les options sont actives.

Dans l'exemple, la règle de réécriture est https://host114.winsupp.com:8081/{R:0} si vous avez choisi un autre port pour le protocole HTTP dans la passerelle, utilisez-le à la place.

Testez la règle en utilisant l'URL de l'application dans ce cas https:/w2k8-vm-test01/sfiler/

Le test de la règle montre les références arrière à la règle 0 qui correspond au motif et transmettra la valeur sfiler/, ce qui est ce que nous voulons pour l'application S-Filer Portal.

Appliquer et redémarrer IIS

Nous sommes maintenant prêts à tester l'application S-Filer Portal.

Le service de la passerelle S-Filer Portal doit être redémarré à l'aide du service Windows et non à partir de la console d'administration.

IIS - Modification du paramètre MaxAllowedContentLength

Vous devrez modifier le paramètre maxAllowedContentLength dans IIS pour pouvoir transférer des fichiers volumineux. La valeur par défaut est de 30000000 octets, ce qui correspond à environ 28,6 Mo. Avec cette valeur, vous ne pourrez pas transférer des fichiers de plus de 29 Mo. La procédure suivante montre comment modifier cette valeur dans IIS afin de pouvoir transférer des fichiers plus volumineux.

Pour modifier cette valeur, ouvrez IIS Admin, cliquez sur Sites and Your Web Site.

Double-cliquez sur Configuration Editor et descendez jusqu'à system.webServer -- security -- requestFiltering

Ouvrez "requestLimits" et modifiez le paramètre maxAllowedContentLength au niveau souhaité. La valeur par défaut est de 30000000 octets, soit environ 28,6 Mo. Modifiez le paramètre en fonction de vos besoins. IIS 7.5 a une taille maximale de 2GB (2147483648 octets) et IIS 8.5 et 10.0 a une taille maximale de 4GB (4294967295 octets).

(longueur de contenu maximale autorisée)*

Redémarrez IIS pour appliquer les modifications.

Mise à jour du serveur

Il est possible de mettre à jour une instance existante du serveur S-Filer Portal. Ceci peut être utile pour ajouter les dernières fonctionnalités de S-Filer Portal à votre produit existant tout en conservant votre configuration actuelle.

Mise à jour à l'aide du programme d'installation

Lancez d'abord le programme d'installation. Après avoir lu et accepté la licence, vous devez sélectionner le type d'installation. licence, vous devez sélectionner le type d'installation. Sélectionnez "Mise à jour".

Ensuite, vous êtes invité à entrer votre répertoire d'installation existant. L'Updater vérifie que le chemin d'installation fourni contient une instance de S-Filer Portal et empêche l'utilisateur de continuer si un chemin erroné est spécifié.

Après avoir sélectionné votre installation existante, vous devez choisir un nouveau dossier temporaire qui sera utilisé par le serveur. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

Avant que la mise à jour ne commence, vous serez invité à arrêter votre service S-Filer Portal existant avant de procéder à l'installation. Bien que le programme de mise à jour tente de l'arrêter de lui-même, il est plus prudent que l'utilisateur le fasse lui-même. La mise à jour d'un service en cours d'exécution peut entraîner l'échec de l'installation.

Enfin, vous devez valider les paramètres de l'installation avant qu'elle ne commence à copier les fichiers sur le système cible. Si les paramètres sont valides, cliquez sur le bouton Install pour poursuivre l'installation. Assurez-vous d'avoir un accès en écriture à votre répertoire d'installation et à tout son contenu. Si l'Updater n'est pas en mesure d'installer des fichiers dans votre répertoire d'installation parce que l'autorisation vous est refusée, l'installation sera interrompue.

Après chaque mise à jour, exécutez la commande suivante avant de démarrer le serveur S-Filer Portal pour vous assurer que les mises à jour du schéma seront effectuées. Si vous oubliez d'exécuter la commande suivante et qu'il y a des mises à jour de schéma, lorsque vous vous connectez à la console d'administration, vous obtiendrez un message indiquant que le schéma de la base de données doit être mis à jour.

shell

sfiler-config-cli.bat -l nom_utilisateur_db -p *mot_de_passe* update-db-schema

Une fois la mise à jour effectuée, redémarrez votre service via le gestionnaire de service. Si vous utilisez un modèle de courrier personnalisé, votre modèle de pré-installation sera sauvegardé dans votre répertoire d'installation sous /server/etc/mail.backup.

Mise à jour à l'aide de la ligne de commande

Pour lancer la mise à jour, exécutez le fichier sfiler-server-installer.bin. Assurez-vous d'avoir les permissions adéquates sur le fichier exécutable. Si ce n'est pas le cas, exécutez la commande suivante :

shell

chmod 755 sfiler-server-installer.bin

Une fois que les droits sur le fichier sont appropriés, lancez l'installation directement à partir de la ligne de commande:

shell

./sfiler-server-installer.bin

La première étape du programme d'installation vous invite à choisir la langue.

shell

[root@localhost tmp]# ./sfiler-server-installer.bin

Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

===============================================================================

Choose Locale...
----------------


->1- English
  2- Español
  3- Français

CHOOSE LOCALE BY NUMBER:

Après avoir accepté la licence, vous êtes invité à indiquer le type d'installation du serveur. Veuillez sélectionner "Mise à jour".

shell

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

===============================================================================
Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

->1- Complete Installation
  2- Update

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS \<ENTER\> TO ACCEPT THE
DEFAULT

  : 2

Ensuite, vous êtes invité à indiquer le répertoire d'installation du serveur. Veuillez entrer le répertoire de votre produit S-Filer Portal existant. Si le répertoire spécifié est incorrect, l'Updater ne pourra pas procéder à la mise à jour.

shell

===============================================================================
Choose Install Folder
---------------------

If you are upgrading, please choose your existing install directory
Where would you like to install?

  Default Install Folder: /usr/local/sfiler-server

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

  :

Vous devez maintenant choisir un nouveau dossier temporaire qui sera utilisé par le serveur. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

shell

===============================================================================
Temporary folder
----------------

Enter the location of the temporary folder that will be used by the
server. If the folder doesn't exist, it will be created. Please confirm that you
have write permissions in the selected location.

Please Choose a temporary folder (Default: /tmp):

Ensuite, veuillez arrêter votre serveur S-Filer Portal existant s'il est en cours d'exécution. Bien que le programme de mise à jour tente de l'arrêter lui-même au cours du processus d'installation, il est plus sécuritaire que l'utilisateur le fasse lui-même. La mise à jour d'un service en cours d'exécution peut faire échouer l'installation. Assurez-vous également que vous avez un accès en écriture à votre répertoire d'installation et à tout son contenu. Si l'Updater n'est pas en mesure d'installer des fichiers dans votre répertoire d'installation en raison d'un refus d'autorisation, l'installation sera interrompue.

shell

===============================================================================
Warning
-------

Make sure to stop the existing S-Filer Server service before starting
the nstallation

PRESS <ENTER> TO CONTINUE:
===============================================================================
Pre-Installation Summary
------------------------


Please Review the Following Before Continuing:

Product Name:
    S-Filer Server

Install Folder:
    /usr/local/sfiler-server

Link Folder:
    /root

Disk Space Information (for Installation Target):
    Required: 514,199,965 Bytes
    Available: 29,649,932,288 Bytes

PRESS <ENTER> TO CONTINUE:

Enfin, si les paramètres d'installation sont corrects, appuyez sur ENTRÉE pour terminer la mise à jour du serveur S-Filer Portal.

shell

===============================================================================
Ready To Install
----------------

InstallAnywhere is now ready to install S-Filer Server onto your system
at the following location:

/usr/local/sfiler-server

PRESS <ENTER> TO INSTALL:

On peut alors suivre la progression de l'installation.

shell

Installing...
-------------

[==================|==================|==================|==============
[------------------|------------------|------------------|------------

La dernière étape confirme que l'installation a réussi. En cas de problème, veuillez contacter le service d'assistance. Si vous utilisez un modèle de courrier personnalisé, votre modèle de pré-installation sera sauvegardé dans votre répertoire d'installation sous /server/etc/mail.backup.

shell

===============================================================================
Installation Complete
---------------------

Congratulations. S-Filer Server has been successfully installed to:

    /usr/local/sfiler-server

PRESS <ENTER> TO EXIT THE INSTALLER:

shell

sfiler-config-cli.sh -l db_user_name -p *db_password* update-db-schema

Désinstallation du serveur

La désinstallation du serveur s'effectue en exécutant l'exécutable à partir de la console de ligne de commande ou du menu approprié dans les installations graphiques de Windows. Dans les deux cas, le programme de désinstallation supprime le composant serveur mais ne détruit pas nécessairement tous les fichiers (tels que les fichiers temporaires et les fichiers journaux). Il se peut que vous deviez supprimer ces fichiers manuellement.

Désinstallation sous Windows

Sous Windows, utilisez l'utilitaire pour ajouter ou supprimer des programmes. Cet utilitaire est accessible à partir du Panneau de configuration. Il est très important d'arrêter le serveur S-Filer Portal avant de commencer le processus de désinstallation.

Sélectionnez le serveur S-Filer Portal et cliquez sur le bouton Uninstall/Modify.

Vous serez alors invité à confirmer la désinstallation.

A la fin de la procédure de désinstallation du serveur, il est possible que certains fichiers n'aient pas été supprimés. Il sera nécessaire de les supprimer manuellement.

Une fois supprimés, il peut vous être demandé de redémarrer.

Désinstallation à l'aide de la ligne de commande

La désinstallation du serveur S-Filer Portal sous UNIX nécessite le lancement de l'utilitaire de désinstallation dans la ligne de commande. Assurez-vous d'avoir les droits d'accès nécessaires sur droits d'accès nécessaires sur :

shell

./Uninstall S-Filer Server

Vous serez invité à confirmer la désinstallation. Appuyez sur ENTRÉE pour confirmer. Il se peut que vous obteniez un message d'erreur indiquant que tous les fichiers n'ont pas été supprimés. Utilisez simplement la commande suivante pour les supprimer :

shell

rm --rf sfiler-server

La passerelle

S-Filer Portal Gateway vous permet d'étendre les protocoles de transfert. Sans cette composante, les transferts de fichiers sont réservés uniquement au protocole HTTP. Avec cette passerelle, il devient possible d'étendre l'utilisation de S-Filer Portal aux protocoles FTP, FTPS et SFTP. La passerelle est un composant qui est habituellement installé dans une zone démilitarisée (DMZ).

Ce chapitre vous présente l'installation de la passerelle S-Filer Portal ainsi que sa configuration de base.

Configuration de la passerelle

Créer la passerelle

Retournez à la console d'administration et cliquez sur l'instance du serveur S-Filer Portal dans l'arborescence de gauche. Dans ce cas, nous cliquons sur mycompany_server.

Dans le panneau de droite, cliquez sur "Ajouter une nouvelle passerelle-client au serveur". Dans le panneau suivant, vous devez configurer le nom et l'hôte de votre votre passerelle.

Nom : Entrez un nom pour votre instance de passerelle. Dans cet exemple, nous utiliserons "mycompany_gateway".

Une fois que vous êtes satisfait de la configuration, cliquez sur "Ajouter la passerelle client". Ceci ajoutera l'instance de la passerelle.

Dans l'arborescence de gauche, si vous développez "mycompany_server", vous pouvez voir que "mycompany_gateway" est maintenant présent en tant que dernière option.

Activer le web gui

Ouvrez "mycompany_server / mycompany_gateway " et cliquez sur Configuration. Dans le panneau de droite, cliquez sur l'onglet supérieur appelé Configurations avancées

Dans le panneau de droite, l'unique ligne de configuration appelée "Installer l'interface Web " doit être réglée sur "Oui". Cliquez sur "Sauvegarder".

Autre configuration

Dans l'arborescence de gauche, ouvrez "mycompany_server/mycompany_gateway/Configuration", cliquez sur "Protocole", puis cliquez sur l'onglet supérieur "HTTPS".

Définissez les valeurs suivantes

Activer : Oui
Adresse IP : Adresse IP où le serveur HTTPS écoute les demandes de connexion entrantes. (La valeur par défaut est 0.0.0.0)
Port : 8081
SSL : Oui
Clé privée SSL : Si SSL est activé, vous devez choisir la clé privée qui sera utilisée pour les communications SSL. Vous devez ajouter cette clé dans le gestionnaire de certificats (utilisez le lien Gestion des certificats dans l'arborescence de gauche) avant de la sélectionner dans la liste déroulante.

Le port peut être modifié en fonction des exigences de déploiement de votre infrastructure.

Le champ Allow weak SSL/TLS ciphers peut être réglé sur Yes (Oui) pour activer les algorithmes de chiffrement faibles qui ont été supprimés dans S-Filer 4.5.3. La valeur par défaut est Non.

Cliquez sur "Sauvegarder" une fois que vous avez terminé la configuration de HTTPS.

Pour configurer FTPS :

Définissez les valeurs suivantes

Activer : Oui
Port (FTPS explicite) : 21 (le port par défaut est 21)
Adresse IP : Adresse IP où le serveur FTP écoute les demandes de connexion entrantes. (La valeur par défaut est 0.0.0.0)
Port (FTPS implicite) : 990 (le port par défaut est 990)
Clé privée SSL : Vous devez choisir la clé privée qui sera utilisée pour les communications SSL. Vous devez ajouter cette clé dans le gestionnaire de certificats (utilisez le lien Gestion des certificats dans l'arborescence de gauche) avant de la sélectionner dans la liste déroulante.
Passive data port Range Start : 60000 (Le début de la plage du port de données et devra être ouvert dans le pare-feu)
Port de données passif Fin : 60020 (Le port de données se termine et doit être ouvert dans le pare-feu)
Adresse IP publique : Il s'agit de l'adresse envoyée en réponse à la commande PASV. Elle doit être visible par les clients du serveur FTP(S). Vous devez spécifier cette adresse si le serveur dispose de plusieurs interfaces réseau ou s'il se trouve derrière un équipement de transfert de port. Laissez le champ vide pour utiliser l'adresse du serveur.
Autoriser les algorithmes SSL/TLS faibles : NON

L'option Autoriser les algorithmes de chiffrement SSL/TLS faible peut être réglée sur Oui pour activer les algorithmes de chiffrement faibles qui ont été supprimés dans la version 4.5.3 de S-Filer Portal. La valeur par défaut est Non.

Cliquez sur "Sauvegarder" une fois que vous avez terminé la configuration de FTPS.

Pour configurer SFTP :

Définissez les valeurs suivantes

Activer : Oui
Adresse IP : Adresse IP où le serveur SFTP écoute les demandes de connexion entrantes. (La valeur par défaut est 0.0.0.0)
Port : 22 (Le port par défaut est 22)
Clé SSH : Vous devez choisir la clé SSH qui sera utilisée. Vous devez ajouter cette clé dans le gestionnaire de certificats (utilisez le lien Gestion des certificats dans l'arborescence de gauche) avant de la sélectionner dans la liste déroulante.
Server Banner (Bannière du serveur) : Bannière affichée par le serveur SSH de la passerelle
Autoriser les algorithmes de chiffrement SSH faibles : Non

L'option Allow weak SSL/TLS ciphers peut être réglée sur Yes pour activer les algorithmes de chiffrement faibles qui ont été supprimés dans la version 4.5.3 de S-Filer Portal. La valeur par défaut est Non.

Cliquez sur "Sauvegarder" une fois que vous avez terminé la configuration de SFTP.

Configuration de l'interface utilisateur Web

Ajouter une interface graphique Web

Cliquez sur l'option de l'arborescence de gauche "SFiler Portal ". Cliquez sur l'instance du serveur. Dans ce cas, nous cliquons sur mycompany_server.

Dans le panneau de droite, cliquez sur Ajouter l'interface Web. Dans le panneau suivant, vous pouvez entrer des informations sur votre instance d'interface web.

Nom : mycompany_gui (il s'agit d'un exemple pour ce scénario)

Cliquez sur "Ajouter l'interface Web".

Configuration supplémentaire

Dans l'arborescence de gauche, ouvrez "mycompany_server/mycompany_gui" et cliquez sur "Configuration".

Sur la ligne "URL du serveur", sélectionnez l'option "Personnalisé". Dans le champ à droite de l'option, entrez l'adresse d'écoute du serveur, qui dans cet exemple serait : http://server-host:8088/. Cliquez sur le bouton Sauvegarder dans le coin supérieur droit.

Installation de la passerelle

Configurations de base

Avant de pouvoir démarrer la passerelle, vous devez importer la Configuration de base dans les fichiers de configuration de la passerelle (sfiler.conf et gui.conf). Le fichier de configuration de base regroupe les paramètres de configuration qui permettront de communiquer de façon sécuritaire avec le serveur S-Filer Portal . Il est nécessaire d'obtenir ces configurations de base pour tous les composants qui doivent être installés. Pour avoir une configuration de base valide, les certificats de confiance doivent avoir été importés au préalable dans le gestionnaire de certificats de la console d'administration. Lorsque tout est en place, développez "mycompany_server / mycompany_gateway" dans le panneau de droite et cliquez sur le lien "download configurations". Il vous sera demandé d'utiliser sfiler-config-cli pour importer les configurations de base plus tard dans la procédure d'installation.

Répétez cette opération pour tous les composants qui existent dans votre infrastructure S-Filer Portal. Comme pour la passerelle, vous devrez utiliser le logiciel sfiler-config-cli pour importer la configuration.

Installation de la Passerelle à l'aide du programme d'installation

Le client reçoit dans sa communauté de support S-Filer Portal le paquet approprié pour son environnement.

Vous pouvez lancer l'installateur en cliquant directement sur l'exécutable sfiler-gateway-installer.exe. Pour les versions Windows Core, vous pouvez utiliser le paramètre -i console sur la ligne de commande : sfiler-gateway-installer.exe -i console

Après avoir lancé le programme d'installation, celui-ci vous invite à fermer toutes les applications en cours d'exécution afin d'éliminer toutes les sources de conflit. Une fois toutes les applications fermées, vous devez cliquer sur le bouton Next pour passer à l'étape suivante.

Vous êtes alors invité à lire et à accepter la licence d'utilisation du produit S-Filer Portal. Pour accepter la licence, vous devez cliquer sur le bouton Next. Si vous désirez obtenir plus d'information sur la licence, veuillez communiquer avec votre soutien technique.

Une fois que vous avez accepté la licence, vous devez sélectionner le type d'installation. Une "Installation complète" installera tous les composants et fichiers de configuration requis. Si vous installez S-Filer Portal pour la première fois, veuillez sélectionner cette option. Une "Mise à jour" mettra à jour votre installation existante de S-Filer Portal avec de nouvelles fonctionnalités et laissera vos fichiers de configuration intacts.

Enfin, vous devez choisir un dossier temporaire qui sera utilisé par la passerelle. Si le dossier n'existe pas, il sera créé pendant l'installation.

L'étape suivante consiste simplement à valider l'installation. Si tous les paramètres sont valides, cliquez sur le bouton Install pour lancer l'installation de la Passerelle.

À la fin de l'installation, si tout s'est bien déroulé, un message apparait indiquant que l'installation est terminée. Si une erreur survient durant l'installation, notez-la et contactez le support technique.

Une fois le processus d'installation terminé, il est temps de procéder à l'importation de la configuration de base. Il s'agit des fichiers que vous devez récupérer à partir de la console d'administration. Il faut maintenant déplacer ces fichiers dans le dossier "gateway" de l'installation de la passerelle S-Filer Portal. Pour procéder à l'importation, vous devez ouvrir une fenêtre DOS dans le dossier d'installation de la passerelle S-Filer Portal. Dans ce dossier, vous avez maintenant un nouvel utilitaire de ligne de commande appelé sfiler-config-cli. Exécutez la commande avec les arguments qui correspondent aux spécificités de votre installation :

shell

sfiler-config-cli.bat set-basic-config -bcdf [instance-name]-conf-gateway.txt -scf conf/sfiler.conf.template

Répétez la même opération pour l'interface Web :

shell

sfiler-config-cli.bat set-basic-config -bcdf [instance-name]-conf-gateway.txt -scf conf/gui.conf.template

Cette dernière opération termine la procédure d'installation de la passerelle S-Filer Portal. Vous pouvez prendre le temps de valider que les propriétés des fichiers conf/sfiler.conf.template et conf/gui.conf.template sont remplies. Si ce n'est pas le cas, pensez à consulter les logs de sfiler-config-cli situés dans le dossier /logs.

Installation de la Passerelle à l'aide de la ligne de commande

Pour démarrer l'installation, exécutez le fichier sfiler-gateway-installer.bin. Assurez-vous que vous disposez des autorisations nécessaires sur le fichier exécutable. Si ce n'est pas le cas, exécutez la commande suivante :

shell

chmod 755 sfiler-gateway-installer.bin

Une fois que les droits sur le fichier sont appropriés, lancez l'installation directement à partir de la ligne de commande :

shell

./sfiler-gateway-installer.bin

La première étape du programme d'installation vous invite à choisir la langue.

shell

[root@localhost tmp]# ./sfiler-gateway-installer.bin

Preparing to install

Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...

===============================================================================

Choose Locale...
----------------

->1- English
  2- Español
  3- Français

CHOOSE LOCALE BY NUMBER:

L'installation vous invite ensuite à fermer toutes les applications en cours d'exécution afin d'éliminer tout conflit éventuel. Appuyez sur ENTRÉE pour passer à l'étape suivante.

shell

===============================================================================
S-Filer Gateway                                  (created with InstallAnywhere)
-------------------------------------------------------------------------------

Preparing CONSOLE Mode Installation...

===============================================================================
Introduction
------------

InstallAnywhere will guide you through the installation of S-Filer Gateway.

It is strongly recommended that you quit all programs before continuing
with this installation.

Respond to each prompt to proceed to the next step in the installation.
If you want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

Le texte de la licence s'affiche ; vous devez accepter les conditions d'utilisation de la solution pour poursuivre l'installation. Appuyez sur Y (pour Oui) pour passer à l'étape suivante. Si vous souhaitez obtenir plus d'informations sur la licence, veuillez contacter le service d'assistance.

Après avoir accepté la licence, vous êtes invité à choisir le type d'installation de la passerelle. Une "Installation complète" installera tous les composants et fichiers de configuration requis. Si vous installez S-Filer Portal pour la première fois, veuillez sélectionner cette option. Une "Mise à jour" mettra à jour votre installation existante de S-Filer Portal avec de nouvelles fonctionnalités et laissera vos fichiers de configuration intacts.

shell

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

===============================================================================
Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

->1- Complete Installation
  2- Update

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE
DEFAULT

:

Ensuite, vous êtes invité à indiquer le répertoire d'installation du serveur. Pour accepter le répertoire par défaut, appuyez sur la touche ENTRÉE dans le répertoire cible si vous le souhaitez.

shell

===============================================================================
Choose Install Folder
---------------------

If you are upgrading, select the existing install directory.

Where would you like to install?

    Default Install Folder: /usr/local/sfiler-gateway

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

 :

Vous devez maintenant choisir un dossier temporaire qui sera utilisé pour la passerelle. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

shell

===============================================================================
Temporary folder
----------------

Enter the location of the temporary folder that will be used by the
Gateway. If the folder doesn't exist, it will be created. Please confirm that you
have written permissions in the selected location.

Please Choose a temporary folder (DEFAULT: /tmp):

Il vous sera alors demandé le nom et l'endroit où vous souhaitez ajouter le script de démarrage du serveur. Vous avez deux options ; l'une est de le placer dans le répertoire /etc/init.d ou de le créer dans le répertoire d'installation.

shell

===============================================================================
Startup script name
-------------------

Enter the name of the startup script. If you are installing on a machine
that already has a Gateway installed, be careful to choose a different file
name than the one used in previous installations.

Startup script name (DEFAULT: sfiler-gateway):

===============================================================================
Choose the startup script path
------------------------------

Select the path where you would like to have the startup script. If you
have root access, select option 1, otherwise choose option 2 to install them
in the install folder.

->1- /etc/init.d
  2- Installed Folder (non root access)

ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE
DEFAULT:

L'étape suivante consiste simplement à confirmer les paramètres sélectionnés.

shell

===============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    S-Filer Gateway

Install Folder:
    /usr/local/sfiler-gateway

Link Folder:
    /root

Disk Space Information (for Installation Target):
    Required: 447,100,864 Bytes
    Available: 31,342,125,056 Bytes

PRESS <ENTER> TO CONTINUE:

Si les paramètres sont corrects, appuyez sur ENTRÉE pour poursuivre l'installation de S-Filer Gateway / Portal.

shell

===============================================================================
Ready To Install
----------------

InstallAnywhere is now ready to install S-Filer Gateway onto your system
at the following location:
    /usr/local/sfiler-gateway

PRESS <ENTER> TO INSTALL:

On peut alors suivre la progression de l'installation.

Une dernière étape confirme que l'installation a réussi. En cas de problèmes, veuillez contacter l'assistance.

shell

===============================================================================
Installation Complete
---------------------

Congratulations. S-Filer Gateway has been successfully installed to:
    /usr/local/sfiler-gateway

Your old themes has been saved at:
    /usr/local/sfiler-gateway/gateway/

PRESS <ENTER> TO EXIT THE INSTALLER:

Une fois le processus d'installation terminé, il est temps de procéder à l'importation de la configuration de base. Il s'agit des fichiers que vous devez récupérer à partir de la console d'administration. Il faut maintenant déplacer ces fichiers dans le dossier "gateway" de l'installation de la passerelle S-Filer Portal . Pour procéder à l'importation, vous devez ouvrir un shell dans le dossier "gateway" de la passerelle S-Filer Portal. Dans ce dossier, vous avez maintenant un nouvel utilitaire de ligne de commande appelé sfiler-config-cli. Exécutez la commande avec les arguments qui correspondent aux spécificités de votre installation :

shell

sfiler-config-cli.sh set-basic-config -bcdf [instance-name]-conf-gateway.txt -scf conf/sfiler.conf.template

Répétez la même opération pour l'interface Web :

shell

sfiler-config-cli.sh set-basic-config -bcdf [instance-name]-conf-gateway.txt -scf conf/gui.conf.template

Cette dernière opération termine la procédure d'installation de la passerelle S-Filer. Vous pouvez prendre le temps de valider que les propriétés des fichiers conf/sfiler.conf.template et conf/gui.conf.template sont remplies. Si ce n'est pas le cas, vous pouvez consulter les journaux de sfiler-config-cli situés dans le dossier /logs.

À ce stade, vous pouvez maintenant lancer la passerelle S-Filer en exécutant le script de démarrage suivant :

shell

service sfiler-gateway start

Mise à jour de la passerelle

Il est possible de mettre à jour une instance existante de la passerelle S-Filer. Ceci peut être utilisé pour ajouter la plus récente caractéristique de S-Filer à votre produit existant tout en gardant votre configuration actuelle intacte.

Mise à jour de la Passerelle à l'aide du programme d'installation

Lancez d'abord le programme d'installation. Après avoir lu et accepté la licence, vous devez sélectionner le type d'installation. Sélectionnez "Mise à jour".

Ensuite, vous êtes invité à entrer votre répertoire d'installation existant. L'Updater vérifie que le chemin d'installation fourni contient une instance de S-Filer et empêche l'utilisateur de continuer si un chemin erroné est spécifié.

Après avoir sélectionné votre installation existante, vous devez choisir un nouveau dossier temporaire qui sera utilisé par la passerelle. Si le dossier n'existe pas, il sera créé pendant l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

Avant que la mise à jour ne commence, vous serez invité à arrêter votre service S-Filer existant avant de procéder à l'installation. Bien que le programme de mise à jour tente de l'arrêter de lui-même, il est plus sûr que l'utilisateur le fasse lui-même. La mise à jour d'un service en cours d'exécution peut faire échouer l'installation.

Enfin, vous devez valider les paramètres du programme d'installation avant qu'il ne commence à copier les fichiers sur le système cible. Si les paramètres sont valides, cliquez sur le bouton Install pour poursuivre l'installation. Assurez-vous que vous avez un accès en écriture à votre répertoire d'installation et à tout son contenu. Si l'Updater n'est pas en mesure d'installer des fichiers dans votre répertoire d'installation parce que l'autorisation vous est refusée, l'installation sera interrompue.

Une fois la mise à jour effectuée, redémarrez votre service via le gestionnaire de service. Si vous utilisez un thème personnalisé, il a été sauvegardé sous /sfiler-gateway/gateway/webapps.backup

Mise à jour de la Passerelle à l'aide de la ligne de commande

Pour lancer la mise à jour, exécutez le fichier sfiler-gateway-installer.bin. Assurez-vous que vous disposez des autorisations nécessaires sur le fichier exécutable. Si ce n'est pas le cas, exécutez la commande suivante :

shell

chmod 755 sfiler-gateway-installer.bin

Une fois que les droits sur le fichier sont appropriés, lancez l'installation directement à partir de la ligne de commande :

shell

./sfiler-gateway-installer.bin

La première étape du programme d'installation vous invite à choisir la langue.

shell

[root@localhost tmp]# ./sfiler-gateway-installer.bin

Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...

===============================================================================
Choose Locale...
----------------

->1- English
  2- Español
  3- Français

CHOOSE LOCALE BY NUMBER:

Après avoir accepté la licence, vous êtes invité à indiquer le type d'installation du serveur. Sélectionnez "Mise à jour".

shell

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y

===============================================================================

Choose Install Set
------------------

Please choose the Install Set to be installed by this installer.

->1- Complete Installation
  2- Update

ENTER THE NUMBER FOR THE INSTALL SET, OR PRESS <ENTER> TO ACCEPT THE
DEFAULT

  : 2

Ensuite, on vous demande le répertoire d'installation de la passerelle. Veuillez entrer le répertoire de votre produit S-Filer existant. Si le répertoire indiqué est incorrect, l'Updater ne pourra pas procéder à la mise à jour.

shell

===============================================================================
Choose Install Folder
---------------------

If you are upgrading, select the existing install directory.

Where would you like to install?

    Default Install Folder: /usr/local/sfiler-gateway

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT

    :

Vous devez maintenant choisir un nouveau dossier temporaire qui sera utilisé par la passerelle. Si le dossier n'existe pas, il sera créé lors de l'installation. Assurez-vous que vous disposez des droits d'écriture sur l'emplacement sélectionné.

shell

===============================================================================
Temporary folder
----------------

Enter the location of the temporary folder that will be used by the
Gateway. If the folder doesn't exist, it will be created. Please confirm that you
have written permissions in the selected location.

Please Choose a temporary folder (DEFAULT: /tmp):

Ensuite, veuillez arrêter votre passerelle S-Filer existante si elle est en cours d'exécution. Bien que le programme de mise à jour tente de l'arrêter de lui-même au cours du processus d'installation, il est plus sécuritaire que l'utilisateur le fasse lui-même. La mise à jour d'un service en cours d'exécution peut faire échouer l'installation. Assurez-vous également que vous avez un accès en écriture à votre répertoire d'installation et à tout son contenu. Si l'Updater n'est pas en mesure d'installer des fichiers dans votre répertoire d'installation en raison d'un refus d'autorisation, l'installation sera interrompue.

shell

===============================================================================
Warning
-------

Make sure to stop the existing S-Filer Gateway service before starting
the installation.

PRESS <ENTER> TO CONTINUE:

===============================================================================

Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    S-Filer Gateway

Install Folder:
    /usr/local/sfiler-gateway

Link Folder:
    /root

Disk Space Information (for Installation Target):
    Required: 447,080,253 Bytes
    Available: 30,207,270,912 Bytes

PRESS <ENTER> TO CONTINUE:

Enfin, si les paramètres d'installation sont corrects, appuyez sur ENTRÉE pour terminer la mise à jour de la passerelle S-Filer Portal.

shell

===============================================================================

Ready To Install
----------------

InstallAnywhere is now ready to install S-Filer Gateway onto your system
at the following location:

    /usr/local/sfiler-gateway

PRESS <ENTER> TO INSTALL:

On peut alors suivre la progression de l'installation.

shell

Installing...
-------------

[==================|==================|==================|==============
[------------------|------------------|------------------|------------

La dernière étape confirme que l'installation a réussi. En cas de problèmes, veuillez contacter le support. Si vous utilisez un thème personnalisé, il a été sauvegardé sous /sfiler-gateway/gateway/webapps.backup

shell

===============================================================================
Installation Complete
----------------

Congratulations. S-Filer Gateway has been successfully installed to:
    /usr/local/sfiler-gateway

Your old themes has been saved at:
    /usr/local/sfiler-gateway/gateway/

PRESS <ENTER> TO EXIT THE INSTALLER:

Désinstallation de la passerelle

Désinstallation de la Passerelle sous Windows

Pour l'environnement Windows, utilisez l'utilitaire pour ajouter ou supprimer des programmes. Cet utilitaire est accessible à partir du Panneau de configuration. Il est très important d'arrêter S-Filer Portal Gateway avant de commencer le processus de désinstallation, sinon il est possible que le processus de désinstallation échoue parce que certains fichiers en cours d'utilisation ne peuvent pas être supprimés avec succès.

Sélectionnez le programme S-Filer Gateway et cliquez sur le bouton Uninstall

Vous serez alors invité à confirmer le processus de désinstallation de la passerelle.

A la fin du processus de désinstallation de la passerelle, il est possible que certains fichiers n'aient pas été supprimés. Il sera nécessaire de supprimer manuellement ces fichiers.

Désinstallation de la Passerelle à l'aide de la ligne de commande

La désinstallation du serveur S-Filer Portal sous Unix nécessite le lancement de l'utilitaire de désinstallation dans la ligne de commande. Assurez-vous d'avoir les droits d'accès nécessaires sur:

shell

./Uninstall_S-Filer Gateway

shell

rm --rf sfiler-gateway

Une fois cette étape terminée, tous les composants de la passerelle S-Filer Portal seront supprimés.

Configuration de l'optimisation des performances

Les paramètres suivants peuvent être modifiés pour ajuster les caractéristiques de performance de S-Filer.

Configuration key	Location	Description	Default value
wrapper.java.initmemory	Fichier: conf/wrapper.conf	Définit la quantité de mémoire utilisée par Java lors du démarrage. La valeur est en Mo.	256
wrapper.java.maxmemory	Fichier: conf/wrapper.conf	Définit la quantité maximale de mémoire utilisée par l'application Java. Cette valeur devrait être augmentée pour gérer plus de demandes simultanément. Le serveur utilisera de 512 Mo à 1 Go de mémoire pour ses processus de base. La plupart des demandes nécessiteront de 1 à 2 Mo de mémoire pour être traitées. Une valeur de 4 Go devrait être capable de gérer près de 1000 demandes simultanées. Les rapports nécessitent beaucoup plus de mémoire, lors de la génération de grands rapports, il peut être nécessaire d'augmenter la mémoire.	512
Receive Timeout	Console d'administration > [Nom du serveur] > Configuration > Onglet: Configurations avancées	Le nombre de millisecondes que le serveur attendra sur une socket avant de recevoir une réponse lorsqu'il se connecte à un système quelconque.	30000 (30 secondes)
Inactivity timeout	Console d'administration > [Nom du serveur] > Configuration > Onglet: Configurations avancées	Nombre de secondes avant que la session de l'utilisateur n'expire. Si un utilisateur ne fait pas de demande dans ce délai, son jeton d'authentification sera invalidé. Notez qu'idéalement, cela devrait être au moins aussi long que le délai d'expiration de la session dans l'interface web pour assurer une expérience utilisateur agréable.	1800 (30 minutes)
Timeout	Console d'administration > [Nom du serveur] > Configuration > Onglet: Console d'administration	Actuellement non utilisé	30000

Accès au portail S-Filer

Si vous travaillez localement, vous pouvez accéder à l'interface utilisateur à l'adresse suivante: https://gateway-host:8081/sfiler/

nom d'utilisateur : sfiler-master
mot de passe : sfiler

Gestionnaire de configuration

Ne nécessite pas de modification supplémentaire du système de fichiers pour fonctionner.

Interface Web de S-Filer Portal

Pour que l'interface web de S-Filer Portal fonctionne, il est obligatoire de préparer un emplacement pour son fichier de configuration et de définir une variable d'environnement configurée avec le chemin d'accès à ce fichier.

La variable d'environnement à définir s'appelle : SFILER_WEB_CONFIG_PATH

Son contenu doit être le chemin vers le fichier de configuration, ex : C:\MonPath\conf\gui.conf

Le fichier à utiliser sera créé et géré par le gestionnaire de configuration dans l'instance de l'interface web de S-Filer Portal. La création d'une instance de l'interface Web génère ce fichier. Si vous apportez des modifications à l'instance dans le gestionnaire de configuration, ce fichier peut être mis à jour en fonction de ce que vous avez modifié.

L'interface de ligne de commande (CLI)

L'interface de ligne de commande (CLI) est une composante de S-Filer Portal qui permet le transfert de fichiers en mode ligne de commande. L'interface de ligne de commande est habituellement utilisée par le biais de scripts pour automatiser les transferts récurrents.

Ce chapitre vous présente l'installation de l'interface de ligne de commande de S-Filer Portal.

Installation de l'interface de ligne de commande

Le client reçoit dans sa communauté de soutien S-Filer la trousse appropriée à son environnement.

Installation du CLI à l'aide du programme d'installation

Vous pouvez lancer le programme d'installation en cliquant directement sur l'exécutable sfiler-cli-installer.exe. Pour les versions Windows Core, vous pouvez utiliser le paramètre -i sur la ligne de commande : sfiler-cli-installer.exe -i console

Vous êtes alors invité à lire et à accepter la licence d'utilisation du produit S-Filer CLI. Pour accepter la licence, vous devez appuyer sur le bouton Suivant. Si vous désirez obtenir de plus amples renseignements sur la licence, veuillez communiquer avec votre service de soutien technique.

Une fois que vous avez accepté la licence, vous devez entrer le répertoire de destination. Vous pouvez parcourir votre système de fichiers à l'aide du bouton Choisir. Une fois le répertoire spécifié, cliquez sur le bouton Suivant pour passer à l'étape suivante. Si vous souhaitez revenir à l'emplacement par défaut, cliquez simplement sur le bouton Restore Default Folder.

L'étape suivante vous invite à confirmer votre sélection et à procéder à l'installation.

Vous pouvez suivre la progression de l'installation grâce à la barre de progression située au bas de la fenêtre. Pour éviter tout problème potentiel, le CLI installe son propre JRE (Java Runtime Environment).

À la fin de l'installation, si tout s'est bien déroulé, un message s'affiche indiquant que l'installation est terminée. Si une erreur se produit pendant l'installation, notez l'erreur et contactez l'assistance technique.

Installation du CLI à l'aide de la ligne de commande

Pour démarrer l'installation, exécutez le fichier sfiler-cli-installer.bin. Assurez-vous que que vous disposez des autorisations nécessaires sur le fichier exécutable. Si ce n'est pas le cas, exécutez la commande suivante :

shell

chmod 755 sfiler-cli-installer.bin

Une fois que les droits sur le fichier sont appropriés, lancez l'installation directement à partir de la ligne de commande :

shell

./sfiler-cli-installer.bin

La première étape du programme d'installation vous invite à choisir la langue.

shell

[root@localhost tmp]# ./sfiler-cli-installer.bin

Preparing to install

Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...
Launching installer...

===============================================================================
Choose Locale...
-------------

->1- English
  2- Español
  3- Français

CHOOSE LOCALE BY NUMBER:

L'installation vous invite ensuite à fermer toutes les applications en cours d'exécution afin d'éliminer tout conflit éventuel. Appuyez sur ENTRÉE pour passer à l'étape suivante.

shell

===============================================================================
SFiler-CLI (created with InstallAnywhere)
------------------------------------------------------------

Preparing CONSOLE Mode Installation...

===============================================================================
Introduction
----------

InstallAnywhere will guide you through the installation of SFiler-CLI.
Version : 4.19.0.0

It is strongly recommended that you quit all programs before continuing
with this installation.

Respond to each prompt to proceed to the next step in the installation.
If you want to change something on a previous step, type 'back'.

You may cancel this installation at any time by typing 'quit'.

PRESS <ENTER> TO CONTINUE:

Après avoir accepté la licence, vous êtes invité à indiquer le répertoire d'installation de l'interface de CLI. Pour accepter le répertoire par défaut, appuyez sur la touche ENTRÉE dans le répertoire cible si vous le souhaitez.

shell

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y

===============================================================================
Choose Install Folder
---------------------

Where would you like to install?
    Default Install Folder: /usr/local/SFiler-CLI

ENTER AN ABSOLUTE PATH, OR PRESS \<ENTER\> TO ACCEPT THE DEFAULT
    :

L'étape suivante consiste simplement à confirmer les paramètres sélectionnés.

shell

===============================================================================
Pre-Installation Summary
-------------------------

Please Review the Following Before Continuing:

Product Name:
    SFiler-CLI

Install Folder:
    /usr/local/SFiler-CLI

Java VM Installation Folder:
    /usr/local/SFiler-CLI/jre

Disk Space Information (for Installation Target):
    Required: 332,369,003 Bytes
    Available: 30,528,475,136 Bytes

PRESS <ENTER> TO CONTINUE:

Si les paramètres sont corrects, appuyez simplement sur ENTRÉE pour terminer l'installation du CLI.

shell

===============================================================================

Ready To Install

----------------

InstallAnywhere is now ready to install SFiler-CLI onto your system at
the following location:

    /usr/local/SFiler-CLI

PRESS <ENTER> TO INSTALL:

On peut alors suivre la progression de l'installation.

shell

Installing...
-------------

[==================|==================|==================|==============
[------------------|------------------|------------------|----------

La dernière étape confirme que l'installation a réussi. En cas de problèmes, veuillez contacter l'assistance.

shell

===============================================================================
Installation Complete
---------------------

Congratulations. SFiler-CLI has been successfully installed to:
    /usr/local/SFiler-CLI

PRESS <ENTER> TO EXIT THE INSTALLER:

Désinstallation du CLI

La désinstallation de l'ITC s'effectue en exécutant l'exécutable à partir de la console de ligne de commande ]ou du menu approprié dans les installations graphiques de Windows. Dans les deux cas, le programme de désinstallation supprime le composant CLI mais ne détruit pas nécessairement tous les fichiers (tels que les fichiers temporaires et les fichiers journaux). Il se peut que vous deviez supprimer ces fichiers manuellement.

Désinstallation du CLI sous Windows

Sous Windows, utilisez l'utilitaire pour ajouter ou supprimer des programmes. Cet utilitaire est accessible à partir du Panneau de configuration.

Sélectionnez SFiler-CLI et cliquez sur le bouton Uninstall/Change.

Vous serez alors invité à confirmer la désinstallation.

À la fin de la procédure de désinstallation de l'interface CLI, il est possible que certains fichiers n'aient pas été supprimés. Il sera nécessaire de supprimer manuellement ces fichiers.

Désinstallation du CLI à l'aide de la ligne de commande

La désinstallation du CLI sous UNIX nécessite le lancement de l'utilitaire de désinstallation en ligne de commande. Assurez-vous d'avoir les droits d'accès nécessaires sur :

shell

./Uninstall SFiler-CLI

Vous serez invité à confirmer la désinstallation. Appuyez sur ENTRÉE pour confirmer. Il se peut que vous obteniez un message d'erreur indiquant que tous les fichiers n'ont pas été supprimés ; il vous suffit d'utiliser la commande suivante pour les supprimer :

shell

rm --rf SFiler-CLI

Arguments de l'interface de ligne de commande

shell

Usage: sfiler [options] [command] [command options]
    Options:
        -h, --help
            Display this help screen
            Default: false
        -N
            No SSL Warning. Do not warn if the server address does not use SSL.
            Default: false
        -l
            The username to use to perform the action (ex: user@domain)
        -np
            Do not prompt. Never prompt for information.
            Default: false
        -op
            The obfuscated (hidden) password to authenticate
        -p
            The password to authenticate
        -q
            Be quiet (less output on screen)
            Default: false
        -s
            The URL of the server to use. (Ex: https://[PUBLIC ADDRESS]/sfiler/server/ 
            or https://[internal address]:8088/)
        -sso
            Authenticate using a Kerberos token. This is a transparent
            authentication.
            Default: false
        -ui
            User impersonation. When listing, erasing or downloading files, this
            options allows the path to resolve as if the impersonated user was
            logged in.
        -v
            Verbose (more output on screen)
            Default: false
    Commands:
        delete  Delete a file or folder
            Usage: delete [options] The path of the file or folder to delete. (ex:
            /Inbox/folder1/test.txt)
        download Download a file
            Usage: download \[options\] The path of the file to download. (ex:
            /Inbox/folder1/test.txt)
                Options:
                    -V
                        (Optional) The version number of the file to retrieve, if omitted,
                        retrieves the latest version.
                    -a
                        Save As. The name to use when saving the file on disk. Default:
                        Original filename from server.
                    -o
                        Overwrite the file on disk without asking.
                        Default: false
        hide-password Obfuscate (encode) a password so that it can be written in
        a file and not be easily recovered.
            Usage: hide-password [options]
        list List files and folders
            Usage: list [options] The path of the folder to list. (ex:
            /Inbox/folder1)
        list-versions List versions of a file
            Usage: list-versions [options] The path of the file to list. (ex:
            /Inbox/folder1/test.txt)
        mkdir Create folders
            Usage: mkdir [options] <folder_to_create>
        move Move/rename a remote file or folder
            Usage: move [options] <source_path> <destination_path>. If the
            destination path starts with a '/', it is absolute, otherwise it is
            considered relative to the source path.
        send-email Send a file securely to an email address
            Usage: send-email [options] Files to upload
                Options:
                    * -r
                        Comma separated list of email addresses to which the files will be
                        sent.
                    -t
                        Specify a theme to override the default notification theme.
                    -tc
                        Default: 0
                    -td
                        Set an absolute expiration date. After this date, the file cannot
                        be downloaded, it will be deleted. (ex: 2011-12-31)
                    -th
                        Set a relative expiration date. The file will expire in X hours
                        from now. (ex: 2)
                        Default: 0
                    -wp
                        Password to protect the files. You must communicate this password
                        to recipients so they can download the files.
                    -x
                        Message to send to recipients
        send-recipients Send a file only to some recipients of a community
            Usage: send-recipients [options] Files to upload
                Options:
                    * -c
                        The community from which the recipients are selected. You can get
                        the community names by listing the root.
                    -f
                        Wait for all post-processing tasks to be completed before the
                        command ends.
                        Default: false
                    -m
                        The default domain name for recipients. Recipients can use the
                        @domain notation to override this setting.
                    * -r
                        Comma separated list of usernames which will receive the file.
                        These users must be members of the community.
                    -t
                        Override the notification theme to use.
                    -tc
                        Default: 0
                    -td
                        Set an absolute expiration date. After this date, the file cannot
                        be downloaded, it will be deleted. (ex: 2011-12-31)
                    -th
                        Set a relative expiration date. The file will expire in X hours
                        from now. (ex: 2)
                        Default: 0
                    -x
                        Message to send to recipients
        upload Upload a file
            Usage: upload [options] Files to upload
                Options:
                    * -d
                        Upload destination. This is the path where we should upload the
                        file. (ex: /Inbox/folder1)
                    -f
                        Wait for all post-processing tasks to be completed before the
                        command ends.
                        Default: false
                    -t
                        Override the notification theme to use.
                    -tc
                        Default: 0
                    -td
                        Set an absolute expiration date. After this date, the file cannot
                        be downloaded, it will be deleted. (ex: 2011-12-31)
                    -th
                        Set a relative expiration date. The file will expire in X hours
                        from now. (ex: 2)
                        Default: 0
                    -x  
                        Message to send to recipients

Annexe 1 - Liste de contrôle pour l'installation et l'intégration

Carte de référence pour l'installation de S-Filer

Configuration	Valeur par défaut	Valeur actuelle (Instance 1)	Valeur actuelle (Instance 2)
SERVEUR
Adresse	localhost
Port du configurateur	8080
URL du configurateur	`http(s)://localhost:8090/`
Port des services Web	8088
URL des services Web	`http(s)://localhost:8088/`
Serveur de messagerie électronique	localhost
Port de messagerie électronique	25

GATEWAY
Adresse	localhost
Port du serveur Web	8081
Port FTP	21
Port FTPS (explicite)	990
Port de données FTP	60000-60020
Port SFTP	22

GUI
Adresse	localhost
Port	8081
Contexte	/sfiler
URL de l'interface utilisateur	`http(s)://localhost:8081/sfiler`
Proxy de serveur	`http(s)://localhost:8081/sfiler/server`	/server	/server

PROXY INVERSE APACHE
Adresse	localhost
Port	443

PROXY INVERSE DE IIS
Adresse	localhost
Port	443

Installation de S-Filer Portal ​

Configurations du système ​

Contenu du paquet ​

Le serveur ​

Installation du serveur ​

Installation à l'aide du programme d'installation ​

Installation à l'aide de la ligne de commande ​

Configuration de la base de données ​

Configuration pour MySQL ​

Configuration pour SQL Server ​

Serveur utilisant l'instance par défaut fonctionnant sur un port statique avec une authentification native SQL (pas un compte Windows) ​

Server utilisant une instance nommée avec l'authentification native SQL ​

Server utilisant l'instance par défaut fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé) ​

Serveur utilisant une instance spécifique fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé) ​

Serveur utilisant une instance nommée avec authentification Windows ​

Configuration pour Oracle ​

Initialisation de la base de données ​

Attribution d'un nom d'instance à votre serveur S-Filer ​

Création d'un fichier de service systemd ​

Configuration de la console d'administration ​

Importation d'une clé privée existante avant le démarrage du serveur ​

Générer une clé privée avant de démarrer le serveur ​

Configuration de la clé privée dans la console d'administration ​

Démarrez votre serveur S-Filer Portal ​

Windows ​

Linux ​

Configuration du serveur ​

Configuration initiale de S-Filer Portal ​

Définition des règles de proxy ​

Règles de proxy pour Apache ​

Proxy pour IIS ​

Pour installer Application Request Routing ​

IIS - Modification du paramètre MaxAllowedContentLength ​

Mise à jour du serveur ​

Mise à jour à l'aide du programme d'installation ​

Mise à jour à l'aide de la ligne de commande ​

Désinstallation du serveur ​

Désinstallation sous Windows ​

Désinstallation à l'aide de la ligne de commande ​

La passerelle ​

Configuration de la passerelle ​

Créer la passerelle ​

Activer le web gui ​

Autre configuration ​

Configuration de l'interface utilisateur Web ​

Ajouter une interface graphique Web ​

Configuration supplémentaire ​

Installation de la passerelle ​

Configurations de base ​

Installation de la Passerelle à l'aide du programme d'installation ​

Installation de la Passerelle à l'aide de la ligne de commande ​

Mise à jour de la passerelle ​

Mise à jour de la Passerelle à l'aide du programme d'installation ​

Mise à jour de la Passerelle à l'aide de la ligne de commande ​

Désinstallation de la passerelle ​

Désinstallation de la Passerelle sous Windows ​

Désinstallation de la Passerelle à l'aide de la ligne de commande ​

Configuration de l'optimisation des performances ​

Accès au portail S-Filer ​

Gestionnaire de configuration ​

Interface Web de S-Filer Portal ​

L'interface de ligne de commande (CLI) ​

Installation de l'interface de ligne de commande ​

Installation du CLI à l'aide du programme d'installation ​

Installation du CLI à l'aide de la ligne de commande ​

Désinstallation du CLI ​

Désinstallation du CLI sous Windows ​

Désinstallation du CLI à l'aide de la ligne de commande ​

Arguments de l'interface de ligne de commande ​

Annexe 1 - Liste de contrôle pour l'installation et l'intégration ​

Installation de S-Filer Portal

Configurations du système

Contenu du paquet

Le serveur

Installation du serveur

Installation à l'aide du programme d'installation

Installation à l'aide de la ligne de commande

Configuration de la base de données

Configuration pour MySQL

Configuration pour SQL Server

Serveur utilisant l'instance par défaut fonctionnant sur un port statique avec une authentification native SQL (pas un compte Windows)

Server utilisant une instance nommée avec l'authentification native SQL

Server utilisant l'instance par défaut fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé)

Serveur utilisant une instance spécifique fonctionnant sur un port statique avec authentification Windows (un compte de domaine est utilisé)

Serveur utilisant une instance nommée avec authentification Windows

Configuration pour Oracle

Initialisation de la base de données

Attribution d'un nom d'instance à votre serveur S-Filer

Création d'un fichier de service systemd

Configuration de la console d'administration

Importation d'une clé privée existante avant le démarrage du serveur

Générer une clé privée avant de démarrer le serveur

Configuration de la clé privée dans la console d'administration

Démarrez votre serveur S-Filer Portal

Windows

Linux

Configuration du serveur

Configuration initiale de S-Filer Portal

Définition des règles de proxy

Règles de proxy pour Apache

Proxy pour IIS

Pour installer Application Request Routing

IIS - Modification du paramètre MaxAllowedContentLength

Mise à jour du serveur

Mise à jour à l'aide du programme d'installation

Mise à jour à l'aide de la ligne de commande

Désinstallation du serveur

Désinstallation sous Windows

Désinstallation à l'aide de la ligne de commande

La passerelle

Configuration de la passerelle

Créer la passerelle

Activer le web gui

Autre configuration

Configuration de l'interface utilisateur Web

Ajouter une interface graphique Web

Configuration supplémentaire

Installation de la passerelle

Configurations de base

Installation de la Passerelle à l'aide du programme d'installation

Installation de la Passerelle à l'aide de la ligne de commande

Mise à jour de la passerelle

Mise à jour de la Passerelle à l'aide du programme d'installation

Mise à jour de la Passerelle à l'aide de la ligne de commande

Désinstallation de la passerelle

Désinstallation de la Passerelle sous Windows

Désinstallation de la Passerelle à l'aide de la ligne de commande

Configuration de l'optimisation des performances

Accès au portail S-Filer

Gestionnaire de configuration

Interface Web de S-Filer Portal

L'interface de ligne de commande (CLI)

Installation de l'interface de ligne de commande

Installation du CLI à l'aide du programme d'installation

Installation du CLI à l'aide de la ligne de commande

Désinstallation du CLI

Désinstallation du CLI sous Windows

Désinstallation du CLI à l'aide de la ligne de commande

Arguments de l'interface de ligne de commande

Annexe 1 - Liste de contrôle pour l'installation et l'intégration