Departament de Biblioteconomia i Documentació

Bagit Library, versión 4.1 Instalación para Windows 7

Tutoriales de instalación y uso de programas de preservación digital

Mayo 2012

Bagit Library 4.1

2

Tutoriales de instalación y uso de programas de preservación digital Dirección: Miquel Térmens Graells Autora: Anita E. Locher Equipo de trabajo de preservación digital: Jordi Andreu Daufí; Maria Elvira y Silleras; Alice Keefer Riva; Jordi Serra Serra Contacto: termens@ub.edu

Bagit Library, versión 4.1 Edición mayo 2012 Departament de Biblioteconomia i Documentació Universitat de Barcelona Melcior de Palau, 140 08014 Barcelona www.ub.edu/biblio Licencia Creative Commons CC BY-ND 3.0

Bagit Library 4.1

3

Bagit Library 4.1

Creador: Library of Congress

URL: http://sourceforge.net/projects/loc-xferutils/ (descarga)

Descripción: Crea bolsas/conjuntos (bags) de ficheros indicados por el usuario para transferirlas y almacenarlas

Requerimientos: Java 6

Licencia: Libre de derechos según la licencia LICENCE.txt entregado con el programa

Otros: Basado en la versión bagIt 0.97

Versión: 4.1 (2012-01-27)

Nombre del fichero: bagit-4.1-bin.zip

Ubicación por defecto:

Sin ubicación

1 Instalación

1.1 Instalación para Windows 7

1.1.1 Baja el fichero y descomprímelo.

1.1.2 Coloca los ficheros extraídos en un directorio en el que tengas derecho a escribir. Por ejemplo C:\Program Files\

Nota: No existe un fichero ejecutable para la instalación de Bagit Library.

2 Configuración de Java

Para la correcta configuración de Java en Windows 7 consulta el enlace http://www.luiskano.net/blog/2010/04/28/tutorial-instalar-java-jdk-en-windows-7/

3 Manual de uso

3.1 Configuración de Bagit

3.1.1 Crea una carpeta bags_entrada en un directorio, en este caso L:\

Bagit Library 4.1

4

3.1.2 Dentro de la carpeta \bags_entrada, crea una carpeta \envio123 (en la que 123 sea el número del envío).

3.1.3 Introduce el archivo (o los archivos) a empaquetar en la carpeta \envio123.

3.1.4 Crea una carpeta \bags_salida en la unidad de disco donde quieres grabar o registrar los bags. En nuestro caso L:\

3.1.5 Abre el Bloc de notas.

3.1.6 Copia y pega en el cuadro siguiente:

@echo off REM Obre la consola de DOS C:\WINDOWS\system32\cmd.exe /k "C:\Program Files\Bag-It\bagit-4.1\bin\bag" create L:\bags_salida\envio0001.zip L:\bags_entrada\Envio0001 --writer zip

3.1.7 Adapta las informaciones a tu configuración.

Explicación de cada elemento:

REM : indica que lo que sigue es un comentario.

C:\WINDOWS\system32\cmd.exe : abre la consola de DOS -> Mantener tal cual.

/k es un comando DOS para ejecutar lo que sigue -> Mantener tal cual.

C:\Program Files\Bag-It\bagit-4.1\bin\bag : es el camino hasta el ejecutable bag.bat dentro de los ficheros de Bagit. Es importante que esté guardado en el mismo directorio que el cmd.exe -> Adapta el path a la ubicación y a los nombres de las carpetas que corresponden en tu ordenador (p.ej. si has bajado una versión más reciente puede ser bagit-4.5\bin\bag).

Create : es un comando de BagIt que crea lo que le sigue -> Mantener tal cual

L:\bags_salida\envio0001.zip : es el nombre y la ubicación del fichero de salida que creará -> Adapta el path al directorio que has elegido en el paso 3.1.4. Adapta el número del envío, si no es el primero, para no grabar encima de un fichero existente.

L:\bags_entrada\Envio0001 : es el path a la carpeta que contiene los datos que hay que empaquetar. -> Adapta el path al directorio que has elegido en el paso 3.1.1 Adapta el número del envío, si no es el primero, al nombre de la carpeta que has creado en el paso 3.1.2.

3.1.8 En la barra de herramientas del Bloc de notas ve a “Archivo” – “Guardar como”. Da un nombre al fichero, dale la extensión .bat (por ejemplo: ejecutarBagit.bat) y guárdalo en el directorio en que guardaste los ficheros que has bajado. En este caso es el C:\Program Files\Bag-It\bagit-4.1

3.2 Crear un bag

3.2.1 Coloca todos los ficheros que desees empaquetar en la carpeta \Envio123.

Bagit Library 4.1

5

3.2.2 Haz doble clic en el fichero ejecutarBagit.bat que acabas de crear.

3.2.3 Se abre el cmd (consola de DOS) donde Bagit ejecuta los comandos.

Nota: Si sale el error “Exception in thread "main" java.lang.NoClassDefFoundError: org/codehaus/classworlds/Launcher” la carpeta que contiene bagIt/bin/bag no está en el directorio C:\ o el fichero ejecutarBagit.exe no está en el mismo directorio C:\Program Files\Bag-It\bagit-4.1

3.2.4 En la carpeta \bags_salida busca la nueva carpeta \envio0001.zip creada por Bagit.

3.2.5 Dentro del zip se encuentra una carpeta con el mismo nombre (\envio0001) que contiene los ficheros siguientes:

\data (La carpeta que contiene todos los ficheros originales) bag-info.txt Bagit.txt Manifest-md5.txt Tagmanifest-md5.txt

Bagit Library 4.1

6

3.2.6 Antes de hacer un segundo envío crea una nueva carpeta \envio123 y dale el número correlativo siguiente (p.ej. \envio0002).

3.2.7 Introduce en ella los nuevos ficheros.

3.2.8 Clica con el botón derecho en el fichero ejecutarBagit.bat y selecciona “Editar” para abrirlo con el Bloc de notas.

3.2.9 Adapta los paths y los nombres de las carpetas al nuevo envío.

3.2.10 Guarda y ejecuta ejecutarBagit.bat

4 Anexo: Ayuda de Bagit

La ayuda de Bagit consiste en una explicación de los comandos posibles para el fichero .bat Para visualizarla introduce en el cmd (consola de DOS) del sistema operativo el siguiente comando:

cd C:\Program Files\Bag-It\bagit-4.1\bin bag --help (Adapta la parte roja del path a la ubicación de Bagit en tu ordenador)

A continuación aparece el contenido de la ayuda de Bagit.

Usage: bag <operation> [operation arguments] [--help]

Parameters:

<operation>

Valid operations are: baginplace, checkpayloadoxum, create, fillholey, generatepayloadoxum, makecomplete, makeholey, retrieve, splitbagbyfiletype, splitbagbysize, splitbagbysizeandfiletype, update, updatetagmanifests, verifycomplete, verifypayloadmanifests, verifytagmanifests and verifyvalid..

Operation explanations:

• baginplace: Creates a bag-in-place. The source must be a directory on a filesystem and may already have a data directory.

• checkpayloadoxum: Generates Payload-Oxum and checks against Payload-Oxum in bag-info.txt.

• create: Creates a bag from supplied files/directories, completes the bag, and then writes in a specified format.

• fillholey: Retrieves any missing pieces of a local bag specified in the fetch.txt. • generatepayloadoxum: Generates and returns the Payload-Oxum for the bag. • makecomplete: Completes a bag and then writes in a specified format. Completing a

bag fills in any missing parts. • makeholey: Generates a fetch.txt and then writes bag in a specified format.

Bagit Library 4.1

7

• retrieve: Retrieves a bag exposed by a web server. A local holey bag is not required. • splitbagbyfiletype: Splits a bag by file types. • splitbagbysize: Splits a bag by size. • splitbagbysizeandfiletype: Splits a bag by size and file types. • update: Updates the manifests and (if it exists) the bag-info.txt for a bag. • updatetagmanifests: Updates the tag manifests for a bag. The bag must be

unserialized. • verifycomplete: Verifies the completeness of a bag. • verifypayloadmanifests: Verifies the checksums in all payload manifests. • verifytagmanifests: Verifies the checksums in all tag manifests. • verifyvalid: Verifies the validity of a bag.

[--version]

Prints version of BIL and exits.

[--help]

Prints usage message for the operation.

Examples:

bag verifyvalid --help

Prints help for the verifyvalid operation.