| Manual
para Principante en DotNetNuke (Parte 1) |
En este tutorial veremos principios básicos sobre
la utilización del gestor de portales de contenidos DotNetNuke.
Vamos a comenzar un paso a paso siguiendo todo lo necesario para
tenerlo instalado y funcionando en nuestra maquina. Luego veremos
cómo editar los skins que este nos provee, agregar un poco de
contenido y por ultimo como llevar nuestro sitio de desarrollo a
producción, esto en futuras entregas.
Que es DotNetNuke
DNN es un portal de contenidos (o bien CMS, Content Management
System), que nos permitirá en cuestión de minutos tener un sitio
listo y funcionando. DNN es escalable, lo que quiere decir que puede
ser extendido en funcionalidad por módulos, muchos de los cuales son
mantenidos por personas desinteresadas que comparten la filosofía
open-source en la que se basa DNN, otros sin embargo, son pagos. Hay
módulos para un sinfín de funciones, desde foros, blogs, wikis, para
ver usuarios registrados, estadísticas, traducciones, etc.
Además DNN es multilenguaje, lo que nos permitirá que nuestros
sitios lleguen a un público mucho más amplio, dentro y fuera del
país; en la página oficial hay paquetes de lenguajes para descargar.
Como si esto fuera poco DNN permite el uso de skins, para
personalizar nuestro sitio a más no poder.
Todo esto, gratis. DNN es open-source, por lo que es una alternativa
más que interesante.
Quizás su única desventaja es la necesidad de la utilización de un
motor SQL Server, 2000 o 2005; y no todos los módulos que hacen uso
de Base de Datos son compatibles con ambos motores.
En este tutorial veremos la versión 4.5.5 que fue la última al
momento de realizar este documento.
Sin más, comencemos con la instalación.
En este documento se asume que el usuario
posee alguna versión de Windows que permita correr Internet
Information Servicies (IIS), también un motor de SQL Server 2000
corriendo y la versión 2.0 del Framework .NET.
Este documento no entrara en detalles técnicos sobre programación,
ya que pretende ser un tutorial para aquellos que quieran iniciarse
en el mundo de DNN, quizás más adelante veamos cómo crear módulos
nosotros mismos con los templates que DNN ofrece.
1.1 Imágen de un sitio recién instalado
Instalando DNN 4.5.5
Primero que nada será necesario
descargar la última versión disponible (4.5.5 al momento de hacer
este documento); por lo que nos dirigiremos a la página oficial
alojada en
http://www.dotnetnuke.com y procederemos a la descarga. Vale la
pena recalcar que es necesario estar registrado en la página para
poder acceder a la sección de descargas.
Una vez descargado procederemos a descomprimir el contenido del
archivo, tenemos dos opciones; la primera y recomendada es
directamente descomprimirlo en un directorio dentro de C:\Inetpub\wwwroot,
el nombre del directorio podría ser DNN, eso queda a elección de
ustedes; la segunda opción y menos recomendada es descomprimir el
contenido en otro lado de nuestro disco y luego hacer que IIS apunte
a ese directorio; no la recomiendo ya que por una cuestión de orden
es mejor agrupar los sitios dentro de la estructura que provee IIS.
Una vez que hayamos descomprimido el contenido veremos una imagen
como la que sigue:
1.2 Contenido del directorio DNN dentro de wwwroot
Ahora procederemos a crear la aplicación en IIS,
para ello abrimos Panel de Control -> Herramientas administrativas
-> Servicios de Internet Information Server. Hacemos clic en el
signo “+” al lado de Sitios Web, y lo mismo con el sitio web
predeterminado, como se muestra a continuación:
Seleccionamos el directorio DNN y hacemos clic
derecho en él y luego clic en Propiedades:
Lo que
hemos abierto son las propiedades del directorio DNN, aquí es donde
crearemos la aplicación para que pueda ser accedida por nuestro
navegador de internet, a continuación hacemos clic en Crear dentro
de la solapa Directorio, como se muestra a continuación:
A continuación hagamos click en
la solapa ASP.NET y verifiquemos que aparece como se muestra a en la
siguiente imagen:
Una vez hecho eso trataremos de
acceder al sitio, para ello abramos nuestro navegador favorito y
tipiemos http://localhost/DNN y veamos que sucede.
¿Qué
paso?, pasó que hubo un error y DNN se encarga de mostrarlo de una
manera muy amigable, ¿por qué? Porque si un visitante viera la
horrible pagina amarrilla y blanca de un error de asp.net quizás
huiría horrorizado; en cambio de esta forma se avisa que el sitio no
está disponible y que por favor intente mas tarde.
Lo que
paso fue que el procedimiento de instalación aun no finalizo, quedan
3 pasos aun; crear una base de datos en SQL Server, cambiar el
archivo web.config para que apunte a nuestra Base de Datos y asignar
ciertos permisos a la carpeta donde se encuentra DNN.
1 -
Creando la Base de Datos
Abrimos el
Administrador Corporativo de SQL Server, hacemos clic en el símbolo
“+” de nuestro servidor y a continuación clic derecho sobre “Bases
de Datos” y luego un clic mas sobre “Crear nueva base de datos”:
Una vez que hayamos hecho
clic veremos una ventana como la que sigue:
Allí
pondremos como nombre de nuestra base de datos “DotNetNuke”,
obviamente no es necesario utilizar ese nombre, pero en este
documento haremos referencia a él, así que si no lo utilizan tengan
en cuenta cambiarlo por el que Uds. usan cada vez que se lo nombre.
Hacemos
clic en el botón aceptar y listo, creamos la base de datos. A
continuación crearemos un Login para la base de datos, para ello
iremos a “Seguridad -> Inicios de Sesión”, haremos clic derecho y
luego clic en “Nuevo Inicio de Sesión”:
La ventana siguiente se
mostrara, donde deberemos escribir un usuario (DNN), una contraseña
(DNN) y seleccionar la base de datos para este login:
De paso en la solapa
“Acceso a Base de Datos” pondremos lo que figura a continuación:
Luego solo haremos clic en
el botón Aceptar.
Solo por
curiosidad veamos que sucede ahora cuando queramos entrar a nuestro
sitio, abramos nuestro navegador y nuevamente pongamos
http://localhost/DNN.
Umm nuevamente un error,
pero esta vez debido a que la base de datos aun no fue configurada
en el archivo web.config.
2 – Editando el
archivo web.config
Vayamos
donde se encuentra instalado DNN, veremos que en el directorio raíz
se encuentra un archivo llamado web.config. Procedamos a abrirlo con
el bloc de notas u otro editor. En mi caso Notepad++.
Una vez abierto veremos
muchas cosas, pero solo necesitamos buscar la sección en donde está
la cadena de conexión, y es justamente
donde en la imagen que sigue aparece marcado en rojo:
Alli deberemos quitar
donde dice (esas líneas comentarlas o quitarlas):
<!-- Connection String for
SQL Server 2005 Express -->
<add name="SiteSqlServer" connectionString="Data Source=.\SQLExpress;Integrated
Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"
providerName="System.Data.SqlClient"
/>
Y deberemos des
comentar donde dice:
<!-- Connection String for
SQL Server 2000/2005
<add name="SiteSqlServer" connectionString="Server=(local);Database=DotNetNuke;uid=;pwd=;"
providerName="System.Data.SqlClient" /> -->
Es decir que quedaría:
<!-- Connection String for
SQL Server 2000/2005 -->
<add name="SiteSqlServer" connectionString="Server=(local);Database=DotNetNuke;uid=;pwd=;"
providerName="System.Data.SqlClient"
/>
A continuación editamos
esa línea y reemplazamos, donde dice “Server” dejaremos (local) ya
que es la instancia por defecto de SQL Server, si ustedes quieren
poner un nombre no hay problema. Donde dice “Database” dejaremos
DotNetNuke ya que así llamamos a nuestra Base de Datos, en uid
pondremos el usuario que creamos en SQL Server, es decir que
quedaría uid=DNN
y en pwd pondremos el password, o sea
pwd=DNN.
Solo nos queda editar
en un lugar más, dentro de la sección <appSettings>, la línea en
rojo eliminarla y la línea en verde editarla para que quede igual
como sale abajo:
<!--
Connection String for SQL Server 2005 Express - kept for backwards
compatability - legacy modules -->
<add
key="SiteSqlServer" value="Data Source=.\SQLExpress;Integrated
Security=True;User Instance=True;AttachDBFilename=|DataDirectory|Database.mdf;"/>
<!--
Connection String for SQL Server 2000/2005 - kept for backwards
compatability - legacy modules -->
<add
key="SiteSqlServer" value="Server=(local);Database=DotNetNuke;uid=DNN;pwd=DNN;"/>
Ahora simplemente
guardamos nuestro archivo, y volvemos a probar con el navegador.
Nuevamente un error, en este caso porque aun nos falta el último
paso. Configurar los permisos a la carpeta donde se encuentra DNN.
Ese mensaje de error lo da en IE, en Fire Fox es muy probable que
veamos un mensaje de error menos descriptivo:
Pero no se preocupen,
en el paso siguiente lo solucionaremos.
3 – Configurando
permisos de carpeta
Antes
que nada, si tenemos Windows XP hay que deshabilitar “Utilizar uso
compartido simple de archivos”, desde el menú Herramientas->Opciones
de carpeta->Solapa Ver en el explorador de Windows.
Una vez
hecho eso hay que dirigirse donde instalamos DNN, en “C:\Inetpub\wwwroot\DNN”
y hacer clic derecho sobre “DNN”, luego en “Compartir y Seguridad”:
Una vez allí deberemos
asignar permisos de escritura al usuario ASPNET, para ello haremos
como se muestra a continuación:
Vamos a
la solapa Seguridad, de ahí hacemos clic en el botón “Agregar”,
luego en la ventana “Seleccionar Usuarios o Grupos” escribimos
“ASPNET” (sin las comillas) y a continuación hacemos clic en
“Comprobar nombres”. Luego hacemos clic en el botón Aceptar, y le
damos al usuario ASPNET permisos para Modificar como se muestra a
continuación:
Probemos nuevamente en
nuestro navegador…
¡Éxito!, DNN está listo para comenzar con el proceso de creación de
las tablas de la Base De Datos y creación de usuarios. Lo que sigue
a continuación es muy sencillo, y es un Next->Next->Finish, pero
igual lo veremos.
Comenzando la verdadera instalación
Todo lo
anterior que hicimos fue solamente la puesta a punto del sitio,
ahora queda que la Base de Datos se llene con las tablas necesarias.
Para ello en la pantalla que aparece dejaremos seleccionado como
método de instalación: Típica, a continuación hacemos clic en “Next”.
En esta pantalla se
probaran los permisos en la carpeta DNN, si hacemos clic en “Test
Permissions” veremos algo así:
A continuación damos “Next”:
En esta
pantalla vemos lo referido a la conexión de Base de Datos, lo mejor
es dejar los campos como están ya que los tomo del web.config, y son
los datos que nosotros ingresamos en ese archivo. Si hacemos clic
en “Test Database Connection” veremos lo siguiente:
Nuevamente clic en “Next”:
En esta
etapa es donde DNN comienza con la instalación de la Base de Datos,
una vez finalizado veremos lo siguiente:
A
continuación se comenzara con la creación de los usuarios para el
portal y sus sitios (si, DNN es multi portal):
En este
caso se requiere los datos de la cuenta del súper usuario, aquel
denominado host, llenar todos los campos y dar clic en “Next”, a
continuación se piden los datos para el administrador, el
administrador se corresponde a un portal, en cambio el host se
corresponde a todo, sin restricciones de portales.
Nuevamente llenar los
datos, y hacer clic en “Next”:
¡FELICITACIONES! Ya
estamos listos para acceder a nuestro primer portal, hacemos clic en
“Finished” y veamos que pasa:
¡Sí!, nuestro sitio
funcionando, entremos…:
Bueno ya estamos listos
para empezar con la travesía, hay mucho camino por recorrer aún.
Espero que este tutorial paso a paso de una instalación de DNN les
haya servido y lo tengan para referencia cada vez que vayan a
instalarlo, un fuerte abrazo desde la ciudad de Córdoba, Argentina.-
Maximiliano Santa Cruz.
Nombre
Maximiliano Santa Cruz
Ubicación Cordoba -
Argentina
Actualmente estoy
estudiando ingeniería en sistemas, cada vez falta menos :P y
trabajo en una empresa que desarrolla software para el
mantenimiento de aviones.
Programo en C#, VB.NET, ASP.NET, Action Script 3, Flex, AIR
(ex Apollo), HTML, XML, XSL y SQL. Tambien manejo SQL Server
2000/2005, AJAX y estoy dando mis primeros pasos (aún) con
Managed Direct X y XNA.
Me gusta escribir aplicaciones que luego puedo distribuir a
mis amigos, como asi tambien utilitarios para facilitar las
tareas de desarrollo, soy fánatico del anime y los video
juegos y me aburren los desarrollos para software
"administrativo".
|
| 
Descarga
desde nuestra exclusiva sección de códigos fuente, todas las
aplicaciones que desees y utiliza ese código en tus aplicaciones
para dotarlas de la mayor versatilidad posible.
Accede
a nuestra sección de Notas Técnicas, escritas por nuestro Staff y
por otros prestigiosos colaboradores. Notas sobre informática en
General, VB.NET, C#, y Hardware. Conviertete tu también en NOTERO de
VB-MUNDO y gánate tu propia sección y un link (no reciproco) hasta
tu sitio web. Deseas escribir para nosotros ?