Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Tabla de Contenido
Prerrequisitos para implementacin de portal ........................................................................................ 2 Prerrequisitos de Hardware & Software ................................................................................................... 2 Requisitos de hardware: servidores web, servidores de aplicaciones e instalaciones de un solo servidor .................................................................................................................................................. 2 Requisitos de hardware: servidores de bases de datos ........................................................................ 2 Requisitos de software .......................................................................................................................... 3 Requisitos cuentas de servicio y acceso a servidores ............................................................................ 4 Requisitos de publicacin ......................................................................................................................... 4 Recursos Humanos .................................................................................................................................. 4 Contenido del Sitio ..................................................................................................................................... 5 CAPG ........................................................................................................................................................ 5 Gua de Instalacin y Configuracin ....................................................................................................... 10 Prerrequisitos para esta instalacin. ....................................................................................................... 10 Instalacin del portal ............................................................................................................................... 11 Creacin de Web Application .............................................................................................................. 11 Levantamiento de Site Collection ........................................................................................................ 13 Instalacin de Webparts ...................................................................................................................... 14 Creacin del sitio de autenticacin (Forms Authentication) ................................................................ 19 Gua para liberar la solucin de CAPG. .................................................................................................. 30 Instalacin por primera vez ..................................................................................................................... 30 Actualizacin de solucin CAPG.wsp ..................................................................................................... 33 Correccin de error en la implementacin de solucin ........................................................................ 35 Instalacin de script de precalentamiento ............................................................................................. 37
Pgina 1
4 GB para evaluacin o uso del programador 8 GB para uso de produccin en una granja con varios servidores o un solo servidor (Recomendado)
Disco duro
80 GB para la unidad de sistema Para el uso de produccin, se necesita espacio libre en disco adicional para las operaciones cotidianas. Mantenga el doble de espacio libre de la cantidad de RAM de que disponga para entornos de produccin.
Componente Procesador
Requisito mnimo
64 bits, cuatro ncleos para implementaciones pequeas 64 bits, ocho ncleos para implementaciones medianas (Recomendado) 8 GB para implementaciones pequeas 16 GB para implementaciones medianas (Recomendado)
RAM
Disco duro
80 GB para la unidad de sistema. El espacio en disco duro depende del tamao del contenido de SharePoint.
Pgina 2
Requisitos de software
Requisitos mnimos Entorno Servidor de base de datos en una granja de servidores Requisito mnimo Uno de los siguientes: Edicin de 64 bits de Microsoft SQL Server 2008 R2. (Recomendado) La edicin de 64 bits de Microsoft SQL Server 2008 con Service Pack 1 (SP1) y la actualizacin acumulativa 2.
Edicin de 64 bits de Windows Server 2008 Standard, Enterprise, Datacenter o Web con SP2, o la edicin de 64 bits de Windows Server 2008 R2 Standard, Enterprise, Datacenter o Web. Si ejecuta Windows Server 2008 con SP1, la Herramienta de preparacin de Productos de Microsoft SharePoint instalar Windows Server 2008 SP2 automticamente.
1. Rol Servidor web (IIS) 2. Rol Servidor de aplicaciones 3. Microsoft .NET Framework versin 3.5 SP1 4. Microsoft Sync Framework Runtime v1.0 (x64) 5. Microsoft Filter Pack 2.0 6. Microsoft Chart Control para Microsoft .NET Framework 3.5 7. Windows PowerShell 2.0 8. SQL Server 2008 Native Client 9. ADOMD.NET de Microsoft SQL Server 2008 Analysis Services 10. Actualizacin de los Servicios de datos de ADO.NET para .NET Framework 3.5 11. Una revisin para .NET Framework 3.5 SP1 que proporciona un mtodo para
SP1 admitir la autenticacin del token sin seguridad de transporte ni cifrado de mensajes en WCF. 12. Windows Identity Foundation (WIF) Equipo cliente
Un explorador compatible.
Pgina 3
As como nombres u ubicaciones de los servidores de base de datos y SharePoint donde ser instalado el portal de apoyo a posgrados.
Requisitos de publicacin
Es necesario para el portal de apoyos posgrados que se considere desde el momento de su instalacin que debe estar pblico a Internet por lo que es necesario considerar lo siguiente: Redireccionar el dominio http://apoyosposgrados.conacyt.gob.mx servidores internos del Conacyt. a los
Recursos Humanos
Al menos una persona quien ser el administrador master del portal Conacyt, y quien contar con la documentacin y archivos necesarios para la implementacin que son:
Respaldo del sitio apoyosPosgrados Base de datos de usuarios registrados en el sitio. Archivos wsp para instalar los webparts del sitio web. Documentacin paso a paso para configurar la autenticacin va forms en servidores de CONACYT
Para ello se recomienda las siguientes caractersticas mnimas como perfil del recurso. Administrador de plataforma SharePoint 2007 como requisito mnimo. Conocimientos de la seccin de administracin y configuracin de la plataforma SharePoint 2010. Familiarizacin de scripting en Power Shell para Sharepoint.
Pgina 4
CAPG
Dentro de ste proyecto podemos encontrar gran cantidad que conforma el sitio, es decir gran mayora de las partes que lo componen como pueden ser sus WebParts, Formas Html y Web Services. Dentro del proyecto CAPG podemos encontrar una carpeta con el nombre Layouts en la cual podemos encontrar los archivos que son escritos directamente en file system, en la carpeta de instalacin de SharePoint 2010. Los componentes de los Layouts son los siguientes: html Archivos elaborados mediante cdigo html. Son usados para describir la estructura y el contenido en forma de texto, as como para complementar el texto con objetos tales como imgenes. Estos archivos tal como su nombre lo indica se encuentran guardados en su carpeta correspondiente llamada html, el contenido de esta carpeta es: Images (carpeta que contiene imgenes de botones utilizados en la Forma de registro de usuarios. Login.html - pantalla que se muestra al momento en que el sitio necesita registrar el ingreso de usuarios especficos, solicitando su usuario junto con su contrasea Register.html Aqu se muestra la pgina de registro de usuarios, en la cual se les solicita los datos principales que los distingue como miembros CONACYT. WPNoticias.html Se muestra en la pgina principal del sitio, en ella se muestran noticias relevantes y relacionadas con temas importantes de nivel nacional. Images - Carpeta que contiene algunas imgenes utilizadas dentro del sitio. Scripts - Dentro de ellos se pueden encontrar archivos que hacen referencia estilos de pgina utilizados dentro del sitio. En la carpeta llamada Scripts podemos encontrar lo siguiente: Carpeta DatePicker jquery.ui.datepicker-es.js jquery.ui.datepicker-pt-BR.js Carpeta Highslide Carpeta graphics highslide-full.packed.js highslide.ie6.css highslide.css
Pgina 5
Carpeta jquery-ui-1.8.9.custom Dentro de esta carpeta podemos encontrar subcarpetas las cuales contienen hojas de estilo y archivos .js que contienen scripts de javascript. Jquery.Scroller-1.0.min.js Laboratorios.js
WebServices Permiten la comunicacin entre aplicaciones desarrolladas dentro del sitio. Se puede decir que un WebService es un contenedor que encapsula funciones especficas del desarrollo que se realiz, y hace que estas funciones puedan ser utilizadas en otros servidores. Dentro de los denominados WebServices podemos encontrar dos: Aqu se localizan los mtodos existentes que se han utilizado, junto con sus parmetros. A continuacin se muestra una lista de cada uno de ellos:
CAPG.asmx
Mtodo LoadQuestion
Parmetros string SiteUrl string ListName int NumQuestion string SiteUrl string ListName string Libreria double NumElements bool Ordenamiento string ID
ObtenerDetalleNoticia
CreateNewsAndUpdatesContent
Profile.asmx
Parmetros int id string correo string siteUrl string Email string Nombres string ApellidoPaterno string ApellidoMaterno
Pgina 6
string FechaNacimiento string Nacimiento_Pais string Nacimiento_Estado string Domicilio_Calle string Domicilio_Colonia string Domicilio_Municipio string Domicilio_Pais string Domicilio_Estado string CorreoPersonal string CorreoLaboral string TelefonoPersonal string TelefonoLaboral string Posgrado_AreaInteres string Posgrado_deInteres string Posgrado_Pais string DatosLaborales_Dependencia string DatosLaborales_Puesto string DatosLaborales_NivelSueldo string DatosLaborales_RemuneracionBruta string DatosLaborales_TipoContrato string CedulaProfesional string TituloNivel string FechaTitulo string EstatusTitulo string TituloTesis string PaisTesis string EstadoTesis string CedulaProfesional2 string TituloNivel2 string FechaTitulo2 string EstatusTitulo2 string TituloTesis2 string PaisTesis2 string EstadoTesis2 string CedulaProfesional3 string TituloNivel3 string FechaTitulo3 string EstatusTitulo3 string TituloTesis3
Pgina 7
string PaisTesis3 string EstadoTesis3 string CedulaProfesional4 string TituloNivel4 string FechaTitulo4 string EstatusTitulo4 string TituloTesis4 string PaisTesis4 string EstadoTesis4 string CedulaProfesional5 string TituloNivel5 string FechaTitulo5 string EstatusTitulo5 string TituloTesis5 string PaisTesis5 string EstadoTesis5 string NombreInstitucion string PuestoLaboral string PaisLaboral string EstadoLaboral string FechaInicio string FechaFin string NombreInstitucion2 string PuestoLaboral2 string PaisLaboral2 string EstadoLaboral2 string FechaInicio2 string FechaFin2 string NombreInstitucion3 string PuestoLaboral3 string PaisLaboral3 string EstadoLaboral3 string FechaInicio3 string FechaFin3 string NombreInstitucion4 string PuestoLaboral4 string PaisLaboral4 string EstadoLaboral4 string FechaInicio4 string FechaFin4
Pgina 8
CrearPersona
ObtenerDatosCombo
string site string web string nombres string apellidos string correo string fechaCumpleanos string sexo string rol string telefono string municipio string site string web string picture string Lista string Campo
Pgina 9
Este disco contiene: Una carpeta con el nombre 01-Instalacion y dentro de ella lo siguiente: o El archivo ApoyosPosgradosBK.bak, respaldo del sitio de ApoyosPosgrados de las instalaciones de CONACyT al da 21 de junio de 2012 con el siguiente ambiente: Windows Server 2008 Enterprise SQL 2008 SP 2 Sharepoint Server 2010. Sharepoint Language Pack (Espaol) o Un archivo CAPG.wsp que contiene todos los elementos (WebParts y formularios) necesarios para la operacin del portal. o Una carpeta con el nombre Language Pack Espaol y dentro de ella lo siguiente: El archivo ServerLanguagePack.exe El archivo SharePointLanguagePack.exe o Una carpeta Llamada Codigo con los archivos fuentes de todo el desarrollo o Un archivo CAPGBK.bak con el respaldo de la base de datos de los usuarios del portal al dia 21 de junio de 2012. o Una carpeta de nombre CAPGSTS con los archivos del sitio de autenticacin por formas. o Una carpeta de nombre FormsAuthenticationLogin con los archivos de la forma de autenticacin base para el sitio. o Un archivo llamado WarmUp.ps1 con cdigo para evitar el error de Microsoft de solicitar credenciales la primera vez que se accesa despus de un iisreset. Una carpeta con el nombre 02-Documentacin y dentro de ella lo siguiente: o Manual de Operacin del Centro de Apoyos para Estudios de Posgrado o Manual Tcnico del Centro de Apoyos para Estudios de Posgrado Una carpeta con el nombre de 03-Cdigo Fuente y dentro de ella lo siguiente: o La estructura completa de archivos de cdigo fuente de la solucin implementada en el portal, para ver el detalle consulte la pgina 5 de este manual en Contenido del Sitio.
Pgina 10
1. Desde el Sitio de Central Administration, identificar la seccin de Application Management e r a la seccin de Manage Web Applications
3. Indicar los siguientes datos para la seccin del Web Site en IIS
Pgina 11
Pgina 12
Este comando levantar el sitio en la URL que se indica en el comando con todo el contenido que se haya tenido a la fecha indicada del respaldo.
Pgina 13
Instalacin de Webparts
Instalacin por primera vez
Se tiene que obtener la solucin del CD ApoyosPosgrados en la ruta: 01-Instalacin\CAPG.wsp y copiarse a un folder local de la mquina. Para este ejemplo, el folder es c:\Liberaciones
1. Abrir la lnea de comandos powershell de Sharepoint Sharepoint 2010 Management Shell, con nivel de administrador.
Pgina 14
3. Ese comando agrega la solucin a la granja, pero an no est liberado. Se puede acceder a la pgina de Solution Management del Central Administration para revisar que efectivamente haya sido agregada la solucin y se encuentre con un estatus de Not Deployed
4. El siguiente paso es realizar el deploy de la solucin en el sitio deseado dando Click en la solucin CAPG y seleccionar la accin de Deploy Solution en la pantalla que aparece.
Pgina 15
5. En la pantalla que se muestra a continuacin estn los datos que se solicitan para la seleccin de Web Application en el cul se realizar el Deploy de la solucin CAPG.
6. Una vez que ha realizado el Deploy de la solucin, la pantalla que aparece es como la siguiente, donde es importante identificar la seccin de deployed to que nos indica las Web Applications en donde ya fue instalada la solucin CAPG.wsp.
Pgina 16
2. Seleccionar la opcin de Retract y seguir la pgina con las opciones para retirar la solucin.
Pgina 17
3. Una vez que la solucin fue retirada del Web Application es necesario removerla de la soluciones de la granja
4. Seleccionamos la solucin CAPG.wsp y en la pantalla que aparece seleccionar Remove Solution y seguir las confimraciones que hace Sharepoint para remover la solucin.
5. A partir de este paso se realiza una instalacin como la primera vez, siguiendo los pasos de la seccin Instalacin por primera vez.
Pgina 18
2. Debemos asegurarnos que esta base de datos tenga el usuario FormsAuthUser con el password Admin1234, con permisos de acceso a SQL y en la BD que acabamos de restaurar.
Pgina 19
Pgina 20
Pgina 21
Pgina 22
6. Crear el sitio de STS, para esto debemos crear un sitio en IIS con el nombre de login.apoyosposgrados.conacyt.gob y dentro copiamos el contenido del folder CAPGSTS contenido en el disco de instalacin.
Pgina 23
Pgina 24
Pgina 25
Pgina 26
Pgina 27
Pgina 28
Pgina 29
1. Abrir la lnea de comandos powershell de Sharepoint Sharepoint 2010 Management Shell, con nivel de administrador.
Pgina 30
4. Ese comando agrega la solucin a la granja, pero an no est liberado. Se puede acceder a la pgina de Solution Management del Central Administration para revisar que efectivamente haya sido agregada la solucin y se encuentre con un estatus de Not Deployed
5. El siguiente paso es realizar el deploy de la solucin en el sitio deseado dando Click en la solucin CAPG y seleccionar la accin de Deploy Solution en la pantalla que aparece.
Pgina 31
6. En la pantalla que se muestra a continuacin estn los datos que se solicitan para la seleccin de Web Application en el cul se realizar el Deploy de la solucin CAPG.
7. Una vez que ha realizado el Deploy de la solucin, la pantalla que aparece es como la siguiente, donde es importante identificar la seccin de deployed to que nos indica las Web Applications en donde ya fue instalada la solucin CAPG.wsp.
Pgina 32
2. Seleccionar la opcin de Retract y seguir la pgina con las opciones para retirar la solucin.
Pgina 33
3. Una vez que la solucin fue retirada del Web Application es necesario removerla de la soluciones de la granja
4. Seleccionamos la solucin CAPG.wsp y en la pantalla que aparece seleccionar Remove Solution y seguir las confimraciones que hace Sharepoint para remover la solucin.
5. A partir de este paso se realiza una instalacin como la primera vez, siguiendo los pasos de la seccin Instalacin por primera vez.
Pgina 34
Una de las probabilidades es que se haya realizado una restauracin de la granja errnea. Y algn feature anterior se qued en la Base de Datos de manera corrupta.
En este caso, se quedaron archivos corruptos de la liberacin que exista en la granja de la solucin CAPG.wsp, lo ms recomendable es intentar recuperar la configuracin original corriendo un wizard de configuracin de SharePoint antes de intentar liberar la solucin.
Si ya nos encontramos en este caso como aqu, lo que haramos es lo siguiente, vamos a utilizar la herramienta de nombre FeatureAdmin.exe localizada en el siguiente link de descarga: http://featureadmin.codeplex.com/releases Ah vamos a retirar el feature que est fallando el cual podremos detectar si accedemos a los detalles del error dando click en el nombre de capg.wsp.
La manera de usar esta herramienta es intuitivo, primero seleccionas el web application que quieres examinar (apoyosposgrados). Despues el site collection a verificar y le damos click en el botn de LOAD del lado derecho.
Una vez con los features cargados, debemos identificar el que nos est dando problemas y hacer click en Uninstall.
Pgina 35
Pgina 36
Este es un error conocido y para el cual an no ha sido lanzada ninguna solucin por parte de Microsoft, lo que se realiz para solucionar este error, es implementar un script de precalentamiento.
Estos scripts de precalentamiento son comnmente usados para agilizar el acceso a Sharepoint, simulando un acceso al sitio cada que el sitio se reinicia para precargar todos los archivos base de sharepoint logrando que el primer acceso de los usuarios sea siempre gil.
En nuestro caso, aparte de funcionar para esto, lo que va a realizar es que va a eliminar el error que se presenta, ya que siempre se realizara un primer acceso dentro del mismo server automticamente, lo cual eliminara el error.
Para esto lo primero que tenemos que hacer generar un archivo de nombre WarmUp.ps1 en un folder en C:\script con el siguiente contenido:
function WaitForBrowser{ param ($theBrowser) $maxRetries=20 $retrySeconds=1 $retryCounter=0 while ($theBrowser.Busy -eq $true){ Write-Debug "waiting" if ($retryCounter -gt $maxRetries){ return $false } $retryCounter++ start-sleep $retrySeconds } return $true
Pgina 37
} $username="itesm" $password="Visitant3" $ie=New-Object -ComObject "InternetExplorer.Application" $ie.navigate("http://apoyosposgrados.conacyt.gob.mx/_layouts/FormsAuthenticationLogin/LoginForm.asp x?ReturnUrl=%2f_layouts%2fAuthenticate.aspx%3fSource%3d%252FPaginas%252FPrincipal%252Easpx& Source=%2FPaginas%2FPrincipal%2Easpx") $ie.visible=$true #change to $true to watch the fun! $retryCounter=0 if ((WaitForBrowser $ie ) -eq $false){ return #quit LOG SOMETHING! }else{ $doc=$ie.Document } $txtUsername=$doc.getElementByID("ctl00_PlaceHolderMain_signInControl_UserName") $txtPassword=$doc.getElementByID("ctl00_PlaceHolderMain_signInControl_Password") $btnSubmit=$doc.getElementByID("ctl00_PlaceHolderMain_signInControl_LoginButton")
return #quit - we have to get authenticated or else we can't warmup all sites - LOG SOMETHING! } $web= Get-SPWeb "http://apoyosposgrados.conacyt.gob.mx" $webapp=$web.site.WebApplication foreach ($aSite in $webapp.Sites){ foreach ($aWeb in $aSite.allwebs){ $aWeb.Url $ie.Navigate($aWeb.url) if ((WaitForBrowser $ie ) -eq $false){ Write-Host "----------------" Write-Host "fallo" #LOG SOMETHING! then continue to next site } }
Pgina 38
} $ie.Quit()
Aqu seleccionaramos la opcin de Crear Tarea en el men Acciones, con el nombre IISReset Watcher, seleccionamos las opciones como se ven en la siguiente pantalla:
Pgina 39
Despus en la segunda pestaa, debemos seleccionar un Trigger, es decir, un disparador de la accin que queremos, en este caso sera como sigue:
Ahora elegimos la accin que vamos a realizar, que en nuestro caso sera ejecutar el archivo de powershell que copiamos pasos anteriores. Lo cual se vera de la siguiente manera:
Finalizaramos dando OK en la Tarea para que esta se est ejecutando cada que nuestros servidor realice un IISReset
Pgina 40