PETRA (Installation-Protection) 1

PETRA
Version 3.0

Fvrierr 2016

Pices Ecrites Techniques

Rdiges avec Assistance

Installation Protection

C E R E M A - D T I T M
 PETRA (Installation-Protection) 2

TABLE DES MATIERES

TELECHARGEMENT LOGICIEL .................................................................................. 3

1.1 - TELECHARGEMENT ................................................................................................................ 3
1.2 MANIPULATION PREALABLE A LINSTALLATION ................................................................. 3

PROTECTION PAR DONGLE..................................................................................... 4

2.1 ACTIVATION DU DONGLE AVEC DINKEYCHANGE ............................................................... 4
2.2 MISE A JOUR DU DONGLE AVEC DINKEYCHANCE .............................................................. 5

CODES DERREURS DONGLE ................................................................................... 6

3.1 NUMERO DERREUR ............................................................................................................... 6
3.2 CODES DERREURS DINKEYCHANGE .................................................................................. 8

PROCEDURE D'INSTALLATION ............................................................................... 10

4.1 - INSTALLATION ....................................................................................................................... 10
 Chapitre PETRA (Installation-Protection) 3

1
Tlchargement logiciel
1.1 - TELECHARGEMENT
Le logiciel dmatrialis est accessible depuis la plateforme de vente des logiciels du CEREMA.
Avant tout tlchargement, vous deviez passer commande du logiciel dans tous les cas suivants :
- Acquisition dune licence de logiciel (achat du logiciel),
- Mise jour de la version PETRA (passer de la version v 2.0 la version v 3.0),
- Renouvellement de poste informatique (nouveau poste informatique ou changement de licence
vers un autre poste).
Quelle que soit la commande envisage et effectue, et sous rserve du rglement de celle-ci, un
dongle (cl USB) sera envoy au client. En effet, linstallation de la version PETRA v3.0
dmatrialis ncessite l'utilisation dun dongle (cl USB de protection) DinkeyPro de la socit
Aplika.

A noter : lutilisateur doit avoir les droits administrateurs de son poste, si ce nest pas le cas
veuillez-vous rapprocher de votre service informatique afin quil procde linstallation.

1.2 MANIPULATION PREALABLE A LINSTALLATION

A la rception du dongle, le client devra au pralable toute opration lie lactivation ou
linstallation du logiciel, effectuer les manipulations suivantes :
- Tlcharger le logiciel sur la plateforme de vente sous son format compress (.zip),
- Connecter le dongle sur son poste et attendre la dtection du matriel,
- Extraire les fichiers du logiciel tlchargs sur son poste. Puis ouvrir le dossier et double
cliquer sur DinkeyChange.exe .
Le principe dutilisation est simple : pour installer le logiciel PETRA, le dongle doit tre branch
lordinateur afin dtre activ distance par lEquipe PETRA.
 Chapitre PETRA (Installation-Protection) 4

2
Protection par Dongle

2.1 ACTIVATION DU DONGLE AVEC DINKEYCHANGE

Pour procder lactivation du dongle, lutilisateur doit double-cliquer sur DinkeyChange.exe . La
fentre DinkeyChange affichera les informations respectives sur le Code Produit, le Numro de dongle
et le Numro de mise jour.

Par suite, cliquer dans Outils , puis gnrer les diagnostics et cocher la case enregistrer les
diagnostics dans un fichier . Le fichier pourra tre enregistr sur votre bureau, de manire nous le
transfriez par mail la boite mail petra-dtecitm@cerema.fr. Lors de la rception du fichier, la mise
jour du dongle sera effectue par nos soins.
 PETRA (Installation-Protection) 5

2.2 MISE A JOUR DU DONGLE AVEC DINKEYCHANCE

Pour mettre jour votre dongle, connecter-le lordinateur et lancer lutilitaire DinkeyChange. Le
Code Produit ainsi que le numro de dongle et le numro de mise jour pour ce dongle safficheront
comme prcdemment la rubrique 2.1.
Rcuprer le fichier UpdateCode.ducf que nos services vous auront envoy pour la mise jour de
votre dongle. Ce fichier pourra tre enregistr sur votre bureau, puis devra tre ouvert avec la
commande fichier , ouvrir le fichier du code de mise jour . ou encore en le faisant glisser sur la
fentre DinkeyChange.

Fentre DinkeyChange :

Vous obtiendrez un message stipulant que la mise jour a t effectue avec succs.
Si toutefois, vous rencontrez des problmes lis au dongle ou DinkeyChange, veuillez nous
contacter. Afin didentifier lorigine du problme et de faciliter nos changes, une liste de code
derreur est fournie dans le chapitre suivant.
 Chapitre PETRA (Installation-Protection) 6

3
Codes derreurs dongle

3.1 NUMERO DERREUR

La liste de codes derreur fournie ci-aprs contient les principaux codes derreur pouvant tre affichs
par les programmes protgs, les API et Runtime DinkeyPRO. Vous trouverez galement un descriptif
associ expliquant lerreur, ce qui pourra vous permettre de rsoudre les cas les plus frquemment
rencontrs.
400 Impossible dallouer suffisamment de mmoire pour raliser cette opration. Si cette erreur
apparat, les ressources systmes seront trs faibles. Un redmarrage pourra probablement solutionner
le problme.
401 Votre logiciel ne dtecte aucune cl DinkeyPRO, FD ou NET.
402 Trop de cls Dinkey connectes. Par exemple, si vous utilisez DinkeyAdd pour programmer et
initialiser vos cls, vous obtiendrez ce message si vous connectez plus dune cl sur votre poste de
travail.
403 Le dongle dtect nest pas du type attendu. Veillez spcifier le bon type de cl utilis lors de la
pose de protection avec DinkeyAdd | Onglets gnrales.
404 Le dongle dtect nest pas du modle attendu. Veillez spcifier le bon type de cl utilis lors de
la pose de protection avec DinkeyAdd | Onglets gnrales.
405 Tentative dutilisation dun dongle de dmo avec une version commerciale du kit dveloppeur.
406 Tentative dutilisation dun dongle commercial avec un programme protg par une version de
dmonstration du kit du dveloppeur DinkeyPRO.
407 Le dongle dtect est dun numro SDSN diffrent de celui du programme DinkeyAdd ayant servi
poser la protection sur le programme protg.
408 Le numro de srie du dongle connect nest pas dans la plage autorise. Pour initialiser cette
plage, allez dans DinkeyAdd | Gnral | Options avances.
409 Le dongle dtect na pas t initialis par DinkeyAdd.
410 Le dongle dtect ne contient pas le code produit attendu. Veillez spcifier le bon code produit
lors de linitialisation de vos cls avec DinkeyAdd | Onglets gnrales.
411 Impossible de trouver le programme protg dans la liste des programmes protgs de la cl
connecte. Spcifiez la liste des noms des programmes protgs lors de linitialisation de vos cls avec
DinkeyAdd | Programmes | Ajouter la liste.
412 DRIS non correctement pass lors de lappel de DDProtCheck. Veuillez vrifier votre code
dintgration. Nhsitez pas consulter nos exemples dintgration pour une bonne utilisation.
 PETRA (Installation-Protection) 7

413 Le programme excut na pas t protg par DinkeyAdd. Si vous utilisez la mthode API, vous
devez protger dpwin32.dll et non votre application.
414 La structure DRIS passe DDProtCheck est trop petite. Vous n'avez probablement pas
correctement dclar la taille de la structure DRIS.
415 La structure DRIS passe DDProtCheck est trop grande. Vous utilisez probablement une version
de la structure DRIS plus rcente que celle du module de protection utilis pour protger votre
application. Vous n'avez peut-tre pas correctement dclar la taille de votre structure DRIS.
416 Le systme dexploitation dtect nest pas support. Dinkey Pro nest pas compatible avec
Windows 95, et Windows NT4.
417 Mauvais paramtre dans la structure DRIS. Cette erreur peut galement apparatre si vous utilisez
le cryptage du DRIS dans votre code et que vous navez pas indiqu ce mode de fonctionnement dans
DinkeyAdd (ou inversement).
418 Vous avez positionn deux valeurs Flag du DRIS de faons contradictoires.
419 Lhorloge du poste utilisateur a t modifie (soit avance, soit recule). Lhorloge du poste de
travail doit dabord tre remise la bonne heure. Si lerreur persiste, vous devez dbloquer le dongle
en le mettant jour avec DinkeyRemote / DinkeyChange. DinkeyRemote permet de calculer le code
de mise jour de la cl retournant cette erreur en indiquant la date de dernire utilisation, onglet
Autres | puis dernire date dutilisation.
420 Le compteur dexcutions restantes a atteint 0.
421 Il ny a plus suffisamment de droits dexcutions restants pour en dcompter le nombre
ncessaire. Laffichage de cette erreur ne dcompte aucune utilisation.
422 Date dexpiration atteinte.
423 Trop dutilisateurs rseaux simultans La limite du nombre maximum dutilisateurs rseaux
simultans est atteinte.
424 Tentative de lecture / criture en dehors de la zone de donnes. Remarque : la taille de la zone de
donnes utilisable est indique avec DinkeyAdd lors de la pose de la protection sur vos programmes et
lors de linitialisation des cls DinkeyPRO/ FD, modles Plus et NET. Pour augmenter la taille de la
zone de donnes vous pouvez utiliser DinkeyRemote.
425 Tentative de Lecture/criture ou Cryptage/Dcryptage dpassant la limite autorise. Pour des
raisons de performances nous limitons le volume dinformations changes 1Ko par appel. Si vous
dsirez utiliser une taille suprieure de donnes vous devez raliser plusieurs appels successifs.
426 Lalgorithme utilisateur que vous essayez dutiliser nexiste pas. C'est--dire que le champ
alg_numbers du DRIS ne correspond aucun algorithme contenu dans la cl Dinkey connecte.
427 Lalgorithme spcifi avec les valeurs indiques en entre donne un rsultat Division par zro.
Cela ne peut arriver que si vous utilisez une opration X Mod 0 dans lalgorithme.
428 Fonctionnalit non disponible pour cette version.
429 Le champ alt_prog_name indiqu ne se termine pas par un caractre Null.
430 Lappel de ce programme nest pas autoris pour cette DLL protge.
431 Une DLL dont dpend la mthode de protection SHELL du programme protg nest pas prsente
sur le poste de lutilisateur.
432 Le service des cls DinkeyFD (pour les dongles Dinkey FD de 1re gnration - avant janvier
2010) doit tre install pour les utilisateurs travaillant sous Windows 2000 et XP et disposant de droits
d'accs limits.
 PETRA (Installation-Protection) 8

433 Demande de cryptage partir de script php (ou asp.net etc...) non supporte par le RunTime du
module DinkeyWeb.
434 Vous devez mettre jour le module DinkeyWeb pour supporter le nouveau code exemple php (ou
asp.net etc...).
435 DinkeyServer n'est pas dtect sur le rseau. Soit DinkeyServer n'est pas lanc, soit il est bloqu
par un firewall.
436 La connexion avec DinkeyServer ne peut tre maintenue. Il est peut-tre ferm ou le rseau est
"tomb".
437 Votre programme protg utilise une version plus rcente de Dinkey que DinkeyServer. Vous
devez mettre jour DinkeyServer vers une version plus rcente.
438 Erreur lors de la fermeture d'un utilisateur rseau.
439 Aucun dongle comportant le bon Code Produit n'a t dtect par DinkeyServer. Si vous avez
rcemment connect un dongle au serveur de dongle, vous devez redmarrer DinkeyServer pour qu'il
soit reconnu.
440 Un dongle rseau contenant un Code Produit correct a t dtect mais le programme excut n'est
pas inclus dans la liste des programmes protgs du dongle.
441 DinkeyServer est surcharg. Si trop de requtes d'ouverture d'utilisateurs rseaux sont adresses
au mme moment, le serveur peut-tre trop charg pour rpondre. Si vous recevez cette erreur, il est
conseill d'afficher un message appropri demandant de patienter et de renouveler la demande
ultrieurement.
442 L'utilisateur a supprim le fichier cach .DO NOT DELETE.dat de la mmoire flash du dongle
Dinkey FD Lite. Le dongle continuera de fonctionner si l'utilisateur travaille en tant qu'administrateur.
Le dongle doit tre restaur en utilisant DinkeyChange, avec la fonction du menu Outils |
Rinitialisation Dinkey FD Lite, ou en appelant la fonction DCRestoreDinkeyFDLite de
DinkeyChange.dll.
443 L'entre du fichier <prodcode.ini> (ou <PRODCODE.conf> pour Linux/ Mac OS X n'est pas au
bon format, ou le nom de la machine ne correspond pas une adresse IP valide.
444 La partie Flash Disk de la cl DinkeyFD n'a pas t monte par Linux/Mac OS X. Modifiez vos
paramtres si cette erreur survient.
445 La fonction utilise faisant appel au DRIS nest pas supporte par le modle de dongle dtect.
Exemple : vous essayez dcrire dans la zone de donnes du DRIS avec une cl ne contenant pas de
zone de donnes (cl de modle Lite).
446 Vous avez protg votre programme en mthode API avec activation du cryptage des donnes
(algorithme R/W), cependant le dongle ne contient pas dalgorithme R/W.
447 Vous avez essay de dmarrer plus dun utilisateur rseau pour un mme programme dans le
mme processus. Ceci nest pas autoris.

3.2 CODES DERREURS DINKEYCHANGE

758 Impossible douvrir le fichier de mise jour (Fichier DUCF).

759 Il ne sagit pas dun fichier de mise jour valide.
762 Le code de mise jour est d'un format invalide.
 PETRA (Installation-Protection) 9

764 Code invalide. Si le code a t saisi manuellement, assurez-vous quil a t saisi correctement. Si
vous utilisez un fichier de mise jour, celui-ci doit tre corrompu.
765 Le code de mise jour est valide mais ne correspond pas au Dongle connect.
766 Le numro de mise jour de ce code est suprieur celui de la cl. Probablement parce qu'une
mise jour prcdente na pas t applique.
767 Le numro de mise jour de ce code est infrieur celui de la cl. Probablement parce que la
mise jour a dj t effectue.
768 Le code de mise jour a t calcul avec une version de DinkeyRemote plus rcente que celle de
DinkeyChange utilis par votre client. Utilisez un DinkeyRemote plus ancien ou actualisez le
programme DinkeyChange de votre client.
769 Le code de mise jour correspond un nombre de programmes suprieur au nombre de
programmes mmoris dans le dongle. Par consquent, aucune mise jour n'a t applique.
770 Impossible dajouter ce fichier la liste des programmes protgs du Dongle car il existe dj.
Aucune mise jour effectue.
771 Mmoire du dongle insuffisante pour appliquer cette mise jour. Aucune mise jour na t
effectue.
772 Impossible deffacer ce fichier de la liste des programmes protgs du Dongle car il ny figure
pas.
774 Dpassement de capacit dune cl rseau. Valeur du nombre dutilisateurs rseaux maximum de
la cl infrieure la valeur indique Par Produit.
775 Le code de mise jour tente de modifier le nombre dutilisateurs rseaux mais le Dongle nest pas
un modle NET.
778 Impossible dutiliser un code de mise jour court car ce dongle a t verrouill pour naccepter
que des codes de mise jour scuriss.
780 Impossible dajouter un nombre dutilisateurs rseaux Par Produit car le dongle est configur
pour le mode Par Programme.
781 Impossible dajouter un nombre dutilisateurs rseaux Par Programme car le dongle est
configur pour le mode Par Produit.
782 Dpassement de capacit dune cl rseau. Valeur du nombre dutilisateurs rseaux maximum de
la cl infrieure la valeur indique Par Programme.
813 Ajout dun trop grand nombre dexcutions, la valeur ne pourra pas tre stocke.
822 Appel de DinkeyChange.dll avec des paramtres invalides. Utilisez les constantes prdfinies.
823 Nom de fichier spcifi invalide pour la fonction DCGetDiagnosticInfo de DinkeyChange.dll.
824 Le code produit est trop long, pour tre valide il ne doit pas dpasser 8 caractres.
 Chapitre PETRA (Installation-Protection) 10

4
Procdure d'installation

4.1 - INSTALLATION
Attention : pour installer le logiciel, lutilisateur doit avoir les droits administrateurs de son
poste, si ce nest pas le cas veuillez-vous rapprocher de votre service informatique afin quil
procde linstallation.

Aprs avoir procder la mise jour du dongle et que celui-ci soit connect lordinateur, vous
pouvez procder linstallation du logiciel en excutant le programme Setup.exe .

Aprs avoir lanc le programme dinstallation, la bote de dialogue suivante saffiche :

Cliquez sur le bouton <Suivant> pour continuer

 PETRA (Installation-Protection) 11

LICENCE DUTILISATION
La bote de dialogue de saisie de la cl saffiche :

IMPORTANT : Les codes Licence et Cl du produit seront communiques par un membre de

lEquipe PETRA par voie tlphonique. En effet, ds lors que vous procdiez une activation ou mise
jour du dongle, un contact tlphonique sera tabli afin de vous guider lors de linstallation.
Aprs avoir renseigner les codes demands, cliquer sur le bouton <Suivant> pour continuer.

INSTALLATION LIBRE OFFICE

Le programme dinstallation recherche si la suite bureautique Libre Office est installe sur le
poste. Plusieurs cas de figures sont possibles :
o Si Libre Office est installe dans une version 3.6 ou ultrieure :
 PETRA (Installation-Protection) 12

o Si Libre Office nest pas install :

 PETRA (Installation-Protection) 13

o Si une version antrieure Libre Office 3.6 est installe :

o Dans les deux derniers cas, le programme lance linstallation de la suite bureautique
Libre Office 3.6.1 contenue sur le CD dinstallation PETRA v3.0.

Si Libre Office est prsent sur le poste la fin de linstallation de PETRA v3.0, le programme
ouvrira le document Configuration Libre Office spcifiant les paramtres ncessaires au
bon fonctionnement de PETRA v3.0.

Cliquez sur le bouton <OK> pour continuer linstallation

DESINSTALLATION AUTOMATIQUE DE PETRA V2.0

Si la version prcdente de PETRA (Petra v2.0) est installe sur votre poste, le message
suivant apparait :
 PETRA (Installation-Protection) 14

o Vous pouvez dcider de dsinstaller ou non PETRA v2.0. Dans ce cas, linstallation
de PETRA v3.0 reprendra une fois PETRA v2.0 dsinstall.
Si la version prcdente de PETRA (Petra v2.0) nest pas installe sur votre poste, le
programme passe lcran suivant :

SELECTION DU REPERTOIRE DINSTALLATION

La bote de dialogue de slection du dossier dinstallation saffiche avec le dossier par dfaut
C:\PETRA3_0 ; vous pouvez toutefois changer le rpertoire dinstallation, et ce en cliquant
sur le bouton <Parcourir> :

Il nest pas possible actuellement dinstaller PETRA dans un rpertoire contenant des
espace (exemple : C:\Program Files\PETRA3). Ce bogue sera corrig dans une version
ultrieure de PETRA
Cliquez sur le bouton <Suivant> pour continuer
 PETRA (Installation-Protection) 15

CHOIX DU TYPE DINSTALLATION

La bote de slection du type dinstallation saffiche :

Slectionnez le type dinstallation recommand : Complte , puis cliquez sur le bouton

<Suivant> pour continuer

CHOIX DU DOSSIER PROGRAMME

La bote de dialogue de slection du dossier programme saffiche en proposant le dossier
programme par dfaut SETRA , vous avez la possibilit dindiquer soit un dossier existant,
soit un nouveau dossier :

Cliquez sur le bouton <Suivant> pour continuer

 PETRA (Installation-Protection) 16

VALIDATION DE LINSTALLATION
Une bote de dialogue affiche un rcapitulatif des choix effectus avant la copie des fichiers :

Cliquez sur le bouton <Suivant>, le systme copie les fichiers dinstallation dans le rpertoire
indiqu.

A lissue de cette tape, le systme affiche le message dinformation suivant :

Attention, pour paramtrer Libre Office, il est ncessaire que le niveau de scurit des macros
soit du niveau faible ou moyen (voir le document Configuration Libre Office 3.6.1
pour PETRA.

Cliquez sur le bouton <OK>, dans le cas dun niveau de scurit moyen , Libre Office affiche le
message davertissement de scurit suivant :
 PETRA (Installation-Protection) 17

Cliquez sur le bouton <Activer les macros> afin dautoriser lexcution des macros dans Libre
Office

FIN DINSTALLATION
Une fois le paramtrage Libre Office termin, le systme affiche une bote de dialogue de fin
dinstallation :

Cliquez sur le bouton <Terminer>.

PARAMETRAGE DE LIBRE OFFICE

Une fois linstallation termine, le programme ouvre le document Configuration_LibreOffice.odt ,
spcifiant le paramtrage appliquer la suite bureautique, afin de permettre ldition des diffrents
documents.
 PETRA (Installation-Protection) 18

CHARGEMENT DE LA BIBLE

Avec l'explorateur Windows, placez le fichier OA201201.BIB prsent sur le CD d'installation

de PETRA, ou le fichier d'une bible "OA neufs" plus rcente tlcharge sur le site
http://www.piles.setra.equipement.gouv.fr, dans le sous-rpertoire "user" du rpertoire
"PETRA3_0" cre sur le disque C de votre ordinateur par l'tape prcdente d'installation.

DEMARRER PETRA

Dmarrer PETRA en effectuant un double-clique sur l'icne qui apparat sur le bureau de votre
ordinateur.
o La fentre principale de PETRA apparait :
 PETRA (Installation-Protection) 19

CHARGER LA BIBLE OA
Choisissez BIBLE, CHARGER.
La fentre CHARGEMENT D'UNE BIBLE s'affiche.

Slectionnez la bible souhaite (ici la bible OA201201.BIB) et cliquez sur OUVRIR.

La fentre DETAIL DE LA BIBLE, qui contient la description de la bible OA, saffiche.

Cliquez sur CONTINUER.

Lavancement du CHARGEMENT DE LA BIBLE est matrialis par un curseur. Lorsque ce curseur

disparat, l'installation de PETRA est termine.

QUITTER PETRA
Choisissez Dossier, Quitter ;
 PETRA (Installation-Protection) 20

ou cliquez sur licne : ;

ou appuyez simultanment sur les touches + .

REMARQUES DIVERSES

Il n'est pas possible de procder une installation mixte Office/Open Office de PETRA 2.0
permettant de travailler indiffremment avec l'une ou l'autre de ces suites. Un utilisateur
disposant des deux suites aura intrt opter pour Office, d'une part car la prsentation
est lgrement meilleure avec cette suite, d'autre part car le fonctionnement sous Word et
Excel, effectif depuis plusieurs annes, est mieux matris que celui sous Writer et Calc.

L'installation de PETRA 3.0 procde automatiquement la dsinstallation de PETRA 2.0

si celle-ci est dj installe.

L'installation de PETRA 3.0 procde automatiquement linstallation de Libre Office 3.6.1

si la suite bureautique nest pas dj installe.

Aprs linstallation de Libre Office 3.6, dans Writer, la commande

"Outils/Option/LibreOffice Base /Base de donnes" doit montrer que les macros utilises
par PETRA 3.0 pour ses ditions ont bien t prises en compte (voir ci-dessous)

Si ce n'est pas le cas, relancer l'installation de PETRA 3.0 en vrifiant au pralable que
toutes les fentres Libre Office sont fermes
loutil de dmarrage rapide est arrt
 PETRA (Installation-Protection) 21

Figure 1: Icne de l'outil de dmarrage rapide