Procedimiento para implementar una regla de mantenimiento con un paquete de solución

Última modificación: martes, 15 de noviembre de 2011

Hace referencia a: SharePoint Foundation 2010

En el entorno de desarrollo, la implementación de una nueva regla de mantenimiento es simple. Puede instalar en forma manual el ensamblado que contiene la regla mediante la herramienta de caché global de ensamblados (Gacutil.exe) para colocar el ensamblado en la caché global de ensamblados (GAC) del servidor de implementación. Si creó una característica de SharePoint para registrar la regla con el Analizador de mantenimiento de SharePoint, puede instalar la característica en forma manual mediante la Consola de administración de SharePoint para ejecutar el siguiente cmdlet de Windows Powershell: Install-SPFeature. Puede usar el siguiente cmdlet de Windows Powershell para activar la característica y registrar la regla: Enable-SPFeature.

El procedimiento manual no resulta práctico en un entorno de producción en donde es muy probable que la granja de servidores esté formada por muchos servidores e incluso es posible que con el tiempo se conecten más servidores. En un entorno de producción, el mejor enfoque es usar un paquete de solución. Puede cargar un paquete de solución una vez, y la solución se propaga a todos los servidores de la granja. Cuando se conectan los nuevos servidores, reciben la solución en forma automática como parte de su aprovisionamiento.

En este tema se explica cómo crear un paquete de solución que contenga una regla de mantenimiento, y cómo cargar e implementar la solución en una granja de servidores. Se supone que ya realizó los procedimientos descritos en Procedimiento para crear una regla de mantenimiento y Procedimiento para crear una característica para registrar una regla de mantenimiento.

Creación de un paquete de solución

Un paquete de solución es un archivo CAB con extensión de nombre de archivo .wsp, que contiene todos los archivos que se deben implementar en los servidores de la granja de servidores. Debido a que se usa un paquete de solución para implementar una regla de mantenimiento, el paquete instalará dos archivos: feature.xml y el ensamblado para la regla. Cada paquete de solución debe contener, también, un archivo llamado manifest.xml, que incluye instrucciones para instalar la solución.

El primer paso para la creación de la solución es crear manifest.xml. El segundo paso es crear un archivo .ddf (archivo de directivas Diamond), que instruye a la herramienta de línea de comandos MAKECAB.EXE sobre qué archivos incluir en el archivo CAB de salida. El último paso es usar MAKECAB.EXE para compilar el archivo CAB.

Para crear el manifiesto para un paquete de solución

1. Abra Visual Studio como administrador haciendo clic con el botón secundario en el programa en el menú Inicio y seleccionando Ejecutar como administrador.

2. Abra el proyecto que contiene el código para la regla de mantenimiento.

3. Cree una carpeta de solución.

   En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, elija Agregar y, a continuación, Nueva carpeta. Escriba Solución.

4. Cree un archivo de manifiesto de la solución.

   Haga clic con el botón secundario en la carpeta Solución, elija Agregar y, a continuación, elija Nuevo elemento.... En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Archivo XML. Nombre el archivo como manifest.xml. A continuación, haga clic en Agregar.

5. Abra manifest.xml en el editor.

6. Elimine la primera (y única) línea del archivo. En su lugar, pegue el siguiente código.

   <Solution SolutionId="00000000-0000-0000-0000-000000000000"
             xmlns="https://schemas.microsoft.com/sharepoint/">
     <FeatureManifests>
       <FeatureManifest Location="FeatureFolderName\feature.xml" />
     </FeatureManifests>
     <Assemblies>
       <Assembly DeploymentTarget="GlobalAssemblyCache"
                 Location="AssemblyName.dll" />
     </Assemblies>
   </Solution>
   

7. Reemplace el valor del atributo SolutionId con un GUID generado recientemente (sin llaves).

   Puede usar la herramienta GuidGen (guidgen.exe) para obtener un nuevo GUID. En el menú Herramientas de Visual Studio, elija Crear GUID. En el cuadro de diálogo Crear GUID, seleccione 4. Formato de registro y, a continuación, haga clic en Copiar. Pegue el contenido del portapapeles entre comillas después del atributo SolutionId. Quite las llaves del GUID.

8. Modifique el valor del atributo Location del elemento FeatureManifest, reemplazando "FeatureFolderName" por el nombre de la carpeta de la solución que contiene el archivo feature.xml.

   Cuando se implemente la solución, se creará una carpeta con el mismo nombre en la carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES de cada servidor de la granja de servidores.

9. Modifique el valor del atributo Location del elemento Assembly, reemplazando "AssemblyName.dll" con el nombre de archivo del ensamblado de la regla.

10. Guarde manifest.xml.

Para crear un archivo de directivas para el paquete de solución

1. Cree una carpeta de paquete en el proyecto de Visual Studio.

   En el Explorador de soluciones, haga clic con el botón secundario en el nombre del proyecto, elija Agregar y, a continuación, elija Nueva carpeta. Escriba Paquete.

   Se trata del directorio de salida para la herramienta de línea de comandos MAKECAB.EXE.

2. Cree un archivo .ddf (archivo de directivas Diamond) en la carpeta Solución del proyecto de Visual Studio.

   En el Explorador de soluciones, haga clic con el botón secundario en la carpeta llamada Solución, elija Agregar y, a continuación, elija Nuevo elemento.... En el cuadro de diálogo Agregar nuevo elemento, seleccione la plantilla Archivo de texto. Nombre el archivo como cab.ddf. A continuación, haga clic en Agregar.

   Este archivo se usará con la herramienta de línea de comandos MAKECAB.EXE.

3. Abra cab.ddf en el editor. Copie el siguiente fragmento y péguelo en el archivo cab.ddf.

   .OPTION EXPLICIT     ; Generate errors 
   .Set CabinetNameTemplate=SolutionName.wsp
   .set DiskDirectoryTemplate=CDROM ; All cabinets go in a single directory.
   .Set CompressionType=MSZIP;** All files are compressed in cabinet files.
   .Set UniqueFiles="ON"
   .Set Cabinet=on
   .Set DiskDirectory1=Package ; This is the output directory.
   
   ; Files to include.
   Solution\manifest.xml manifest.xml
   Features\FeatureFolderName\feature.xml FeatureFolderName\feature.xml
   bin\Release\AssemblyName.dll AssemblyName.dll
   

4. Modifique el valor del argumento CabinetNameTemplate, reemplazando "SolutionName" con el nombre de archivo que desee usar para el paquete de solución. (Mantenga la extensión de archivo .wsp.)

5. Reemplace "FeatureFolderName" (aparece dos veces) con el nombre de la carpeta de la solución que contiene el archivo feature.xml.

6. Reemplace "AssemblyName.dll" (aparece dos veces) con el nombre de archivo del ensamblado de la regla. Además, si la ruta de acceso relativa al ensamblado no es "bin\Release\", reemplace la cadena con la ruta de acceso correcta.

7. Guarde cab.ddf.

Para crear el archivo del paquete de solución

1. Abra un símbolo del sistema de Visual Studio.

2. Navegue hasta el directorio del proyecto de Visual Studio.

   Las rutas de acceso de archivo en cab.ddf y en el comando que se emite en el siguiente paso son relativas al directorio del proyecto de Visual Studio.

3. En el símbolo del sistema, emita el siguiente comando:

   makecab /f solution\cab.ddf
   

   Se crea un paquete de solución en la carpeta Paquete.

Carga e implementación de la solución

Luego de crear un nuevo paquete de solución, debe probarlo en una instalación de SharePoint, preferentemente en una imagen limpia y no en el servidor de desarrollo. Esto implica dos tareas; primero, debe cargar el paquete de solución en la granja de servidores y, luego, debe implementar la solución.

Nota

La solución incluye una característica con ámbito a nivel de la granja de servidores. Debido a que una característica de nivel de granja de servidores se activa automáticamente cuando se instala, no es necesario que emita un comando para activarla en forma manual.

Para cargar e implementar un paquete de solución en la granja de servidores

1. Abra Consola de administración de SharePoint como administrador haciendo clic con el botón secundario en el elemento del menú Inicio/Herramientas administrativas y seleccionando Ejecutar como administrador.

2. En el símbolo del sistema, emita el siguiente comando para cargar la solución. (Sustituya con la ruta de acceso completa y el nombre de archivo del paquete de solución.)

   add-spsolution -literalpath <full path and filename.wsp>
   

   El paquete de solución ya está cargado en la granja de servidores.

3. En el símbolo del sistema, emita el siguiente comando para implementar la solución. (Sustituya con el nombre de archivo correcto del archivo. wsp.)

   install-spsolution -identity filename.wsp -force -gacdeployment
   

La regla de mantenimiento ya está instalada y registrada. Puede comprobarlo mediante la revisión de la lista Regla del analizador de mantenimiento en la sección Supervisión de la Administración central.

Vea también

Tareas

Procedimiento para crear una regla de mantenimiento

Procedimiento para crear una característica para registrar una regla de mantenimiento

Conceptos

Creación manual de una solución

Otros recursos

Automating Solution Package Creation for Windows SharePoint Services by Using MSBuild