EnglishFrançais
Imprimer
Date de sortie : 11 mai 2011
Configuration minimum
Téléchargement

Veuillez consulter la dernière version de l’Aide d’EMu pour la version la plus à jour de cette documentation.

Nouvelles caractéristiques
  • IMuFramework IMu Web : Le framework IMu web offre une série d'outils pour la diffusion de données détenues au sein d’EMu via l’Intranet/Internet. IMu comprend :

    • Une structure pour développer des pages web pour accéder à votre collection. La structure comprend :
      • Pages personnalisables avec des thèmes.
      • Configuration MVC (Model-View-Controller)(XML > XSLT > HTML).
      • Gestion de liste Collection.
      • Recherche et affichage des résultats de plusieurs modules.
      • Interface personnalisable via XSLT.
    • Application server extensible permettant à de nouvelles fonctionnalités d’être "plugged in" via des gestionnaire (handlers).
    • Bibliothèques pour développer des applications web pour les langages suivants :
      • Java
      • .Net
      • PHP
      • Perl

    Une description complète du framework IMu web se trouve dans la documentation Framework IMu Web.

  • Support multi-groupes : Le Support multi-groupes permet à un utilisateur d’être membre de plus d’un groupe. L'entrée de Registre EMu qui définit à quel groupe appartient l’utilisateur a été développée pour permettre d’avoir une liste séparée par un point-virgule des groupes à spécifier. Par exemple :

    User|badenov|Group|Responsable des prêts;Conservateur

    L’entrée ci-dessus indique que l’utilisateur badenov appartient à deux groupes, Responsable des prêts et Conservateur. Si un utilisateur est membre de plusieurs groupes, l'écran de connexion à EMu fournit une liste déroulante avec les groupes auxquels l'utilisateur appartient :
    login

    Le groupe sélectionné devient le groupe actif et est utilisé pour déterminer les autorisations jusqu’à ce qu’un nouveau groupe soit sélectionné. L’onglet Sécurité dans la boîte de dialogue Options permet de choisir un nouveau groupe :

    options

    Lorsque le groupe actif est changé, une boîte de dialogue s’affiche permettant à l’utilisateur d’indiquer comment les modules ouverts doivent se comporter :

    change

    Tout module laissé ouvert restera dans son groupe existant. Par conséquent, il est possible d'avoir deux modules (ou plus) ouverts, chacun dans un groupe différent. Les autorisations utilisées pour un module donné sont dictées par le groupe dans lequel le module existe. Le groupe du module est affiché dans la barre d'état au bas de la fenêtre du module.

    Une description complète du support multi-groupes se trouve dans la documentation Support multi-groupes.

  • Connexions cryptées : Le support connexions cryptées permet de crypter toutes les données transférées entre le client EMu et le serveur. Dans le cadre du processus de connexion, les certificats basés sur X509 sont échangés permettant aux clients EMu de s’assurer qu’ils se connectent au correct serveur EMu. TLS v1.0 (Transport Layer Security) est utilisé pour fournir le cryptage. Les administrateurs système peuvent choisir le chiffrement de cryptage utilisé, ce qui permet de configurer différents niveaux de compression et de sécurité. Le serveur EMu peut être configuré pour n’accepter que les connexions cryptées, sinon le cryptage est facultatif.

    Les connexions cryptées sont aussi supportées pour :

    • Java connections (TexJDBC)
    • C/C++ connections (TexAPI)
    • perl connections (texapi.pm)

    Une description complète du support pour les connexions cryptées se trouve dans la documentation Connexions cryptées.

  • Modes EMu en lecture seule : Une nouvelle entrée de Registre permet aux Administrateurs Système de rendre tout ou une partie d’EMu en lecture seule. Le format de la nouvelle entrée pour le système entier est :

    System|Setting|ReadOnly|value
    Group|Default|Setting|ReadOnly|value
    Group|group|Setting|ReadOnly|value
    User|user|Setting|ReadOnly|value

    Au niveau d’une table le format est :

    Group|Default|Table|Default|ReadOnly|value
    Group|Default|Table|table|ReadOnly|value
    Group|group|Table|Default|ReadOnly|value
    Group|group|Table|table|ReadOnly|value
    User|user|Table|Default|ReadOnly|value
    User|user|Table|table|ReadOnly|value

    value est soit :

    • true - fonction lecture-seule activée.
    • false - fonction lecture-seule désactivée.

    Une description complète du support pour les modes en lecture seule se trouve dans la documentation Modes en lecture seule.

  • Module Objets de l’exposition : Le client EMu Art a eu un nouveau module d’ajouté. Le module Objets de l’exposition se trouve entre les modules Événements et Catalogue et contient les informations sur un objet associé à une exposition particulière. Quand un objet est ajouté à un événement, un enregistrement Objets de l’exposition est automatiquement créé. L’enregistrement Objets de l’exposition peut ensuite être utilisé pour enregistrer l'utilisation de l'objet tout au long de l'exposition :

    exhibitobjects

    Une description complète du Module Objets de l’exposition se trouve dans la documentation Module Objets de l’exposition.

  • Affichage de l’aide du champ : Une nouvelle option permet d’afficher l’aide au niveau du champ d’un champ donné sous la barre d'état d'un module. La zone d'affichage de l'aide peut être redimensionnée au besoin :

    fieldhelp

    L’option Afficher l’aide du champ dans la fenêtre du module se trouve sur l’onglet Général de la boîte de dialogue Options :

    options2
  • Programmer des déplacements internes : Le module Déplacements a été développé pour permettre de programmer des déplacements internes comme s'il s’agissait de déplacements externes. C'est souvent le cas quand un déplacement interne nécessite que les objets soient déplacés entre des réserves hors site :

    movements

    Quand la Date du déplacement est complétée le système vous demandera si les objets attachés doivent être relocalisés :

    relocate

    Une réponse affirmative déplacera tous les objets vers le nouvel emplacement.

  • Modules de gestion d’organismes nuisibles : Deux nouveaux modules ont été ajouté au client EMu Art. Ces modules fournissent un support pour la gestion d’organismes nuisibles :

    • Pièges - enregistre les informations sur les types et les emplacements des pièges utilisés par une institution pour la capture des organismes nuisibles :

      traps
    • Événements du piège - enregistre les informations sur ce qui a été trouvé dans un piège à une date et heure donnée :

      trapevent

    Un ensemble complet de rapports fournit des données graphiques sur la prévalence des organismes nuisibles au sein de votre institution.

  • Service Web Multimédia : Le Service Web Multimédia est un service IMu fournissant un accès basé HTTP au dépôt Multimédia d’EMu. Les fonctions suivantes sont fournies :

    • Resource Request - demande une ressource multimédia (image, vidéo, document, etc.). Pour les ressources image une hauteur, largeur et / ou format peut être spécifié, ce qui permet de générer des images au coup par coup.
    • Metadata Request - donne toutes les métadonnées associées à la ressource. Les métadonnées sont une version XML marked-up des données dans l’enregistrement Multimédia. Pour les ressources image les formats supplémentaires de métadonnées suivants sont disponibles :
      • EXIF
      • IPTC
      • Dublin Core
    • Resource Discovery - cherche le dépôt Multimédia pour les ressources avec un nom de fichier donné.
    • Resource Listing - liste de toutes les ressources stockées dans le dépôt Multimédia.
    • Resource Insertion - ajoute une nouvelle ressource au dépôt Multimédia.
    • Metadata Update - met à jour les métadonnées (champs dans l’enregistrement Multimédia) pour une ressource donnée.
    • Resource Replacement - remplace le fichier ressource (image, document, etc.) associée avec un enregistrement Ressource Multimédia.
    • Resource Deletion - supprime une ressource du dépôt Multimédia de façon permanente.

    Une description complète du Service Web Multimédia se trouve dans la documentation Service Web Multimédia.

  • Service Web OAI : Le Service Web OAI (Open Archives Initiative) est un service IMu HTTP implémentant le protocole OAI 2.0. Le service met en œuvre les six verbes nécessaires de tous les référentiels OAI, à savoir :

    • Identify - demande un résumé du service.
    • ListMetadataFormats - fournit une liste des formats de métadonnées que le référentiel supporte (par exemple Dublin Core, etc.).
    • ListSets - fournit une liste des ensembles de données disponibles pour la récolte.
    • ListIdentifiers - fournit une liste d'identificateurs d'enregistrement uniques (pour EMu il s'agit de l'acronyme de l’institution combiné avec le nom du module et le NEI de l’enregistrement).
    • ListRecords - récupère une liste d'enregistrements dans un ensemble de données donné.
    • GetRecord - récupère un enregistrement individuel.

    Une description complète du Service Web OAI se trouve dans la documentation Service Web OAI.

Améliorations
  • Commande Modifier la ressource : Une nouvelle commande a été ajoutée au dépôt Multimédia permettant à l’utilisateur d’invoquer un éditeur externe pour modifier la ressource multimédia (image, document, etc.). La Commande Modifier la ressource télécharge la ressource à partir du serveur EMu, invoque un éditeur et vérifie le fichier pour tout changement. Elle cherche aussi tous autres fichiers créés avec le même nom que le fichier de la ressource, mais avec une extension différente (type de fichier). Quand EMu devient la zone active, l’utilisateur décide si le fichier modifié doit être réimporté dans le dépôt Multimédia. Une réponse affirmative sauvegarde la ressource sur le serveur EMu et génère toutes les résolutions, etc. La nouvelle commande simplifie le processus de modification des ressources multimédia :

    editresource
  • XMP et IPTC mis à jour : Le dépôt Multimédia été mis à jour pour supporter les dernières versions des normes de métadonnées IPTC et XMP. Les normes implémentées sont :

    • IPTC Core Version 1.1
    • IPTC Extension Version 1.1
    • XMP July, 2010
  • Détails de connexion par client : Les valeurs de connexion Hôte/Utilisateur/Arme/Groupe sont mémorisées par client. Si une institution gère plusieurs clients, les détails affichés dans le dialogue de connexion sont les valeurs de la dernière fois que ce client particulier a été exécuté, plutôt que les valeurs pour la dernière fois qu'un client a été invoqué.

  • Fonctionnalité Changer le mot de passe utilise SSH : La tâche d'administration permettant à un utilisateur de changer son mot de passe utilise désormais SSH (Secure Shell) pour effectuer le changement. Auparavant TELNET était utilisé, ce qui nécessitait que le service Telnet soit activé sur le serveur pour que la fonctionnalité marche. En utilisant SSH, le service Telnet n'a plus besoin d'être activé, à la place le service SSH est nécessaire. La plupart des sites active SSH pour permettre un accès sécurisé au serveur EMu.

  • Support pour notifications ICS : Le système de notification EMu, utilisé pour générer des notifications par email et des pages HTML pour les activités à venir (prêts, événements, tâches, etc), construit désormais un fichier iCalendar (. ics) contenant les dates à venir. Le fichier iCalendar peut être importé dans un grand nombre de produits, y compris :

    • Google Calendar
    • Apple iCal
    • IBM Lotus Notes
    • Microsoft Outlook

    Une fois importées, les dates à venir, avec une description détaillée, sont incorporées dans l'agenda de l'utilisateur.

  • Recalculer à l’envers les tâches : La fonctionnalité de l’onglet Tâches a été développée pour permettre aux dates de début et de fin d’être calculées en spécifiant la date de fin globale. La nouvelle fonctionnalité permet à un utilisateur de fixer la date à laquelle toutes les tâches doivent être achevées et de laisser EMu calculer les dates de début et de fin pour chaque tâche.

  • Création d’enregistrements joints : Pour faciliter la création d’enregistrements joints, un ensemble de commandes de création a été ajouté au menu Outils>Insérer :

    newattached

    La sélection d'une commande de création d'enregistrement démarrera une nouvelle instance du module sélectionné en mode Insérer avec un lien vers l’enregistrement original en place. Tous les objets joints à l'enregistrement original qui sont sélectionnés sont ajoutés à l’enregistrement créé. Si des objets ne sont pas sélectionnés, tous les objets sont ajoutés à ce nouvel enregistrement.

    Par exemple, dans le module Événements l’utilisateur peut faire une sélection dans la liste d’objets de l’événement et sélectionner Outils>Insérer>Enregistrements Prêt pour cet Événement. La commande démarrera une nouvelle instance du module Prêts/Emprunts en mode Insérer. Le champ Événement associé sera lié à l’enregistrement Événements et le champ Objets contiendra les objets sélectionnés dans l’enregistrement Événements. Si aucun objet n’est sélectionné, tous les objets seront joints.

    La commande existe pour les modules suivants :

    • Événements -> Prêts/Emprunts
    • Événements -> Restauration
    • Prêts/Emprunts -> Déplacements
    • Prêts/Emprunts -> Restauration
    • Déplacements -> Restauration
    • Pièges -> Événements du piège
  • Lien de Restauration à Déplacements : Un lien a été ajouté du module Restauration au module Déplacements pour permettre d’enregistrer les déplacements associés. Si la raison du déplacement est le transport de l'objet à un autre emplacement pour des travaux de restauration, le déplacement associé permet aux détails du déplacement d’être enregistrés contre l’enregistrement Restauration :

    conservation
  • Modifications de emuperiodic: La commande côté-serveur emuperiodic est utilisée pour exécuter des tâches de façon régulière. En particulier, elle est utilisée pour générer les données brutes pour le module Statistiques. La commande a été développée pour permettre :

    • de spécifier les scripts individuels, en limitant les scripts exécutés.
    • L'exécution de scripts locaux seulement, via l’option -l.
  • Glisser-déposer sur l’onglet Archives : L'onglet Archives dans le module Catalogue affiche la relation entre l'enregistrement en cours et tous les autres enregistrements dans la même archive. Il est désormais possible de déplacer l'enregistrement en cours en le faisant glisser-déposer dans une autre position de l'arborescence des archives. Lorsque l’enregistrement est déposé, l'utilisateur peut choisir comment l'enregistrement en cours doit être positionné par rapport à l'enregistrement sur lequel il a été déposé :

    selectnodeposition
  • Enregistrements en lecture seule en Vue de Liste : L’affichage des enregistrements en lecture seule en Vue de Liste a été changé. Les enregistrements en lecture seule s’affichent désormais avec un fond gris et le texte en noir, plutôt que le plus difficile à lire, texte gris sur fond blanc :

    readonly
  • emusecurity exécuté automatiquement quand requis : Un nouveau gestionnaire de Trace d’audit a été ajouté qui surveille le Registre EMu pour tous changements où les paramètres d'un utilisateur ont été modifiés. Lorsque les paramètres ont été modifiés, emusecurity est exécuté pour mettre à jour les paramètres de sécurité pour toutes les bases de données EMu. Les événements suivants sont traités :

    • Ajout d'un nouvel utilisateur.
    • Suppression d'un utilisateur existant.
    • Changer le(s) groupe(s) d'un utilisateur existant.
    • Changer la sécurité de la base de données via l'entrée de Registre Security.
    Il ne devrait y avoir aucun besoin d’exécuter emusecurity manuellement.
  • Qualité de l’image disponible pour JPEG 2000 : Lors de la génération d’images basées sur JPEG 2000, la qualité de l’image peut désormais être définie. La qualité de l'image détermine le niveau d’échantillonnage utilisé pour créer l'image. La valeur est comprise entre 1 et 100, où 100 implique un échantillonnage complet, c’est à dire aucune perte de qualité de l'image, et 1 représente le minimum de l'échantillonnage, résultant en une taille de fichier beaucoup plus petit, mais avec dégradation de l'image.

Problèmes résolus
ProblèmeSolution

The functions used to convert between imperial and metric units are, in many cases, built into specific clients. Each function is essentially the same with minor differences. The minor differences cause some conversions to compute an incorrect precision for the calculated value.

All conversion functions have been merged and checked to ensure the correct precision is implied for the calculated value.

When a conversion is applied between different units (e.g. feet to metres), the value entered by the user is flagged as the "Original" value. The flagging of the original value requires a number being placed in an Orig column indicating which field had the data entered. In some instances the Orig column may be shown as a text field when used in reports, rather than as an integer field.

All Orig fields have been updated to be integer based.

The Narrower Terms and Used For fields in the Thesaurus module do not have attachment buttons displayed, even though they are attachment fields. The buttons are missing from Query and Detail modes.

The attachment buttons have been enabled for Narrower Terms and Used For, in both Detail and Query modes.

If you enter a term into a Thesaurus controlled field that has the Thesaurus Validation Registry entry set to none, and the term entered appears in the Thesaurus, but not by itself (e.g. the term sports was entered, but only Sports Car exists in the Thesaurus), the term entered is cleared if you do not select a term. The current functionality makes it impossible to save a record with the original term as it is always cleared.

The term entered is no longer cleared if a term is not selected from the Thesaurus where the Validation Registry entry is set to none.

If a multi-term query is performed on an attachment field, where the field searched in the attached module has Also Search Registry entries associated with it, the query generated may not be the most efficient one possible.

The query generated for multi-term attachment queries where the attached column has Also Search Registry entries is now efficient.

For systems running in UTF-8 mode, the Audit Trail mechanism will drop audit records containing invalid UTF-8 characters. As the audit records are not posted to the Audit Trail table a "gap" may appear in the audit trail. The issue only occurs where invalid data is stored in a record (normally as a result of bad data when importing into EMu).

The Audit Trail mechanism now replaces invalid UTF-8 characters with the invalid UTF-8 character (0xFFFD). The substitution allows the audit record to be processed without error.

The View>Attachments command, used to show all records attached to the current record, displays modules the user does not have permission to use. While it is useful to see whether any records in the module attach to the current record, the module cannot be invoked without displaying a permission denied error.

The View>Attachments command has been modified to show only those modules the user has permission to access. A check box has been added to Show all modules, allowing the old behaviour to be selected.

If a Taxonomy record is re-parented to a name with a higher rank, the intervening ranks are not discarded from the Hierarchy tab.

Re-parenting now causes the intervening ranks to be removed from the Hierarchy tab.

An Access Violation message may be displayed when visiting the Hierarchy tab in the Narratives module. The message is displayed only if a hierarchy of narratives exists.

The message no longer appears when displaying the Hierarchy tab where a hierarchy of narratives exists.

When importing records into a Catalogue that uses the location SPLIT facility (used in parent records to indicate the child records are not all at the same location), spurious Internal Movements records may be created, even though none of the child records has been relocated. The spurious Internal Movements records note the location as unchanged.

Spurious Internal Movements records are no longer created when importing records into a Catalogue that uses the SPLIT location facility.

A Data validation failed on LatCentroidLongitude0 message may be displayed when calculating centroid values from decimal numbers. If converting the decimal value to degrees/minutes/seconds causes the seconds value to be close to 60, a rounding error may cause a value of 60 to be used. As this is not a legal value the error message is displayed.

When converting decimal values to degrees/minutes/seconds where the second value may result in 60, the minute value is incremented and the seconds reset to zero.

The mode displayed in the Module Title bar may be repeated when switching between display languages (e.g. English to Arabic).

The mode is no longer repeated when the display language is switched.

The emulutsupdate server-side script does not update Lookup List files in local/luts/default if it exists. Files in the luts/default directory are always updated. The issue means that localised versions of Lookup Lists may not be updated correctly by EMu upgrade scripts.

Local versions of Lookup List file are now updated by the emulutsupdate server-side command.

A number of the background loads used to synchronise data require the fifo load to be running when they are started. The emuload command does not check to ensure the fifo load is running before starting other background loads.

emuload checks the fifo load is running before starting any other background load. If the fifo load is not running, it is started, then any other loads listed are invoked.

If the Thesaurus module is opened in Browse mode, a term is selected in the tree, and then Details mode is chosen, the term record displayed may be read-only, even if the user has edit privileges.

The term record is now displayed with the correct permissions, rather than being read-only.

If the Thesaurus module is maximised or enlarged in Browse mode and the window splitter is moved to the right to increase the size of the terms tree, after which the module is returned to normal size, the fields on the Browse tab may disappear off the right hand edge of the page.

The fields on the Browse tab are displayed in the correct position when the Thesaurus module is re-sized.

If a second alternate term is added to a Thesaurus record, where the record was saved after the first alternate term was entered, an error message may display indicating non unique terms are present.

The Thesaurus record now saves without error when a second alternate term is entered.

If the Refresh tree option is selected in the Thesaurus module and the current record has Use and Use For terms, then the Use and Use For terms are repeated at the top of the Browse tree. The terms are repeated each time the Refresh option is invoked.

The Use and Use For terms are no longer repeated when the Refresh option is invoked.

An Access Violation message may be displayed when switching the display language in the Thesaurus module where the Browse tree is empty.

The message no longer appears when switching languages in the Thesaurus module with an empty Browse tree.

If a Narratives record may appear in two branches of a narratives hierarchy, the child narratives may not be shown for both branches of the hierarchy.

The child Narratives records are now displayed regardless of how may branches the parent narrative appears in.

The field prompts on the Permits query tab in the Rights module may not display correctly. The prompts are set to display using a right-to-left orientation, rather than the standard left-to-right setting.

The prompts have been changed to use a left-to-right orientation by default.

Data in reference fields, that is fields displaying data from another module, may not contain the correct values after certain operations are performed. The affected operations are:

  • Discard Record
  • Replace (Global Edit)
  • Export Records
  • Merge Record
  • Sort
  • Delete Record

Data in reference fields now displays the correct values after the listed operations are performed.

The value in a read-only combo-box may be cleared using the backspace key the first time data is viewed. The backspace key will not clear the value when viewing subsequent records.

The backspace key is disabled when a combo-box is read-only, regardless of when the data is viewed.

Duplicate attached records may be created when using the Import facility to create attached Collection Events or Sites records where the data contains lat/long values. The issue is caused by the failure of the lat/long conversion code when importing records.

The correct lat/long conversion now occurs, removing the creation of duplicate Collection Events or Sites records with the same data.

Random Access Violation messages may display indicating an error has occurred in mshtml.dll. The error message may even appear when a user is not at their machine.

The random error message is no longer displayed.

When performing a spell check on a RichEdit control that has multiple lines of text, the highlighting of the words spelt incorrectly may be out by a few characters.

Words spelt incorrectly are now highlighted correctly.

The View Attachments button next to a read-only grid may not be enabled when a single row is displayed in the gird. The button is only disabled for grids displaying data from another module (a reverse reference column).

The View Attachment button is now enabled when a single value is in a read-only grid.

The default value for the Gender field in the Parties module is set to Female. Ideally the default values should be Unknown.

The default value for the Gender field is now Unknown.

When changing the colours for various attributes (e.g. mandatory fields, etc.) via the Options dialogue box, the new colours selected will not take effect in modules already open. New instances will display the correct colours.

Existing modules now update their colours correctly when the Options dialogue box is closed.

When switching to the Details view of a record on a tab that contains an HTML control, the input focus is set to the HTML control, rather than the first control on tab.

The input focus is set to the first control on a tab when switching from Details view, even if the tab contains an HTML control.

A List of Values failure: fail to get values message may be displayed when generating a Crystal Report that contains dynamic parameters.

The error message is no longer displayed for Crystal Reports containing dynamic parameters.

The Audit Trail facility does not flush logging information when the processing of a record has been completed. The lack of flushing means the log file contents may lag behind the processing of records.

The Audit Trail facility now flushes logging information after each records processed.

If a taxonomic name appears in the Names History tab of other records it is difficult, if not impossible, to delete the name. Since the original name points to the preferred name, and the preferred name contains a history of previous names, a loop is formed. When a record is deleted it is not allowed to be referenced by any other record. A loop makes it impossible to delete either record, as it is referenced by the other record.

When deleting a taxonomic name, the Names History tab is now checked to ensure the original record is not referenced. This allows the record to be deleted.

The Taxonomy module has NULL indexing enabled on many of its fields. Unfortunately, this imposes a very large indexing overhead and as the indexing is enabled in the base module it cannot be disabled via the Registry.

All NULL indexing has been disabled in the Taxonomy module. System Administrators may enable it on selected fields via the EMu Registry. The indexing overhead for the Taxonomy module has been reduced dramatically.

The Taxonomy module does not generate the correct scientific name for autonyms.

The author is now inserted at the appropriate place in the sequence in the scientific name for autonyms.

The auto filling of values for the upper levels of hierarchies may be slow where the controls that form the hierarchy appear on a number of tabs.

The speed of auto filling of values in hierarchies has been improved dramatically.

Upgrade Notes

The upgrade from EMu Version 4.0.02 to EMu 4.0.03 involves a number of steps. Please follow the instructions below carefully.
Do not skip any steps under any circumstances.
Before proceeding with the update please ensure that a complete backup of the EMu server exists and is restorable.

There are four components that require upgrading:

  • Texpress (the database engine)
  • TexAPI (web services)
  • EMu Server (the application)
  • EMu Client (the client)

The notes below detail how to upgrade all systems. Check the Releases table for Client specific notes. Upgrading comprises the following steps:

In the notes below clientname refers to the name of the client directory for the current installation. The term ~emu is used to refer to user emu's home directory. This is normally /home/emu.

Stopping EMu services
  1. Log in as emu.
  2. Enter client clientname
  3. Enter ls -l loads/*/data* local/loads/*/data*
  4. Check each data file is empty and no data.t files exist.
    If this is not the case, please wait for the loads to drain before proceeding.
  5. Enter emuload stop
  6. Enter emuweb stop
  7. Enter texlicstatus
    Make sure no one is using the system.
    The upgrade will not complete successfully if users are accessing data.
Record Session

Each step in the upgrade process produces detailed output. In most cases this output will exceed the size of the screen. It is strongly recommended that the output of the upgrade session is recorded, so if errors occur, the output can be examined.

  1. Enter script /tmp/output-4-0-03

A new shell will start and all output recorded until the shell is terminated.

Installing Texpress

Installing Texpress 8.3 is only required for the first client upgraded to EMu 4.0.03. Once Texpress 8.3 has been installed, this section may be skipped for subsequent upgrades.

  1. Enter cd ~emu
  2. Enter mkdir -p texpress/8.3.001/install
  3. Enter cd texpress/8.3.001/install
  4. Obtain the appropriate Texpress version for your Unix machine via the Texpress hyperlink at the top of the page.
    Save the release in ~emu/texpress/8.3.001/install, calling it texpress.sh.
  5. Enter sh texpress.sh
    The Texpress release will be extracted.
  6. Enter . ./.profile
  7. Enter bin/texinstall ~emu/texpress/8.3.001
    The Texpress installation script will commence.
  8. Enter cd ~emu/texpress/8.3.001
  9. Enter . ./.profile
  10. Enter bin/texlicinfo
    Obtain your Texpress licence code and place it in a file called .licence.
  11. Enter bin/texlicset < .licence to install the licence.
  12. Enter \rm -fr install
  13. Enter cd ~emu/texpress
  14. Enter ln -s 8.3.001 8.3
Upgrading KE TexAPI

Installing TexAPI is only required for the first client upgraded to EMu 4.0.03. Once TexAPI has been installed, this section may be skipped for subsequent upgrades.

  1. Enter cd ~emu/texpress
  2. Enter mkdir 6.0.003
  3. Obtain the appropriate TexAPI version for your Unix machine via the TexAPI hyperlink at the top of the page.
    Save the release in ~emu/texpress, calling it texapi.sh.
  4. Enter sh texapi.sh -i ~emu/texpress/6.0.003 (expand the ~emu).
  5. Enter \rm -f texapi
  6. Enter ln -s 6.0.003 texapi
  7. Enter \rm -f texapi.sh
Upgrading EMu Server
  1. Enter cd ~emu/clientname
  2. For Unicode based clients only.
    Enter vi .profile-local
    Change langcode=utf8 to langcode=utf-8 and save the change.
  3. Enter mkdir install
  4. Enter cd install
  5. Obtain the appropriate EMu server version bundle via the EMu Server hyperlink at the top of the page.
    Save the release bundle file in ~emu/clientname/install calling it emu.sh.
  6. Enter sh emu.sh
    The EMu release will be extracted.
  7. Enter . ./.profile
  8. Enter bin/emuinstall -u clientname
    The EMu installation script will commence.
  9. Enter cd ~emu/clientname
  10. Enter cp .profile.parent ../.profile
  11. Enter . ../.profile
  12. Enter client clientname
  13. Enter emureindex
  14. Enter emubldinstall
  15. Enter emubldlinks
  16. Removal of the temporary directory (and its contents) is recommended:
    Enter \rm -fr install
  17. Enter upgrade-4-0-03
    The client will now be upgraded to EMu 4.0.03. If you are upgrading from a version prior to EMu 4.0.02, you must run the upgrade scripts for all versions after the old version before running the EMu 4.0.03 upgrade.
Starting EMu services
  1. Enter emuload start
  2. Enter emuweb start
Record Session

The recording of the upgrade session may now be terminated.

  1. Enter exit

The session output is available in /tmp/output-4-0-03.

Upgrading EMu Client

When upgrading to EMu 4.0.03 the Windows client should be upgraded on each individual machine. The client upgrade installs new DLLs on each individual machine in order for all reports with dynamic parameters to function correctly. To upgrade the EMu Client follow the Installing EMu Client notes.

Perl Packages

If the administration utility to change a user's password is used, the perl Net::SSH::Expect package must be installed. If the password utility is not used, this step may be skipped. To install the package:

  1. Log in as root
  2. Enter perl -MCPAN -e shell
  3. Enter install Net::SSH::Expect
  4. Enter quit
 
Spectrum Compliant

Raccourcis




Calendrier EMu 2011