MapOut / M-Storage

About Mapout / M-Storage

Easily find the documents produced by our solution wherever you are !

M-Storage is the documentary warehouse solution of Mapping. It provides immediate storage solution documents produced by the Mapping processing chains.

In addition to the warehouse function, M-Storage provides functions of consultation and web mode research (see Doc: Mapweb / M-Storage Web). Thus, documents are made available to end users via your intranet or extranet solutions. The indexing functions (classification tree according meta data) and research help provide a history of the documents produced by the company. Modèle:BlocEnd Modèle:BoxEnd

How-To's / Tips & Hints

How to transfer archives from one disk to the other

This article relates to MapOut / MapWeb 5.2 and higher when used in conjunction with a MySQL database.

Follow these steps to transfer your MapOut archival records from one disk to the other e.g. if you are changing servers. As a requirement, you will need to have the same structure on both disks. For example, if the archives were in C:\mapout\archives\, you will now transfer them to D:\mapout\archives\ (where C: is the source disk and D: the new disk).

Run the following commands:

UPDATE accessvolume SET NomVolume = REPLACE(NomVolume, "C:", "D:") WHERE NomVolume like "C:%";

UPDATE criteres SET Volume = REPLACE(Volume, "C:", "D:") WHERE volume like "C:%";

UPDATE groupcritere SET Volume = REPLACE(Volume, "C:", "D:") WHERE Volume like "C:%";

UPDATE spools SET Volume = REPLACE(Volume, "C:", "D:") WHERE Volume like "C:%";

UPDATE usercritere SET Volume = REPLACE(Volume, "C:", "D:") WHERE Volume like "C:%";

UPDATE volumes SET Volume = REPLACE(Volume, "C:", "D:") WHERE Volume like "C:%";

How to use an e-mail address contained in a MySQL table

This article relates to MapOut (MapCom) 5.2 and higher and MapDraw 6.0 and higher

This article shows how to use e-mail addresses contained in a MySQL table to e-mail mapped spooled files automatically to dynamic addresses. You will need a database table with a list of names found in the spooled file under the heading NAME for example and for each name the e-mail address(es) to which the files will be sent under the heading EMAIL for example.

In MapDraw, the document template must have the 3 following zones to handle the distribution of the e-mail:

1. NAME : Memory / Text Memory zone containing the name grabbed from the spooled file

2. EMAIL : Memory / SQL Memory zone. Add the following SQL command in the 'Characters added after the zone' field: {SQL SELECT EMAIL FROM TEST.USER WHERE NAME="[[NAME]]"}. This zone queries the database and retrieves the value of the EMAIL field based on the NAME. The NAME zone is used to filter the line we're interested in.

3. MAPSND : Archive / MapSend zone. MapCom sends an e-mail to the address(es) stipulated in MapDraw using the MAPSND zone. Here you don't grab the value directly from the spooled file but you want to use the value returned by the EMAIL SQL zone. So in the MAPSND zone, you need to use the value EMAIL [[EMAIL]] in the 'Characters added after the zone' field.

Then, generate the project and import it as you would normally do. From now on, whenever the spooled file is processed with this template, a query will be made to the database to determine which e-mail address to use.

It would worl exactly the same way on iSeries, the only difference being that on iSeries we're dealing with Physical Files and not Database Tables. The database on the iSeries would be the Library and the table would be the Physical File.

How to connect to the MapOut server in console mode

This article relates to MapOut Server 5.2 and higher when installed on a Windows 2003 server.

The best way to connect to the MapOut server remotely is to use the "console mode", especially if the MapOut service is used.

To connect to a distant server in console mode, go to Start / Run, type 'mstsc -console' (without the quotes) and click OK. This opens the Remote Desktop Connection program. Enter the computer name and click Connect.

Once logged on the server, start the Task Manager and in the Users tab, check that your ID is 0 and that you have 'console' under Session.

If the console mode is disabled on the server, go to Start / Run, type 'gpedit.msc' (without the quotes) and click OK. This opens the Group Policy configuration panel where you can enable console mode. To learn more about console mode, read the following article from the Microsoft Knowledge Base: http://support.microsoft.com/kb/278845

Supported PDF standards in MapOut

This article relates to MapOut all versions

By default, the PDF documents generated in MapOut (all versions) are in the PDF 1.3 format.

In MapOut 7.1.0 and higher, the PDF documents signed electronically are produced in the PDF 1.6 format and are compatible with Acrobat Reader 7 and higher.

MapOut also produces PDFs in the PDF/A-1b format if the archives are in the XPS format. Modèle:BlocEnd Modèle:BoxEnd

Troubleshooting

Codes de retour et codes erreurs

• Code 1 : Début d'archivage du spool
• Code 2 : Une erreur est survenue lors de l'archivage. Les causes de l'erreur peuvent être les suivantes :

- le répertoire de destination ne peut pas être crée

- le répertoire de destination est inaccessible (lecteur réseau indisponible, ...)

- erreur de fichier password.txt

- le fichier à archiver est endommagé

- ../..

Le message précédent indique les causes de l'erreur.

• Code 3 : Le fichier est déplacé dans le répertoire temporaire... Une erreur est survenue, le fichier S* est déplacé dans le répertoire temporaire. Vérifier les messages précédents pour connaître les causes de l'erreur.
• Code 4 : Traitement OK. L'archivage s'est déroulé correctement. MapOut est prêt à archiver le fichier suivant.
• Code 5 : Erreur inconnue. Une erreur est survenue lors de l'envoi du fichier dans le répertoire de fax.
• Code 6 : Erreur MAPI. La fonction GetProcAddress n'a pas renvoyé la session attendue. Windows n'a pas renvoyé d'informations sur l'erreur.
• Code 7 : Au moins une erreur inconnue s'est produite durant la connexion. Pas de session MAPI créée. Windows n'a pas renvoyé d'informations sur l'erreur.
• Code 8 : Mémoire insuffisante. Pas de session MAPI créée.

- Fermez toutes les applications ouvertes.

- Redémarrez MapOut Manager

- Redémarrez le processus de mail et de fax automatique

• Code 9 : Pas de profil par défaut et échec de la connexion manuelle. Pas de session MAPI créée.

- Entrez le profil courrier à utiliser par MapOut :

- Menu Fichier, Préférences

- Onglet Email et Fax : Login

• Code 10 : Un identifiant de message invalide a été passé au paramètre lpszSeedMessageID. Aucun message trouvé.

License keys on a Virtual Machine

Mapping Suite software can be installed on a virtual server. However, be careful with license keys:

- Virtual machines are considered as servers in terms of license. You must request one license key per Virtual Machine.

- License keys are resources dependent. If you modify the resources allocated to a VM, it may deactivate your license key. For instance, if you change the disk size of the VM.

Erreur Password.txt

1. Dans l'interface Mapping sur le serveur Windows, aller dans le menu Administration puis Gérer les mots de passe M-Storage
2. Cliquer sur le bouton "Créer le fichier Mot de passe"
3. Récupérer le nouveau fichier password.txt dans le dossier Mapping / Archives, puis le remettre dans le dossier localftp et dans le dossier d'archives de M-Storage

Echec de l'archivage ou de l'envoi

De manière générale, dans le cas d'un échec de traitement, vous pouvez vérifier les éléments suivants :

1. Vérifier la log de l'envoi de mail
2. Vérifier les Propriétés de l'envoi de mail
3. Vérifier les Conditions de l'envoi de mail
4. Vérifier les chemins dans les Préférences
5. Supprimer les fichiers secure.lck dans les dossiers archivage, mail et sending

Si cela, ne fonctionne toujours pas, il se peut que l'un des dossiers soit corrompu. Dans ce cas :

1. Renommer le dossier en backup
2. Créer le nouveau dossier avec le nom d'origine
3. Coller le passwd.txt dans le nouveau dossier
4. Relancer les spools (les fichiers C…map et P….map sont dans le localftp, le fichier S….map se trouve dans le dossier temp de M-Storage). Il faut les remettre tous dans le dossier localftp pour être rejoués.

Les Processes ou les Services ne démarrent pas

Si les processes ou les services ne démarrent pas, vous pouvez essayer les étapes décrites ci-dessous.

Redémarrer les services Windows

Vous pouvez redémarrer les services suivants sur le serveur Windows, dans l'ordre ci-dessous :

• Redémarrer MySQL
• Redémarrer Apache
• Redémarrer M-Strorage Manager
• Redémarrer M-Storage

Si cela ne fonctionne pas :

Vérifier que les règles n'ont pas été modifiées

Si une ou plusieurs règles ont été modifiées sans arrêter les processes, vous trouverez un fichier "mysql_database_failed" dans le dossier M-Storage là où sont stockées les règles .xml. Dans ce cas, il faut supprimer ce fichier, puis redémarrer les processes.

Vérifier les dossiers

Si cela ne fonctionne pas, il se peut qu'un dossier (archivage, mail, sending) soit corrompu. Dans ce cas, vous pouvez renommer le dossier existant et recréer un dossier vide.

Si cela ne fonctionne toujours pas, vous pouvez procéder à une réinstallation des services, comme expliqué ci-dessous.

Réinstaller les services

En dernier recours, vous pouvez réinstaller les services M-Storage / MapOut :

• Ouvrir une ligne de commande
• Positionnez-vous dans le chemin de M-Storage / MapOut
• Exécuter la commande suivante :

M-storage.exe -i 

ou

Mapout.exe –i

• Puis redémarrer le serveur

Echec de l'envoi vers un serveur distant

Si vous envoyez les documents vers un serveur distant via FTP, il faut vérifier les droits d'accès au serveur distant.

Il faut que le M-Storage Manager et le M-Storage soient connectés au domaine, et non au système local.

Dans la fenêtre des Propriétés de chaque service, dans l'onglet Connexion, il faut cocher la case "Connexion au domaine".

AJOUTER SCREENSHOT

Problème de connexion FTP

Vérifier qu'il n'existe pas de profil FTP vide dans la configuration du FTP (onglet Archives, FTP).

MapOut erreur 41 inconnu SMTP

Dans la log SMTP, si vous trouvez le message "MapOut erreur 41 inconnu SMTP", il s'agit d'un problème de connexion au serveur SMTP. Dans ce cas, il faut vérifier la disponibilité des ports du serveur SMTP. Il n'y a rien à faire côté M-Storage / MapOut.

HTTP request 1400 bad request

Dans la log d'archivage, si vous trouvez le message "Http request 1400 bad request", il s'agit d'un problème de configuration du port d'écoute. Le port est certainement utilisé par un autre logiciel. Il faut libérer ce port pour M-Storage / MapOut uniquement. Certains pare-feux ou antivirus peuvent empêcher le bon fonctionnement de M-Storage / MapOut.