logo

Mise à jour indirecte via cDistroBuilder

Sommaire

  1. Terminologie
  2. cDistroBuilder
  3. Préparation d'une distribution Cubus
  4. Installation d'une distribution Cubus
  5. Création d'un cédérom Cubus depuis une distribution Cubus
  6. Mise à jour d'une distribution Cubus
  7. Gestion des erreurs
  8. Exemples de mise en œuvre

A. Terminologie

Numéro Bn : identificateur attribué par Cubus S.A. à un bureau d'ingénieurs ayant acquis des licences Cubus.

Distribution Cubus : un paquet de logiciels Cubus prêt à être installé pour un client Cubus donné, identifié par son numéro Bn, avec toutes les licences qui s'y rattachent ; le cédérom Cubus livré lors de l'achat de nouvelles licences est typiquement une distribution Cubus.

Fichier de licence Cubus : un fichier contenant une ou plusieurs licences pour les applications Cubus ; les fichiers de licence Cubus avec une extension «.liz» se trouvent sur votre cédérom Cubus dans .\Licenses\, partant du répertoire principal du cédérom ; après installation, ces mêmes fichiers de licence Cubus se trouvent dans …\Cubus\CubusShared\Licenses\ ; les fichiers de licence Cubus adressés par courriel portent une extension «.syl» et ils peuvent regrouper plusieurs licences.

Station (de travail) : un ordinateur sur lequel l'on travaille avec un logiciel (sans que celui-ci ne soit nécessairement installé sur cette station-là).

Mise à jour directe : le téléchargement de la version la plus récente du paquet de logiciels Cubus et son installation se font sur la même station de travail ; cette station doit disposer d'une connexion à internet (protocoles HTTP et FTP) et l'opérateur doit avoir les droits d'écriture sur le dossier d'installation.

Mise à jour indirecte : le téléchargement de la version la plus récente du paquet de logiciels Cubus se fait depuis une station de travail disposant d'une connexion à internet (protocoles HTTP et FTP) ; l'installation peut ensuite être faite depuis une autre station de travail, non connectée à internet ; l'opérateur doit avoir les droits de lecture sur les fichiers téléchargés et les droits d'écriture sur le dossier d'installation.


B. cDistroBuilder

L'utilitaire «cDistroBuilder.exe» permet de préparer une distribution Cubus sur n'importe quelle station de travail disposant d'une connexion à internet pour les protocoles HTTP et FTP.

Les applications Cubus ne doivent pas nécessairement être installées sur cette station (ni en local, ni comme serveur, ni comme client), mais les fichiers de licence Cubus doivent être accessibles depuis cette station. Une clé électronique Cubus n'est requise ni pour la préparation ni pour l'installation d'une distribution Cubus. Les privilèges d'administrateur ne sont requis ni pour la préparation ni pour l'installation d'une distribution Cubus.

L'utilitaire «cDistroBuilder.exe» ne dispose pas d'une interface graphique. Il est avant tout destiné à l'administrateur du système et il s'utilise depuis un interpréteur de commandes DOS.


C. Préparation d'une distribution Cubus

  1. Si les fichiers de licence Cubus ne sont pas directement accessibles depuis la station sur laquelle la distribution Cubus est préparée, copier ces fichiers dans un répertoire local, par exemple sous C:\Temp\Cubus\Licenses\.
  2. Télécharger l'utilitaire «cDistroBuilder.exe» dans un répertoire local si possible simple d'accès, par exemple sous C:\Temp\
  3. Ouvrir un interpréteur de commandes DOS dans le répertoire où se trouve l'utilitaire «cDistroBuilder.exe»
  4. Vérifier la syntaxe en exécutant la commande :
    [C:\Temp]> cDistroBuilder /?
  5. Générer la distribution Cubus exécutant par exemple la commande :
    [C:\Temp]> cDistroBuilder C:\Temp\Cubus\Distro -LIZ=C:\Temp\Cubus\Licenses -L -D

    La procédure de génération est subdivisée en 11 étapes :

    1. Build temporary directory
    2. Server information
    3. Read content of directory
    4. Create directory C:\Temp\Cubus\Distro
    5. Update Licences
    6. Download Components
    7. Install Root Components
    8. Build readme
    9. Build CDversion.txt
    10. Build AUTORUN.INF
    11. Delete temporary directory

    Si la distribution Cubus a été générée sans faute, le message «Finished successfully» est affiché.

     

N.B. : il est possible d'initialiser une distribution Cubus en copiant dans un répertoire le contenu du cédérom Cubus original le plus récent en votre possession. Il suffit alors de faire une mise à jour de la distribution Cubus.


D. Installation d'une distribution Cubus

Une distribution Cubus est analogue à un cédérom Cubus original livré lors de l'achat de nouvelles licences.

Soit une distribution Cubus correctement préparée et accessible sous C:\Temp\Cubus\Distro\. Si la distribution Cubus a été préparée sur une autre station, nommée par exemple «Server», cette distribution Cubus est par exemple accessible, depuis la station où l'installation est effectuée, sous \\Server\Cubus\Distro\.

L'installation s'effectue par un simple double-clic sur l'utilitaire «Setup.exe» situé dans le répertoire principal de la distribution Cubus.

Si aucune licence n'a été modifiée ou ajoutée, alors il est possible d'automatiser la procédure d'installation depuis un interpréteur de commandes DOS en exécutant la commande :
[C:\Temp\Cubus\Distro]> Setup -AUTO


E. Création d'un cédérom Cubus depuis une distribution Cubus

Une distribution Cubus est analogue à un cédérom Cubus original livré lors de l'achat de nouvelles licences.

Pour créer un cédérom Cubus physique, il suffit de graver un cédérom vierge avec tout le contenu de la distribution Cubus préalablement préparée.

Le contenu du répertoire racine du nouveau cédérom doit donc correspondre au contenu du répertoire principal de la distribution Cubus, avec notamment l'utilitaire «Setup.exe» directement situé dans le répertoire racine du cédérom.


F. Mise à jour d'une distribution Cubus

Il est possible de mettre à jour une distribution Cubus préalablement préparée.

Il suffit pour cela de spécifier pour répertoire cible le répertoire principal de la distribution Cubus existante. Par exemple, pour mettre à jour la distribution Cubus générée sous C., il faut exécuter la commande :
[C:\Temp]> cDistroBuilder C:\Temp\Cubus\Distro -L -D

N.B. : si les licences Cubus n'ont pas été modifiées depuis la génération de la distribution Cubus, il n'est pas nécessaire de spécifier où se trouvent les fichiers de licences Cubus car ils se trouvent déjà dans la distribution Cubus.

En procédant de la sorte, seuls les fichiers modifiés depuis la distribution Cubus précédemment génénée sont téléchargés. Cette procédure est donc bien plus rapide.


G. Gestion des erreurs

Error: Error in update server info

Vous n'avez pas d'accès HTTP au serveur de mise à jour Cubus. Veuillez vérifier les paramètres de votre connexion internet, et plus particulièrement les paramètres du proxy.

Error: Cannot copy … to target directory…

Le répertoire cible, futur répertoire principal de la distribution Cubus, contient probablement un sous-répertoire protégé en écriture. Veuillez lever toutes les protections en écriture sur tous les fichiers et sous-répertoires du répertoire cible. Depuis un interpréteur de commandes DOS, la commande «attrib» permet de modifier ces attributs.

Error: Cannot download component…

Vous n'avez pas d'accès FTP au serveur de mise à jour Cubus. Veuillez vérifier les paramètres de votre connexion internet, et plus particulièrement les paramètres du proxy.


H. Exemples de mise en œuvre

Exemple 1 : station avec accès direct à internet et applications Cubus installées localement

Situation

  • Station avec accès direct à internet (protocoles HTTP et FTP), i.e. sans passer par un serveur proxy.
  • Les applications Cubus sont installées localement sous C:\Program Files\Cubus, et les fichiers de licence portant l'extension «.liz» sont donc directement accessibles en lecture
    sous C:\Program Files\Cubus\CubusShared\Licenses\.
  • Nous désirons créer la distribution Cubus dans le répertoire C:\My Cubus\CD\.

Procédure

  1. Créer le répertoire C:\My Cubus\CD\
  2. Télécharger l'utilitaire «cDistroBuilder.exe» dans le répertoire C:\
  3. Ouvrir un interpréteur de commandes DOS dans le répertoire où se trouve l'utilitaire «cDistroBuilder.exe»
  4. Générer la distribution Cubus en exécutant la commande :
    [C:\]> cDistroBuilder "C:\My Cubus\CD" "-LIZ=C:\Program Files\Cubus\CubusShared\Licenses" -L -D

    N.B. : si un chemin paramètre de la commande comporte des espaces, il faut impérativement utiliser des guillemets anglais pour enserrer ces paramètres.


Exemple 2 : station avec accès indirect à internet via un serveur proxy sans applications Cubus installées

Situation

  • Station avec uniquement un accès indirect à internet via un serveur proxy appelé «myproxy» qui n'autorise que des accès HTTP authentifiés (selon RFC-2617) via le port 8080 et des accès FTP via le port 8118.
  • De nouveaux fichiers de licence portant l'extension «.syl» ont été adressés par Cubus au client par courriel, et ils ont été sauvegardés sous C:\Licenses\.
  • Nous désirons créer la distribution Cubus dans le répertoire C:\My Cubus\CD\.

Procédure

  1. Créer le répertoire C:\My Cubus\CD\
  2. Télécharger l'utilitaire «cDistroBuilder.exe» dans le répertoire C:\
  3. Ouvrir un interpréteur de commandes DOS dans le répertoire où se trouve l'utilitaire «cDistroBuilder.exe»
  4. Créer le fichier de configuration «cDistroBuilder.ini» dans ce même répertoire avec le contenu suivant :

     

    Syntaxe du fichier «cDistroBuilder.ini» :


    http=HOST:PORT Nom du serveur proxy et numéro du port pour le protocole HTTP
    httpusr=USERNAME Nom d'utilisateur pour l'authentification (login) sur le serveur proxy HTTP
    httppwd=PASSWORD Mot de passe pour l'authentification (login) sur le serveur proxy HTTP
    httpauthent=T ou F T = accès HTTP uniquement avec authentification, selon RFC-2617 (p.ex. Microsoft-ISA-Server)
    F = accès HTTP sans authentification, selon RFC-2616
    ftp=HOST:PORT Nom du serveur proxy et numéro du port pour le protocole FTP
    ftpusr=USERNAME Nom d'utilisateur pour l'authentification (login) sur le serveur proxy FTP
    ftppwd=PASSWORD Mot de passe pour l'authentification (login) sur le serveur proxy FTP
    ftptype=0 à 5 0 = pas de proxy
    1 = USER user@hostname
    2 = SITE with logon
    3 = OPEN
    4 = USER user@ftpuser@host / PASS pass@ftppwd
    5 = transparent (USER + PASS)
     
  5. Générer la distribution Cubus en exécutant la commande :
    [C:\]> cDistroBuilder "C:\My Cubus\CD" -SYL=C:\Licenses\*.syl -PROXY=INI -L -D

    N.B. : si un chemin paramètre de la commande comporte des espaces, il faut impérativement utiliser des guillemets anglais pour enserrer ces paramètres.

  © 2026 Cubus AG, Zürich