Descarga e Instalación
Para descargar Jokte! CMS lo puedes hacer a través del Sitio http://jokte.org o a través del repositorio oficial hosteado en GitHub mediante Git.
El paquete descargable puede estar disponible en los formatos .zip y .tar.gz permitiéndote utilizar cualquier herramienta de descompresión de archivos.
Ejemplo de desempaquetamiento con el comando unzip, desde la terminal de comandos
$ unzip Jokte-cms-v1.1.zip
Hay que tener en cuenta que los archivos del paquete, se extraen dentro del directorio en el cual nos encontremos, este directorio podrá ser el DocumentRoot de nuestro servidor web, o un subdirectorio si en nuestro servidor tenemos varias aplicaciones en producción.
$ unzip Jokte-cms-v1.1.zip -d MiNuevoSitio
Ejemplo de desempaquetamiento con el comando tar, desde la terminal de comandos
$ tar xvfz Jokte-cms-v1.1.tar.gz
o
$ tar xvfz Jokte-cms-v1.1.tar.gz --directory MiNuevoSitio
Puedes obtener el código fuente clonando el repositorio desde alguno de los branches existentes en GitHub, el código más estable se encuentra en el branch master el cual se puede descargar a través del siguiente comando
$ git clone https://github.com/JokteLatinoamerica/jokte-cms.git
Esta instrucción creará un nuevo directorio dentro de nuestro DocumentRoot con el nombre de jokte-cms. Así mismo podemos descargar la última versión de desarrollo con git mediante el siguiente comando
$ git clone https://github.com/JokteLatinoamerica/jokte-cms.git -b development
Problemas con los permisos de escritura en el instalador
Regularmente cuando utilizamos un servidor web como Apache, lo hacemos a través de XAMPP el cual es útil para despliegues en ambientes locales para testing o desarrollo de la aplicación. Según la documentación de XAMPP, la instalación del servidor web se hace en el directorio /opt/lampp como super usuario, esto trae como consecuencia que al instalar Jokte! los archivos de configuración no sean escribibles obligándonos a cambiar los permisos manualmente. La solución más rápida a la que acudimos es cambiando los permisos de lectura, escritura y ejecución recursivamente al directorio de la aplicación, o asignando nuestro usuario y grupo al que pertenecemos dentro del sistema como propietario del arbol de directorios en donde se encuentran los archivos de Jokte!
Lo anterior lo hacemos a través del comando
# chmod -R 777 MiNuevoSitio
o
# chown -R usuario:grupo MiNuevoSitio
Cambiar los permisos a 777 hará que nuestra aplicación tenga problemas de seguridad
Si aun persisten los problemas con los permisos es recomendable modificar la configuración del servidor web en /opt/lampp/etc/httpd.conf, primero asignando nuestro usuario y grupo al cual pertenecemos en las líneas correspondientes
User usuario
Group grupo
Luego descomentando la siguiente línea dentro del archivo de configuración del servidor web
Include etc/extra/httpd-vhosts.conf
y definiendo el virtual host en /opt/lampp/etc/extra/httpd-vhosts.conf de la siguiente manera
<VirtualHost *:80>
ServerAdmin [email protected]
DocumentRoot "/home/MiUsuario/SitiosWeb/jokte-cms"
ServerName jokte-cms.local
<Directory /home/MiUsuario/SitiosWeb/jokte-cms>
DirectoryIndex index.html index.php
Options Indexes FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>
Esta configuración requiere que creemos un directorio llamado SitiosWeb dentro de nuestro home, luego dentro de el clonamos Jokte! desde GitHub o desempaquetamos el tarball o .zip dentro del directorio jokte-cms
$ mkdir SitiosWeb
$ cd SitiosWeb
Luego de implementar esta configuración en nuestro servidor web, debemos apuntar nuestro localhost al nombre del servidor jokte-cms.local. Para esto, debemos editar el archivo /etc/hosts como super usuario y agregamos la siguiente línea
127.0.0.1 jokte-cms.local
No olvidemos iniciar o reiniciar el servidor web
$ sudo /opt/lampp/lampp start
$ sudo /opt/lampp/lampp restart
Ahora desde nuestro navegador web accedemos a la Instalación de Jokte! mediante el nombre de dominio asignado como ServerName http://jokte-cms.local
