Manual rápido para la instalación de JAWS 0.2 ============================================= David Moreno Garza http://www.damog.net Introducción. Este documento intenta ser un punto de partida para realizar una instalación de JAWS exitosa. 1. Empezando. Lo primero es obtener el código fuente del programa. JAWS está hosteado en SourceForge, por lo cual el código fuente se encuentra en diferentes mirrors. Al momento de escribir este manual, la versión más reciente de JAWS es la 0.2. El código puede obtenerse en: http://prdownloads.sourceforge.net/jaws-project/jaws-project.0.2.tar.gz?download De ahí obtenemos nuestra bonita bola tar 'jaws-project.0.2.tar.gz'. 2. Desempaquetando. Lo siguiente es colocar nuestro paquete de JAWS en el directorio donde querramos poner nuestro blog. En mi caso: $ cp jaws-project.0.2.tar.gz /home/damogar/public_html Ahora hay que desempaquetarlo: $ cd /home/damogar/public_html $ tar xzvf jaws-project.0.2.tar.gz Esto nos desplegará todos los archivos y directorios que contiene JAWS, todos dentro del directorio principal jaws-project.0.2/: $ cd jaws-project.0.2 $ ls AUTHORS COPYING INSTALL NEWS README THANKS TODO html sql $ En este punto distinguen dos directorios muy importantes: html/ y sql/. El primero contiene todo el código PHP, imágenes y todo lo que conforma JAWS; sql/ contiene un sólo archivo: el guión SQL para llenar la base de datos. Eso lo haremos más adelante. 3. Base de datos. Obviamente, JAWS necesita de una base de datos MySQL para almacenar la información. Si tú eres 'root' de MySQL en el sistema, habrá que crearla. De otro modo, tienes que pedir al administrador que lo haga. La creación de la base de datos y la creación del usuario de la base es un proceso bastante sencillo que causa muchos problemas a gente no familiarizada con MySQL y SQL en general. Primero, nos conectamos al monitor de MySQL, como el usuario root: $ mysql -u root -p Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 1 to server version: 3.23.57 Type 'help;' or '\h' for help. Type '\c' to clear the buffer. mysql> A continuación creamos la base de datos, la cual llamaremos 'jaws': mysql> create database jaws; Query OK, 1 row affected (0.07 sec) Ahora creamos un usuario de MySQL (el mío se llamará 'damogar' y su password será 'MiPassword') que tendrá acceso a la base: mysql> GRANT ALL PRIVILEGES on jaws.* to damogar@localhost identified by 'MiPassword'; Query OK, 0 rows affected (0.01 sec) Y listo, es todo por el momento con la base de datos. Nos salimos del monitor simplemente teclando CTRL+D (^D). Sólamente nos falta editar un par de archivos. 4. Editando jaws.sql. Con tu editor favorito, abre para edición el archivo sql/jaws.sql: $ emacs sql/jaws.sql Aquí tenemos que editar la línea 275 que por default aparece así: INSERT INTO jaws_user values (1,'jawsadmin','jawsadmin@localhost','First Name','Last Name',password('qwerty')); Cambia 'jawsadmin' por el login que desees que use JAWS para autenticar al administrador del blog (yo pondré 'damogar'). También hay que cambiar 'jawsadmin@localhost' por el correo electrónico del administrador (yo pondré 'damog@damog.net'). 'First Name' y 'Last Name' debe ser cambiado por el nombre y apellido también del administrador (yo pondré 'David' y 'Moreno'). Y por último hay que cambiar el password 'querty' por el password que deseamos que tenga nuestro login (pondré 'MiPassword'). Nota: Los datos de login y password no tienen que ser forzosamente los mismos que introdujimos hace rato en la base de datos. Es todo lo que haremos con jaws.sql. Guarda el archivo. Ahora vamos a vaciar ese archivo SQL en la base de datos siguiendo esta sencilla sintaxis: $ mysql -u usuario -p base_de_datos < sql/jaws.sql En mi caso, sería así: $ mysql -u damogar -p jaws < sql/jaws.sql Password: $ Y listo, en la base de datos se crean todas las tablas que contiene jaws.sql y se insertan los datos necesarios. 5. Editando config.php. En config.php debemos indicarle a JAWS los datos de la base de datos. Lo abrimos para edición: $ emacs html/include/config.php Aquí editaremos varias líneas. La línea 19 dice: $GLOBALS["path"] = "#path#"; Sustituiremos "#path#" por "./", el cual es la ruta en la que se encuentra JAWS. Usuarios avanzados querrán adaptar el path a otro directorio, pero para efectos de una instalación normal, simplemente lo cambiamos a "./", para que nuestra línea quede así: $GLOBALS["path"] = "./"; Ahora editaremos de la línea 34 a la 37: $db_user = "#dbuser#"; $db_password = "#dbpassword#"; $db_name = "#dbname#"; $db_host = "#host#"; Aquí tenemos que introducir nuestros datos de la base de datos que creamos hace un rato: $db_user = "damogar"; $db_password = "MiPassword"; $db_name = "jaws"; $db_host = "localhost"; Si tú no creaste la base de datos, pide al administrador de tu sistema que te proporcione la información necesaria para hacer la conexión a MySQL. 6. Finalizando En este punto ya está listo nuestro blog, ya podemos entrar a ver la portada principal. En mi caso, debido a que puse todo dentro de /home/damogar/public_html, para ver la portada del blog la ruta sería: http://www.servidor.com/~damogar/jaws-project.0.2/html Ahí se desplegaría el index.php de nuestra portada. Un simple movimiento de archivos llevará mis archivos a mi raíz de web: $ cd /home/damogar/public_html $ cp -R jaws-project.0.2/html/* . Y listo, ello sería para copiar todos los contenidos del directorio html/ a mi raíz de documentos: http://www.servidor.com/~damogar ;-) Y para entrar al panel de control simplemente apunto mi navegador hacia: http://www.servidor.com/~damogar/admin.php, e introduzco el login y password que anteriormente edité en el archivo jaws.sql. Y eso es todo ;-)