COMMUNICATION TECHNIQUE N TC0534 Ed. 01 Nb de pages : 9 Date : 12-03-2004 URGENTE NON URGENTE TEMPORAIRE DEFINITIVE OBJET : NOUVELLE GESTION DES LICENCES SUR Le but de cette communication technique est d'apporter quelques informations sur le processus d'installation des licences et de répondre aux questions que se pose le technicien face à des problèmes qu'il rencontre lors d'opérations d'installation ou d'adjonction. 1
NOUVELLE GESTION DES LICENCES SUR SOMMAIRE 1. PRÉAMBULE...3 2. DOCUMENT À CONSULTER...3 3. FICHIER DE LICENCES "SOFTWARE.MAO"...3 4. SYSTÈME NEUF...3 5. ADJONCTION SUR UNE INSTALLATION EN SERVICE...4 5.1. Adjonction traitée par Actis... 4 5.2. Adjonction traitée directement par "elp"... 5 6. MIGRATION D'UN OMNI-PCX 4400 VERS OMNIPCX ENTERPRISE 5 7. REMPLACEMENT D'UNE CPU LORS D'UNE OPÉRATION DE MAINTENANCE...6 8. RESTRICTIONS SUR LA VERSION ACTIS 6.1.2...6 9. CONTRÔLES...7 9.1. Contrôle de la cohérence entre un fichier <offre>.swk et l'identifiant matériel des Call Server... 7 9.2. Contrôle de l'édition de la clé hard dans le cas d'une migration... 8 10. INFORMATIONS À FOURNIR AU SUPPORT LORS DE LA RENCONTRE DE PROBLÈMES...8 Ed. 01 / 12-03-2004 1 TC0534
NOUVELLE GESTION DES LICENCES SUR TC0534 2 Ed. 01 / 12-03-2004
NOUVELLE GESTION DES LICENCES SUR 1. PRÉAMBULE A partir de la Release 5.0 Lx, le processus de gestion des licences de l'omnipcx Entreprise a changé. En même temps, est apparu un nouveau circuit de commercialisation. Ces nouveautés peuvent perturber les techniciens intervenant sur le système. Le but de cette communication technique est d'apporter quelques informations sur le processus d'installation des licences et de répondre aux questions que se pose le technicien face à des problèmes qu'il rencontre lors d'opérations d'installation ou d'adjonction. 2. DOCUMENT À CONSULTER Documentation Système: Services système/gestion des licences. 3. FICHIER DE LICENCES "SOFTWARE.MAO" Les fichiers de licences software.mao et <offre>.sw ne sont plus livrés par Actis. Ils sont remplacés par un seul fichier <offre>.swk. Ce fichier contient les licences achetées et une clé soft appelée "soft-key" ou "signature", calculée à partir des licences et des identifiants hardware des CPU. Ces identifiants sont soit le CPU-Id inscrit dans le hardware des CPU (CPU-Alizé, CPU-4400 ou Appliance Server), soit une "clé hard" connectée sur les CPU-4400. Le fichier <offre>.swk est fourni par le service "elp" du serveur de commandes "ebuy", accessible sur BPWS. Lors de l'installation des fichiers OPS sur le système à partir de l'outil swinst, le fichier <offre>.swk est renommé en software.mao dans la base de données. 4. SYSTÈME NEUF Etapes suivies depuis la construction de l'offre jusqu'à l'installation du système sur le site client. Le Business Partner construit son offre avec Actis. Actis exporte l'offre vers le service "elp" du serveur de commandes "ebuy" via le fichier <offre>.sap qui contient l'ensemble des fichiers décrivant l'offre. "elp" contrôle l'offre transmise par le Business Partner et passe commande à l'industriel par l'intermédiaire du fichier <offre>.sap. L'industriel construit le système et transmet à "elp", les identifiants hardware des CPU qu'il affecte à la commande (CPU-4400, CPU-Alizé, ou Appliance Server) afin que ce dernier puisse calculer la "signature" contenue dans le fichier <offre>.swk. L'industriel peut alors récupérer dans "elp" le fichier <offre>.swk contenant la "signature" et le fichier <offre>.sw4760 (si l'application OmniVista A4760 fait partie de la commande). Ed. 01 / 12-03-2004 3 TC0534
NOUVELLE GESTION DES LICENCES SUR Note Si les Appliance Server sont commandés directement chez un revendeur IBM, le Business Partner doit saisir les CPU-Id dans "elp". L'industriel génère alors les fichiers <offre>.zip, <offre>.hw et hardware.mao à partir du fichier <offre>.sap et récupère les fichiers <offre>.swk et <offre>.sw4760 dans "elp". Il peut alors tester le système avec l'ensemble des fichiers OPS qu'il transfère dans le répertoire /DHS3dyn/BACKUP/OPS. Le Business Partner peut, à tout moment, récupérer les fichiers <offre>.swk et <offre>.sw4760 sur "elp". Lorsque le technicien reçoit le système, les 4 ou 5 fichiers OPS sont dans le répertoire /DHS3dyn/BACKUP/OPS, et optionnellement sur une disquette si la demande a été faite lors de la commande. Note Il est aussi possible de construire directement une offre avec l'outil "ExpressQuote". 5. ADJONCTION SUR UNE INSTALLATION EN SERVICE Une adjonction peut être traitée par Actis, ou directement par "elp". Lorsque cette adjonction concerne exclusivement des licences, elle peut être traitée directement sur "elp". Lorsqu'une adjonction génère du matériel, elle doit être traitée par Actis, puis être transmise à "elp" si des licences sont impliquées. 5.1. Adjonction traitée par Actis Actis a besoin de connaître la configuration du client pour effectuer une adjonction de matériel. Le technicien fait une sauvegarde des fichiers OPS avec l'outil swinst, ou bien l'opérateur Actis fait une "photoconfig" à distance. Les fichiers OPS sont chargés sur Actis avant de faire l'adjonction. Actis vérifie que l'édition de l'offre à charger est supérieure ou égale à celle qu'il connaît déjà. Si elle est inférieure, il refuse le chargement. Lorsque l'adjonction est réalisée, l'opérateur Actis exporte la commande vers "elp" via le fichier <offre>.sap. Si l'adjonction nécessite des licences complémentaires, "elp" fournit un nouveau fichier <offre>.swk et/ou <offre>.sw4760, car les licences doivent être affectées à la commande et les "signatures" recalculées. L'opérateur Actis dispose des fichiers <offre>.swk et/ou <offre>.sw4760 livrés par "elp" et des fichiers hardware.mao, <offre>.hw, <offre>.zip, résidant dans Actis. Il fournit les 4 ou 5 fichiers OPS au technicien sur disquette. TC0534 4 Ed. 01 / 12-03-2004
NOUVELLE GESTION DES LICENCES SUR Le technicien installe les fichiers OPS avec l'outil swinst. Après les contrôles de cohérence, le fichier <offre>.swk est renommé software.mao dans la base de données, comme dans les versions antérieures. Seule cette procédure est autorisée. La copie manuelle du fichier <offre>.swk dans le répertoire /DHS3data/mao est INTERDITE, car elle passe outre les contrôles et génère un "panic flag". 5.2. Adjonction traitée directement par "elp" Il est possible de traiter une adjonction directement par "elp" si celle-ci implique uniquement des licences. L'opérateur Actis se connecte via BPWS sur "elp" et saisit le numéro d'identification du client. Le numéro d'identification du client est le "CPU-Id" ou le "CPU_Id for elp" si les CPU sont équipées de clés hard (hard key). Lorsque l'adjonction est faite, "elp" génère un nouveau fichier <offre>.swk contenant une nouvelle "signature". Le fichier <offre>.swk peut être installé seul sur le système avec l'outil swinst. Dans le cas d'adjonction de licences uniquement, il n'est pas nécessaire d'installer les 4 ou 5 fichiers OPS. 6. MIGRATION D'UN Omni-PCX 4400 VERS Lorsqu'un Omni-PCX 4400 migre en R5.1, le Business Partner a le choix de conserver la ou les clé(s) hard comme identifiant de CPU, même si celles-ci sont équipées de "CPU-Id". Dans ce cas, l'opérateur Actis aura renseigné ces clés dans "elp". Cependant, si lors de la migration en R5.1, le Business Partner fait l'adjonction de la duplication, la deuxième CPU ne sera pas équipée de clé hard. Il sera alors possible de fonctionner avec une clé hard sur l'une et avec le "CPU_ID" sur l'autre. Lorsque le technicien installe les fichiers OPS sur le système après migration, il doit vérifier la cohérence entre le fichier <offre>.swk fourni par "elp" et les identifiants CPU-Id ou clé hard des CPU. En cas d'incohérence, le Business Partner dispose de 30 jours pour régulariser. Pendant ces 30 jours, il peut gérer la base de données sans restriction ; se reporter au paragraphe 9.1 pour contrôler la cohérence entre un fichier <offre>.swk et l'identifiant matériel des Call Server. De même, si le Business Partner choisit de préparer une migration sur maquette et qu'il ne dispose pas encore des CPU du client, le système sera dans la période des 30 jours, et la base de données pourra être gérée sans restriction. L' incident 5906 journalier est édité lorsque le système est dans la période des 30 jours. Ed. 01 / 12-03-2004 5 TC0534
NOUVELLE GESTION DES LICENCES SUR 7. REMPLACEMENT D'UNE CPU LORS D'UNE OPÉRATION DE MAINTENANCE Lors du remplacement d'une CPU ou d'un Appliance Server suite à une panne matérielle, le nouveau CPU-ID doit être renseigné dans "elp" (e-licensing-services/re-allocation) afin de recalculer la "signature" du fichier <offre>.swk. Ce fichier doit être installé sur le système dans un délai de 30 jours après le remplacement du matériel. Passé ce délai, le système passe en fraude. Le remplacement d'une CPU ne nécessite pas la génération d'un nouveau fichier <offre>sw4760. Notes 1 Dans la période des 30 jours, l'incident journalier 5906 est édité. Cette information est aussi disponible par le choix 2 de l'outil spadmin. 2 La procédure de remplacement se trouve sur BPWS dans e-licensing-services/re-allocation (Re- Hosting). 8. RESTRICTIONS SUR LA VERSION ACTIS 6.1.2 Dans cette version, les fichiers <offre>.swk et <offre>.sw4760 contiennent une "signature" vide quand ils sont générés par la procédure "export MAO". En attendant une correction dans Actis, ils doivent être impérativement récupérés sur "elp". Pour vérifier le fichier <offre>.swk, il faut l'éditer sur PC. La "signature" se trouve entre les octets 7 et 16 du fichier. Elle ne doit pas être nulle. Le contenu du fichier <offre>.sw4760 est en clair. L'obligation de charger les fichiers OPS du client dans Actis 6.1.2 avant de faire une adjonction est parfois pénalisante pour le Business Partner. Cette restriction est en cours de discussion. Même si une adjonction ne nécessite pas de licence, l'opérateur Actis est obligé de passer par "elp". Cette contrainte sera levée dans une version ultérieure d'actis. La procédure d'export MAO génère à tort le fichier software.mao. Il ne doit pas faire partie des fichiers OPS, sinon le système refuse l'installation. TC0534 6 Ed. 01 / 12-03-2004
NOUVELLE GESTION DES LICENCES SUR 9. CONTRÔLES 9.1. Contrôle de la cohérence entre un fichier <offre>.swk et l'identifiant matériel des Call Server Après avoir installé le fichier <offre>.swk à l'aide de l'outil swinst, taper la commande spadmin et choisir le menu 2 Display active file. Fichier <offre>.swk pour CPU-4400 utilisant une clé hard Fichier <offre>.swk pour CPU-Alizé utilisant un CPU-Id DLL version = 0110 DLL version = 0110 File version = 1 File version = 5 OXE version = 0110 OXE version = 0110 Soft Key = 73895c941efb8dac1128 Soft Key = 3fa57be27dd24b25b453 Note 1 Cpu Id for elp 0 = bf62-00010846091 Cpu Id 0 = 00020065 Note 2 Cpu Id for elp 1 = bf61-00010846092 Cpu Id 1 = 00020066 Note 2 Hard Key A = bf62 Note 3 Hard Key B = bf61 Note 3 Your Hard Key: bf62 System Hard Key found Your System CPU-Id: 00020065 System CPU-Id found Note 4 Handle 4760 = bf62-00010846091 Handle 4760 = 00020065 Note 5 Timestamp = Tue Nov 11 17:57:25 2003 Timestamp = Wed Oct 8 11:43:02 2003 OPS version = 00000 OPS version = 00000 Notes 1 La Soft Key appelée aussi "signature" est calculée et fournie par "elp" (uniquement par "elp"). Elle est le résultat du checksum sur les données du fichier <offre>swk. Ces données incluent les licences achetées et les clés hard ou "CPU-Id des Call Server. 2 Cpu Id for elp 0 et Cpu Id for elp 1. C'est le CPU-Id virtuel pour les CPU 4400 équipées de clés hard. Il est conçu à partir de la clé hard suivie du numéro d'un identifiant sur onze caractères. Les dix premiers caractères de l'identifiant contiennent le numéro de commande. Le onzième caractère prend la valeur "1" pour la CPU-a et "2" pour la CPU-b. Cet identifiant est exploité par "elp". Ed. 01 / 12-03-2004 7 TC0534
NOUVELLE GESTION DES LICENCES SUR Cpu Id 0 et Cpu Id 1. C'est le CPU-Id enregistré dans une mémoire flash des CPU ou Appliance Server. Il est inscrit sur une étiquette collée sur le circuit imprimé des CPU Alizé et CPU-4400, et en face arrière des Appliance Servers. 3 Hard-key A et Hard-key B. Ce sont les valeurs des clés hard lues dans le verrou 301 pour CPU-a et 302 pour CPU-b. Note Cette information apparaît dans le cas d'utilisation de clé hard mais n'apparaît pas dans le cas d'utilisation de CPU-Id. 4 Valeur réelle de la clé hard ou du "CPU-Id" lu sur le Call Server sur laquelle est exécutée la commande spadmin. Lorsque la clé hard ou le "CPU-Id" lu sur le Call Server est identique à "Hard-Key A" ou "Hard- Key B", ou bien "Cpu Id 0" ou "Cpu Id 1", le système répond System Hard-Key found ou Cpu-Id found. Dans la négative, il répond System Hard-Key not found ou System CPU-Id not found, suivi d'une information du nombre de jours restant pour régulariser. Exemple 26 remaining days(s) to fix issue 5 Handle 4760. C'est le "Cpu Id for elp 0" ou le "Cpu Id 0" à l'intention d'omnivista 4760 qui sera autorisée à se connecter sur le système. 9.2. Contrôle de l'édition de la clé hard dans le cas d'une migration Lors de la migration de OmniPCX 4400 vers, il est parfois nécessaire de remplacer la CPU par une CPU6 Step2 ou une CPU5 Step3. Il peut arriver que la clé hard provenant de l'omnipcx 4400 ne fonctionne plus sur les nouvelles cartes. Les clés hard 3BA 50051 AAAA dont l'ics est inférieur à 03 ne sont plus compatibles. La solution est de les remplacer par une 3BA 50051 AAAA ics 03, ou 3BA 50051 AAAB ics 01. Pour plus d'informations se reporter à la communication technique TC0420 Non fonctionnement des cartes CPU5 et CPU6 équipées de clés hardware 3BA 50051 AAAA inférieures à l'ics 03. 10. INFORMATIONS À FOURNIR AU SUPPORT LORS DE LA RENCONTRE DE PROBLÈMES Lors d'une demande de "Service Request" au Support, fournir les informations suivantes. Les fichiers <offre>.swk et <offre>.sw4760. La trace de l'installation des fichiers OPS par l'outil swinst. On y trouve les raisons du refus de l'installation des fichiers. Les éditions 1 Display current counters et 2 Display active file de l'outil spadmin. TC0534 8 Ed. 01 / 12-03-2004