Home
Name Modified Size Downloads / Week Status
Totals: 2 Items   24.9 MB 2
openstack-installer-debian7-v1.5.10.tgz 2013-12-24 24.9 MB 11 weekly downloads
README-Spanish.txt 2013-10-21 17.9 kB 11 weekly downloads
INSTALADOR DESATENDIDO (SEMI AUTOMATIZADO) PARA OPENSTACK (GRIZZLY) Reynaldo R. Martinez P. E-Mail: TigerLinux@Gmail.com Caracas, Venezuela. Este instalador fue realizado para automatizar las tareas de creación de una infraestructura de virtualización basada en OpenStack. Hasta el momento, existen dos "sabores" del instalador, uno para Debian 7 y otra para Centos 6. Ambos "sabores" producen esencialmente lo mismo: Un OpenStack completamente utilizable para producción. USO DEL INSTALADOR. Primero: LEA, LEA, LEA y luego de descansar de leer, LEA DE NUEVO !!. Lea todo lo que puede de OpenStack si desea incursionar en el área de virtualización en la nube. Si no le gusta leer, entonces apóyese en alguien que si tenga la disposición para hacerlo, pero no trate de usar este instalador sin tener algún tipo de conocimientos a la mano. Vea el archivo "NOTAS.txt" para entender un poco mas de cuales conocimientos usted debería tener. El sub-mundo de OpenStack engloba varias tecnologías del mundo de Software Libre y del mundo de Redes que deben ser comprendidas muy bien antes de siquiera intentar hacer cualquier instalación de openstack ya sea con esta herramienta de instalación o con cualquier otra. En resumen, si usted no tiene los conocimientos, no lo intente. Adquiera los conocimientos primero, y luego proceda !. Antes de usar el instalador, debe preparar su o sus servidores. De nuevo, en el archivo "NOTAS.txt" hay puntos importantes que deben ser cubiertos antes de iniciar una instalación usando estas herramientas. El instalador hará una serie de validaciones que, en caso de arrojar resultados negativos, hará que aborte el proceso. Segundo: Modifique el archivo de configuración del instalador. El instalador tiene un archivo central de configuración: ./configs/main-config.rc. Dicho archivo está bastante documentado, de manera que si usted hizo "su tarea" y estudió de OpenStack, sabrá que debe modificar en el mismo. Hay cosas muy obvias como "contraseñas", "direcciones IP", "módulos a instalar" y "dominios de dns". En su versión por defecto, el archivo de configuración tiene las selecciones de módulos para instalar lo que se conoce como un "all-in-one" (un servidor monolítico de OpenStack con todos los servicios). Adicionalmente, existen tres módulos que por defecto están en "no": Ceilometer, swift y snmp. En la versión de OpenStack usada por este instalador (grizzly) ceilometer está aun en prueba de concepto. El módulo de swift se puede instalar "si usted realmente va a usarlo". Swift por si solo ya es casi tan extenso como todo OpenStack. Úselo si REALMENTE sabe lo que está haciendo y si REALMENTE lo va a utilizar. El módulo de SNMP instala variables de monitoreo útiles si usted va a monitorear OpenStack vía snmp pero no instala ningún tipo de aplicación de monitoreo. Las variables están descritas (si usted instala el soporte) en el archivo /etc/snmp/snmpd.conf. Si usted desea instalar un "all-in-one", sólo modifique las contraseñas, direcciones IP y dominios de correo y de dhcp/dnsmasq que aparecen en el archivo de configuración. Luego de actualizar su archivo de configuración, ejecute en la raíz del directorio del script el comando siguiente: # ./main-installer.sh install El instalador le preguntará si quiere proceder (y/n). Si ejecuta el instalador con el parámetro adicional "auto", el mismo seguirá de manera automática sin preguntar. Ejemplo: # ./main-installer.sh install auto Usted puede guardar todas las salidas del instalador usando la herramienta "tee". Ejemplo: # ./main-installer.sh install | tee -a /var/log/install-log.log Todo lo que haga y saque a consola el instalador quedará guardado en el archivo "install-log.log" o como haya decidido llamarlo. CASOS TÍPICOS DE INSTALACIÓN En una instalación mas convencional y de producción de OpenStack, usted tendrá "por lo menos" un nodo de control (llamado "controller") y nodos adicionales de computación (llamados "compute"). En tal caso, debe instalar primero el controller. Modifique el archivo de configuración para incluir los módulos que normalmente debe llevar un controller. Específicamente: glance, cinder, quantum, nova, y el dashboard (horizon). Si su nodo de controller va a incluir un servicio de compute (controller + compute), la siguiente variable del archivo de configuración debe estar en "no": nova_without_compute="no" En cambio, si va a instalar un controlador "puro" (sin servicio de compute) coloque la variable en "yes": nova_without_compute="yes" Nodos de compute: Para los nodos de compute, debe dejar en "yes" sólo las variables de instalación de los módulos de nova y quantum. El resto de los módulos (glance, cinder, horizon, etc.) deben estar en "no". Adicionalmente, las siguiente variables en las secciones de nova y quantum deben estar en "yes": nova_in_compute_node="yes" quantum_in_compute_node="yes" Debe colocar las IP's de los servicios de quantum, keystone, glance y cinder según la que tiene el controlador (incluyendo las Ip's del backend de Base de Datos). En cambio, las siguientes variables deben ser colocadas a la IP del nodo de compute: novahost="IP del Nova Compute Host" glancehost="IP del Controlador" cinderhost="IP del controlador" quantumhost="IP del controlador" keystonehost="IP del controlador" messagebrokerhost="IP del controlador" dbbackendhost="IP del controlador o del backend de base de datos" vncserver_controller_address | spiceserver_controller_address = "IP del controlador" BACKEND DE BASE DE DATOS El instalador tiene la posibilidad de instalar y configurar el backend de base de datos, y de crear las bases de datos. Esto es completamente controlable por el archivo de configuración a través de las siguientes variables: dbcreate="yes" dbinstall="yes" dbpopulate="yes" Con estas tres opciones en "yes", se instalará el software de base de datos, se configurará y se crearán las bases de datos, todo con la información contenida en el archivo de configuración. ALERTA: Si usted elige estas opciones, se debe asegurar que no exista previamente software de base de datos instalado o el proceso fallará. Si usted desea "no instalar el software" pero si tiene acceso administrativo completo al backend de base de datos, coloque las siguiente combinación: dbcreate="yes" dbinstall="no" dbpopulate="yes" Con esto, el software de base de datos no será instalado, pero queda de parte de usted (o su DBA) asegurarse que tiene acceso administrativo completo para crear y modificar bases de datos en el backend seleccionado. Si no desea ni instalar ni crear bases de datos (asumimos que ya las tiene previamente creadas) coloque los tres valores en "no": dbcreate="no" dbinstall="no" dbpopulate="no" BACKEND DE MENSAJERÍA (Message Broker) Como parte de los componentes a instalar y configurar, este instalador instala y configura el software para AMQP (el Message Broker). Esto es un paso mandatorio para un controlador o un "all-in-one". Si su o sus servidores ya tienen un messaje broker instalado, pueden ocurrir conflictos que prevengan el correcto funcionamiento de la instalación. SCRIPTS DE AYUDA Este instalador colocará en /usr/local/bin un script de ayuda para poder levantar, bajar, desactivar, activar los servicios de openstack: openstack-control.sh OPCIÓN El script utiliza las siguientes opciones enable: activa los servicios para autoarranque en el boot del servidor. disable: desactiva los servicios para autoarranque en el boot del servidor. start: arranca todos los servicios. stop: detiene todos los servicios. restart: reinicia todos los servicios. status: muestra el estado de todos los servicios. IMPORTANTE: El script "openstack-control.sh" tiene la gran ventaja de subir (o bajar) todos los servicios de openstack en el orden correcto. Tanto los paquetes de debian como los de centos colocan el orden no precisamente "óptimo". Recomendación: colocar lo siguiente en el /etc/rc.d/rc.local del servidor para forzar a que los servicios de OpenStack arranquen en el orden correcto: /usr/local/bin/openstack-control.sh restart NOTA: El script detecta que servicios de OpenStack fueron instalados y configurados por el instalador para iniciar/detener/reiniciar/habilitar/deshabilitar/verificar los servicios correctos en el orden correcto. Adicional a "openstack-control.sh", el instalador copia a /usr/local/bin el script "openstack-log-cleaner.sh". Este script tiene como función limpiar todos los logs de todos los componentes de OpenStack instalados por esta herramienta de instalación. El script es llamado durante la fase final de instalación para limpiar los logs antes de dejar el servidor instalado, pero puede ser utilizado también para limpiar los logs en caso de ser necesario. DNSMASQ El instalador crea una configuración personalizada del componente "dnsmasq" usado por el agente DHCP de Quantum (quantum-dhcp-agent). Dicha configuración incluye un archivo donde usted puede colocar opciones especiales: /etc/dnsmasq-quantum.d/quantum-dnsmasq-extra.conf Hay ejemplos comentados en el archivo. Use esos ejemplos para pasar opciones a las distintas instancias de dnsmasq creadas para cada subred donde usted active la opción de usar "dhcp". Recomendación: Trate de tener una buena estructura de "DNS" para sus máquinas virtuales de manera que las pueda identificar de manera apropiada y utilice las opciones de dnsmasq para agregar o separar subdominios para cada rango de IP's. MODULARIZACIÓN DEL INSTALADOR Si bien el proceso de instalación principal "main-installer" se encarga de llamar a cada módulo de cada componente del instalador, dichos módulos son realmente independientes entre si, al punto de que pueden ser llamados de manera secuencial. No es el caso común, pero puede hacerse. El orden normal de ejecución de cada módulo es el siguiente (asumiendo que todos los componentes serán instalados): requeriments.sh messagebrokerinstall.sh databaseinstall.sh requeriments-extras.sh (sólo presente en el "sabor" de debian 7) keystoneinstall.sh swiftinstall.sh glanceinstall.sh cinderinstall.sh quantuminstall.sh novainstall.sh ceilometerinstall.sh snmpinstall.sh horizoninstall.sh postinstall.sh Si desea ejecutar los módulos en orden sin usar el instalador principal, debe ejecutarlos desde el directorio donde se encuentra el instalador, de la siguiente manera: # ./modules/Modulo-a-ejecutar.sh Todos los módulos leen el archivo de configuración (./configs/main-config.rc) y tomarán las opciones de configuración desde dicho archivo. Cada módulo que se ejecuta de manera exitosa dejará una serie de archivos de control en el directorio siguiente: /etc/openstack-control-script-config Dichos archivos de control son utilizados por los módulos para evitar una re-ejecución de los mismos que pueda causar problemas en la instalación de OpenStack, y también son utilizados por el script "openstack-control.sh" para saber que componentes de OpenStack fueron instalados de manera exitosa y que servicios están instalados para iniciar/detener/reiniciar/etc. RECOMENDACIONES DE INSTALACIÓN PARA CENTOS Y DEBIAN. Centos 6: Instale centos con la selección de paquetes para "Basic Server" (servidor básico). Asegúrese de tener correctamente instalado, configurado y operativo el servicio ntpd. Se recomienda también usar ntpdate. Agregue los repositorios EPEL y RDO (ver "NOTAS.txt"). Instale y configure OpenVSWitch (de nuevo, ver "NOTAS.txt"). Debian 7: Instale debian con la selección de paquetes "Standard System Utilities" (utilitarios de sistema estandard) y con SSH Server (servidor ssh). Asegúrese de tener correctamente instalado, configurado y operativo el servicio ntpd. Se recomienda también usar ntpdate. Agregue el repositorio de OpenStack para Debian y asegúrese de tener las ramas completas para sus repos de debian (ver "NOTAS.txt"). Instale y configure OpenVSWitch (de nuevo, ver "NOTAS.txt"). Cinder: Si va a usar CINDER con lvm-iscsi, asegúrese de tener una partición o disco libre para crear un LVM llamado "cinder-volumes". Ejemplo (disco libre /dev/sdc): pvcreate /dev/sdc vgcreate cinder-volumes /dev/sdc Otro ejemplo con una partición libre /dev/sda3: pvcreate /dev/sda3 vgcreate cinder-volumes /dev/sda3 Swift: Si va a usar swift, recuerde que debe tener el disco/partición de swift montado sobre un directorio específico y este debe ser indicado en la configuración del instalador (main-config.rc). Ejemplo: Variable swiftdevice="d1" En el fstab "d1" debe estar montado así: /dev/sdc1 /srv/node/d1 ext4 acl,user_xattr 0 0 En este ejemplo, se asume que existe ya una partición "/dev/sdc1" previamente formateada en ext4 o cualquier otro sistema de archivos soportado por Linux. También puede usar un recurso NFS. Ejemplo: 192.168.56.1:/exports/nfs_for_swift /srv/node/d1 nfs rw,auto,vers=3,proto=tcp,acl,user_xattr 0 0 Arquitectura: Tanto en debian como en centos, debe elegir utilizar 64 bits (amd64/x86_64). No trate de instalar OpenStack en 32 bits. Servicio NTP: Es VITAL que sus servidores de OpenStack tengan una correcta sincronización de tiempo o habrá serios problemas entre el controller y los nodos de compute. Lea la documentación de OpenStack para saber mas al respecto. RECOMENDACIONES PARA VIRTUALBOX. Usted puede usar este instalador en una VM de VirtualBox si no desea usar un servidor "real" para practicar y aprender OpenStack. Debería tener un "mínimo absoluto" de 2GB's de RAM en su equipo "real" y asignar al menos 900 Mb's de RAM a la VM de VirtualBox, pero si quiere hacer una prueba mas extensa, trate de tener una VM con al menos 4 GB's. Recomendaciones de hardware para una VM de VirtualBox: Discos Duros: Uno para el sistema operativo (16 Gb's mínimo), uno para Cinder-Volumes y otro para swift - espacio variable... mínimo 8GB's para cada disco (switf y cinder-volumes). Red: tres interfaces: - Interfaz 1 en modo NAT para salida a Internet. - Interfaz 2 en modo "host only adapter, promisc: todos", para poder administrar el Servidor OpenStack - sugerencia: Usar vboxnet0 con la red 192.168.56.0/24 (desactivar el dhcp de virtualbox) y asignarle la IP 192.168.56.2 a la interfaz (la .1 estará en la máquina real). - Interfaz 3 en modo "host only adapter, promiscq:q: todos", para poder asignar a las VM's de OpenStack la red en la interfaz eth2 y el rango IP 192.168.57.0/24 (la IP 192.168.57.1 estará en la máquina real). Hacer la instalación del S/O de 64 bits de su preferencia. Agregar los repositorios y soporte ntp según las recomendaciones en este documento, crear el switch de OpenVSWITCH br-int, crear el switch de OpenVSWITCH br-eth2 y agregarle el puerto eth2 (la interfaz 3 en la VM de VirtualBox). Crear el volumen de cinder contra el segundo disco duro de la VM de virtualbox: pvcreate /dev/sdb vgcreate cinder-volumes /dev/sdb Si va a usar swift, crear la partición en el tercer disco (/dev/sdc1) y montarla según las notas en este documento. Hacer la instalación indicando que el Mapping de bridge (dentro de main-config.rc) es: bridge_mappings="publica:br-eth2" Cambiar la IP en el main-config.rc a la IP asignada a la VM en la red 192.168.57.0/24. Ejecutar el instalador. Disfrutar de OpenStack :-) Usted podrá entrar al servidor vía web por la interfaz 192.168.56.x para ejecutar las tareas de administración de OpenStack. Creé su subred en el rango de eth2 (192.168.57.0/24) y podrá entrar a las VM's de OpenStack desde su máquina real que tendrá la interfaz 192.168.57.1. DESINSTALACIÓN El script principal tiene también un parámetro que llama al módulo de desinstalación: # ./main-installer.sh uninstall o # ./main-installer.sh uninstall auto La primera forma de llama al proceso de desinstalación, preguntará "y/n" para proseguir o abortar, pero al ser llamado con el parámetro extra "auto", no habrá preguntas y todo lo que el instalador instaló será eliminado del servidor. Es importante tener en cuenta que si se utilizó la opción dbinstall="yes", el desinstalador eliminará no solamente el manejador de base de datos sino también las bases de datos creadas. Si usted desea NO ELIMINAR las bases de datos creadas, modifique el "main-config.rc" y coloque la opción dbinstall="no". Esto hará que el desinstalador no elimine ni el manejador de base de datos ni las bases de datos creadas. Esto es muy conveniente para una reinstalación. Si por alguna razón su instalación de OpenStack requiere ser reconstruida sin tocar las bases de datos o el manejador, desinstale usando dbinstall="no", y cuando vaya a reinstalar, coloque todas las opciones de base de datos en "no" para conservar tanto el manejador como las bases de datos y data creada: dbcreate="no" dbinstall="no" dbpopulate="no" Si su instalación tiene múltiples nodos (controller / compute) use los archivos "main-config.rc" con los que instaló cada nodo para la desinstalación del nodo correspondiente. GOODIES En el directorio "Goodies" usted podrá encontrar algunos scripts (cada uno con su respectivo readme) que puede utilizar con su instalación de OpenStack. Vea los scripts y sus respectivos "readmes" para entender mejor como usarlos !. NOTAS FINALES Este instalador fue orientado inicialmente al modelo de red flat/vlan's con router externos donde el módulo de red (Quantum) no canalizará tráfico (sólo manejará los recursos de puertos de ovs y lbaas y levantará las configuraciones necesarias). En este modelo, quantum "no se convierte" en un posible cuello de botella para el tráfico de red. Sin embargo, usted "si tiene los conocimientos de configuración de openstack" puede adaptar la configuración y/o los módulos a sus necesidades en caso de querer utilizar el modelo de tunneling o cualquier otra configuración de Quantum que requiera. FIN.-
Source: README-Spanish.txt, updated 2013-10-21