Démarrage et arrêt de Caching Proxy

Caching Proxy est conçu pour s'exécuter en continu en tant que processeur d'arrière-plan nécessitant une intervention humaine minimale. Le serveur proxy démarre lors du cycle d'amorçage de l'ordinateur et ne s'arrête que lorsqu'une opération de maintenance est requise. Il peut être démarré manuellement lorsque cela est nécessaire. Le serveur proxy accepte également une instruction de démarrage, destinée à l'arrêter puis à la redémarrer sans interrompre les connexions client actives.

Démarrage et arrêt automatiques sur les systèmes Linux et UNIX

Sur les systèmes Linux et UNIX, un script d'initialisation ibmproxy et les liens symboliques associés sont placés dans les répertoires /etc/ appropriés lors de l'installation de Caching Proxy. Ces scripts sont ensuite intégrés aux routines de démarrage et d'arrêt du système d'exploitation. Vous pouvez modifier les paramètres de configuration en vue d'un redémarrage automatique en modifiant le script ibmproxy et les options de commande ibmproxy.

Remarque :
Limite du descripteur de fichier sous Solaris

Il se peut que le script de démarrage du système du Caching Proxy ne puisse pas définir le nombre maximal de descripteurs de fichiers souhaité en raison de la limite de Solaris à l'échelon du système en matière de descripteurs de fichiers. Si le nombre maximal de descripteurs à l'échelon du système est inférieur à celui défini dans le script de démarrage du système du Caching Proxy, c'est le nombre limite défini à l'échelon du système qui est utilisé. Vous pouvez modifier le nombre limite de descripteurs de fichiers afin d'éviter d'éventuels incidents de performance du proxy qui pourraient résulter d'une valeur limite trop petite (inférieure à 1024). Utilisez la commande ulimit pour afficher le nombre de descripteurs actuellement disponibles. Si cette valeur est inférieure à 1024, augmentez la valeur limite du descripteur de fichier. Pour augmenter cette dernière à 1024, ajoutez la ligne suivante dans le fichier /etc/system :

set rlim_fd_cur=0x400

Désactivation du démarrage et de l'arrêt automatiques

Pour désactiver le démarrage et l'arrêt automatiques :

Démarrage manuel sur les systèmes Linux et UNIX

Quelle que soit la méthode de démarrage, la commande ibmproxy est appelée, soit directement à partir de la ligne de commande, soit à partir d'un script. Pour une description détaillée de la commande ibmproxy, voir ibmproxy, commande. Voici les arguments les plus couramment utilisés.

Sur AIX :

Sous HP-UX :

Sous Linux :

Remarque :
Voir le site du support IBM WebSphere Application Server pour plus d'informations sur l'exécution d'ibmproxy dans un environnement de sécurité étendue Linux sur les systèmes RHEL : http://www-01.ibm.com/support/docview.wss?uid=swg21369929.

Sous Solaris :

Démarrage en tant que service Windows

Si Caching Proxy est installé en tant que service Windows, le démarrage s'effectue de la même façon que pour les autres services Windows :

  1. Cliquez sur Démarrer –> Panneau de configuration.
  2. Dans la fenêtre Panneau de configuration, cliquez deux fois sur Outils d'administration –> Services.
  3. Dans la fenêtre Services, mettez en évidence Caching Proxy.
  4. Cliquez sur Démarrer pour lancer le service Caching Proxy.

Si Caching Proxy est installé en tant que service, il peut être configuré pour démarrer automatiquement lors du lancement de Windows. Dans ce cas, il n'est pas nécessaire de se connecter pour que le proxy traite les demandes. Pour que le serveur démarre automatiquement :

  1. Cliquez sur Démarrer –> Panneau de configuration.
  2. Dans la fenêtre Panneau de configuration, cliquez deux fois sur Outils d'administration –> Services.
  3. Dans la fenêtre Services, mettez en évidence Caching Proxy.
  4. Cliquez sur le bouton d'option Automatique, puis sur Démarrer pour lancer le service Caching Proxy automatiquement au démarrage de Windows.

Régénération de la variable d'environnement PATH

Si Caching Proxy est défini comme Démarré dans la fenêtre Services mais que le proxy ne fonctionne pas, il se peut que la machine n'ait pas été redémarrée après l'installation du proxy. Si le service Caching Proxy est paramétré de manière à interagir avec le bureau et que vous ne redémarrez pas la machine, le message d'erreur ci-après peut apparaître dans une boîte de dialogue en incrustation : Message catalog error: the message catalog could not be loaded or is invalid

Vous devez alors redémarrer la machine de manière à ce que la valeur de la variable d'environnement PATH soit régénérée dans la base de registres Windows. Si cette valeur n'est pas régénérée, il est possible que la variable PATH affiche Caching Proxy et les chemins GSK7 corrects mais que le fonctionnement du serveur présente des anomalies.

Remarque :
Une incompatibilité risque de se produire sur les systèmes Windows quand Caching Proxy et une application, telle qu'un système de fichiers en réseau, s'exécutent en tant que services. Il arrive que Caching Proxy n'interprète pas correctement un chemin contenant un pilote éloigné appartenant à une application de type système de fichiers, elle-même exécutée en tant que service.

Cet incident se produit si le chemin d'accès au service du système de fichiers apparaît avant celui du service Caching Proxy dans la variable d'environnement PATH de Windows. Vous pouvez remédier à cela en modifiant la variable PATH et en plaçant les services de systèmes de fichiers à la fin de la définition.

Cet incident n'a aucun effet sur les unités éloignées contrôlées par les applications qui ne sont pas exécutées en tant que services Windows. Par exemple, Caching Proxy peut accéder aux unités partagées sur d'autres machines Windows visibles via un réseau local (LAN).

Démarrage en tant qu'application Windows

Utilisation du menu Démarrer

Si Caching Proxy est installé en tant qu'application Windows, la procédure d'installation crée une entrée Caching Proxy comme sous-menu du menu Démarrer. Pour lancer Caching Proxy en tant qu'application, sélectionnez Démarrer –> Programmes –> IBM WebSphere –> Edge Components –> Caching Proxy.

Cette procédure de démarrage lance le serveur proxy à l'aide des paramètres de configuration en cours. Pour définir d'autres valeurs de paramètres lors du démarrage, utilisez la procédure de démarrage à partir de la commande (voir la section suivante).

Utilisation de l'invite de commande

Pour démarrer le serveur à partir de n'importe quelle invite de commande Windows ou DOS, utilisez la commande ibmproxy. Si vous n'avez pas arrêté et redémarré Windows depuis l'installation du serveur, vous devez entrer le nom du chemin complet de la commande, comme suit (par défaut) :

C:\Program Files\IBM\edge\cachingproxy\cp\bin\ibmproxy.exe

La commande ibmproxy démarre le serveur à l'aide des paramètres de configuration en cours. Si vous n'avez pas modifié la configuration du serveur depuis l'installation, la configuration en cours est basée sur les informations entrées au cours de de ce processus et sur les options par défaut.

La commande ibmproxy démarre le serveur en tant qu'application, même si vous avez installé Caching Proxy pour qu'il fonctionne en tant que service. Pour forcer l'exécution du serveur en tant qu'application, vous pouvez également indiquer l'option de commande -noservice. Toute autre option de commande modifie les paramètres de configuration au moment de l'exécution.

Lancement de plusieurs serveurs proxy

Plusieurs instances du serveur proxy peuvent s'exécuter simultanément ; toutefois, chaque paire adresse IP de liaison et port d'écoute (HostName/IP, PORT) doit être unique. Vous devez également activer la directive BindSpecific dans les fichiers de configuration. En outre, si plusieurs instances du serveur proxy s'exécutent sur un même système, vous devez définir les directives suivantes pour chaque instance du serveur proxy :

Sur les systèmes AIX, une seule instance peut être lancée avec la fonction SRC. Des fichiers de configuration uniques doivent être indiqués pour toutes les instances du serveur, étant donné que le fichier de configuration identifie un numéro de port qui doit être différent pour chaque serveur sur une machine donnée. Pour démarrer une autre instance du serveur (une instance au moins étant en cours), tapez la commande suivante à l'invite :

autre_fichier_config est un fichier de configuration unique.

Lorsque vous démarrez plusieurs instances du serveur, enregistrez l'ID du processus affiché pour chacune d'elles. Ces ID sont requis pour arrêter des instances spécifiques du serveur.

Remarque :
Sur les systèmes Linux exécutant plusieurs instances du serveur, la commande /etc/rc.d/init.d/ibmproxy stop permet d'arrêter le dernier serveur qui a été démarré. Les autres instances doivent être arrêtées séparément. Pour plus d'informations, voir Arrêt manuel sur les systèmes Linux et UNIX.

Démarrage d'ibmproxy comme utilisateur non-superutilisateur sur les systèmes UNIX

Vous pouvez exécuter IBM Caching Proxy comme processus non-root sur un système UNIX, mais vous devez modifier la configuration pour que Caching Proxy fonctionne correctement. Pour configurer Caching Proxy pour fonctionner comme utilisateur non-superutilisateur :

  1. Configurez Caching Proxy pour utiliser uniquement les ports supérieurs à 1024. Par exemple, vous pouvez utiliser les ports suivants avec Caching Proxy comme processus non-root :
    Port 8080
    SSLPort 1443
    Remarque :
    Cette étape est nécessaire pour chaque directive dans le fichier de configuration, qui utilise des numéros de port. Si vous tentez d'exécuter le processus comme utilisateur non-superutilisateur sur les ports inférieurs à 1024, vous générez des erreurs de liaison de port ou de refus d'autorisation.
  2. Vérifiez les paramètres des directives USERID et GROUPID. Si vous modifiez les paramètres par défaut du serveur pour l'ID utilisateur, l'ID groupe ou les chemins d'accès au répertoire journal, créez des répertoires et mettez à jour leurs droits d'accès et leurs propriétés.

Arrêt manuel sur les systèmes Linux et UNIX

Pour arrêter le serveur :

Tableau 2. Méthode de démarrage et méthodes d'arrêt pour systèmes Linux et UNIX
Méthode de démarrage Méthode d'arrêt
A partir de /etc/inittab (sous AIX) Entrez stopsrc -s ibmproxy
A partir de /sbin/init.d (sous HP-UX) Entrez /sbin/init.d/ibmproxy stop
A partir de /etc/rc.d/init.d (sous Linux) Entrez /etc/rc.d/init.d/ibmproxy stop
ibmproxy
  1. Pour rechercher l'ID processus ibmproxy  : sous AIX, tapez ps -aef | grep "ibmproxy". Sous Linux, tapez ps -aux | grep ibmproxy | grep ID_serveur. Sous Solaris et HP-UX, entrez ps -ef | grep "ibmproxy"
  2. Pour arrêter le processus ibmproxy : tapez kill id_processus

Pour arrêter tous les serveurs sur cette machine : tapez killall ibmproxy

ibmproxy -nobg Tapez ctrl-c
ibmproxy -r -autre_fichier_config(sous AIX) Tapez stopsrc -s ibmproxy -p id_processus
ibmproxy -r -autre_fichier_config(sous Linux)
  1. Pour rechercher l'ID processus ibmproxy : tapez ps aux | grep ibmproxy | grep id_processus
  2. Pour arrêter le processus ibmproxy : tapez kill id_processus
Remarque :
Si vous avez démarré le proxy transparent, vous devez décharger l'extension du noyau du proxy transparent et les règles du pare-feu qui lui sont associées, après avoir arrêté le serveur Caching Proxy. En tant qu'utilisateur root, entrez la commande suivante :
ibmproxy -unload 

Pour arrêter le serveur à l'invite root, tapez :

Limites des commandes d'arrêt

Les limitations suivantes s'appliquent lors de l'utilisation des commandes d'arrêt :

Arrêt manuel sur un système Windows

Vous pouvez arrêter le serveur Caching Proxy de la même manière que vous arrêtez les programmes Windows.

Si le serveur est installé en tant que service :

  1. Cliquez sur Démarrer –> Panneau de configuration.
  2. Dans la fenêtre Panneau de configuration, cliquez deux fois sur Outils d'administration –> Services.
  3. Dans la fenêtre Services, mettez en évidence Caching Proxy.
  4. Cliquez sur Arrêter pour arrêter le service Caching Proxy.

Si le serveur proxy n'est pas installé en tant que service, effectuez l'une des opérations suivantes pour arrêter Caching Proxy :

Redémarrage après modifications de la configuration

Après avoir modifié la configuration du serveur (à l'aide des formulaires de configuration et d'administration ou en modifiant le fichier ibmproxy.conf), vous devez le redémarrer pour que les modifications soient effectives. Dans la plupart des cas, vous pouvez redémarrer le serveur sans l'arrêter. Toutefois, cette procédure ne régénère pas certains paramètres. Pour plus d'informations, voir tableau 6.

Pour redémarrer le serveur sans l'arrêter au préalable, cliquez sur le bouton Redémarrer situé dans le formulaire de configuration et d'administration ou entrez la commande suivante : ibmproxy -restart