Changeset 96f4707 in sicp for README.md

Timestamp:

Jun 25, 2015, 9:43:41 AM (9 years ago)

Author:

Ing. Roldan D. Vargas G <rvargas@…>

Branches:

master

Children:

87fca9d

Parents:

c6bbc4d

Message:

modificaciones en el README.md con detalles del sistema e instalación del mismo

File:

• README.md (modified) (2 diffs)

README.md

@@ -5 +5 @@
 ## Simulador Integral de Cadenas Productivas
 
+       _____ ______________
+      / ___//  _/ ____/ __ \
+      \__ \ / // /   / /_/ /
+     ___/ // // /___/ ____/
+    /____/___/\____/_/
+
+
+
+
 El __Simulador Integral de Cadenas Productivas (SICP)__ le permite modelar y simular las cadenas productivas desde
-distintas fuentes de datos como son: El [Sistema de Gestión para la Industria y Comercio (SIGESIC)](https://sigesic.mppi.gob.ve/),
-La [Encuesta Industrial](http://www.ine.gob.ve/index.php?option=com_content&id=347&Itemid=36&view=article) y la
-[Matriz Insumo / Producto](http://www.bcv.org.ve/cuadros/series/mip97/mip97.asp?id=425), con el objetivo de suministrar
+distintas fuentes de datos como son: El [Sistema de Gestión para la Industria y Comercio (SIGESIC)]
+(https://sigesic.mppi.gob.ve/), La [Encuesta Industrial]
+(http://www.ine.gob.ve/index.php?option=com_content&id=347&Itemid=36&view=article) y la [Matriz Insumo / Producto]
+(http://www.bcv.org.ve/cuadros/series/mip97/mip97.asp?id=425), con el objetivo de suministrar
 información sistematizada acerca de la estructura industrial del pais y las características (flujo de entrada y salida
 de bienes) de un sector productivo y/o empresa en particular.
@@ -28 +38 @@
 Para el correcto funcionamiento del __SICP__ se requiere tener instalado previamente los siguientes paquetes:
 
-* Python >= 2.7 < 3.0
-* Django >= 1.8 < 1.9
-* django-suit == 0.2.13
-* Pillow >= 2.8.1
-* django-simple-captcha >= 0.4.5
-* psycopg2 >= 2.6
-
+    // Paquetes del Sistema Operativo
+    PostgreSQL 9.x
+    Python >= 2.7 < 3.0
+    PIP >= 1.5.4
+    
+    // Paquetes de Python
+    Django >= 1.8 < 1.9
+    django-suit == 0.2.13
+    Pillow >= 2.8.1
+    django-simple-captcha >= 0.4.5
+    psycopg2 >= 2.6
+    
 ## Proceso de instalación
 
+En el proceso de instalación sobre los requerimientos y herramientas necesarias para el correcto funcionamiento del 
+sistema, se deben ejecutar algunas instrucciones desde la consola de comando para lo cual se requiere abrir una terminal 
+y ejecutar los siguientes comandos:
+
+    // Para distribuciones ubuntu
+    ~$ sudo su -
+    
+    // Para distribuciones debian
+    ~$ su -
+    
+Lo anterior solicitara la contraseña de administrador del sistema operativo para acceder al usuario root, esto es 
+necesario para los procesos de instalación posteriores de la aplicación.
+
+Una vez autenticados como usuario root del sistema operativo, mostrará en la consola el símbolo "#" que identifica que 
+el usuario actual es root, esto permitirá instalar en el sistema operativo los requerimientos de funcionamiento del 
+sistema para lo cual se ejecutarán los comandos detallados a continuación:
+
+    // Instalación de paquetes del sistema operativo
+    ~# apt-get install postgresql python2.7 python-pip
+    
+    // Instalación de paquetes de python (se debe acceder a la ruta principal del proyecto sicp)
+    ~# pip install -r requerimientos/comun.txt
+    
+Esto ejecutara los distintos procesos de instalación sobre los requerimientos del sistema.
+
+Posteriormente se debe crear la base de datos del __SICP__ y el correspondiente usuario que tendrá los privilegios 
+necesarios para interactuar con la misa, esto se hace de la siguiente forma:
+
+    // Acceso al usuario postgres
+    ~# su postgres
+    
+    // Acceso a la interfaz de comandos de postgresql
+    postgres@xxx:$ psql template1 
+    
+    // Creación del usuario de a base de datos
+    temlate1=# CREATE USER nombre_usuario_bd WITH ENCRYPTED PASSWORD 'contraseña' createdb;
+    temlate1=# \q
+    
+    // Desautenticar el usuario postgres y regresar al usuario root
+    postgres@xxx:$ exit
+    
+    // Creación de la base de datos
+    ~# createdb nombre_bd -E 'UTF-8' -O nombre_usuario_bd -h localhost -p 5432 -U nombre_usuario_bd
+    
+    // Salir del usuario root
+    ~# exit
+    
+
+## Configuración y ejecución de la aplicación
+
+Una vez instalados todos los requerimientos previos del sistema, se procede a la configuración del mismo, para esto se 
+debe editar el archivo settings.py dentro de la carpeta sicp y modificar los datos por defecto de la variable DATABASES, 
+en donde se especificarán los datos de acceso a las bases de datos de la aplicación y del sigesic.
+
+Para ejecutar la aplicación en modo de desarrollo, se debe ejecutar el siguiente comando:
+
+    ~$ python manage.py runserver
+    
+Lo anterior ejecutará el servidor de desarrollo de django bajo la URL [http://localhost:8000](http://localhost:8000), 
+para lo cual deberemos acceder a un navegador web y escribir dicha dirección URL.