Instalación_GECOSCC

David Clavain edited this page Mar 31, 2016 · 6 revisions

Instalación de GECOS CC

El proceso de instalación de GECOS Centro de Control se ha probado en CentOS 6.5. Recuerde que la máquina debe tener unos requisitos mínimos.

Despliegue de GECOS CC

Tras instalar CentOS 6.5 minimal, el despliegue de GECOS CC se realiza casi en su totalidad de forma automática con un script. Siga los pasos que se indican:

  • Paso 1: Descargue CentOS 6.5 minimal (Mirror CICA)
  • Paso 2: Instale CentOS 6.5 minimal en la máquina que vaya a ser el servidor. Recuerde configurar la red durante la instalación.
  • Paso 3: Tras la instalación y el reinicio, ejecute los siguientes comandos como root para comprobar que las herramientas mínimas están presentes:
    • yum update
    • yum install wget curl which tar
  • Paso 4: Inicie la instalación de todo el entorno con el script automático, usando el siguiente comando como root: wget https://raw.githubusercontent.com/gecos-team/gecoscc-chef-server-repo/master/scripts/gecoscc-chef-server-install.sh -O - | bash
    • (también puede usar curl -L, en vez de wget)

El proceso durará unos minutos. Esto dejará configurado e iniciado (incluso tras reiniciar) en la máquina un chef-server en https://localhost:443/ y gecoscc-ui en http://localhost:80/. En la siguiente sección se crea un usuario administrador, se añaden a gecoscc-ui las políticas y otros datos necesarios.

Nota: Si durante la ejecución del script hay un error al reiniciar nginx, vuelva a ejecutar dicho script y continuará por donde lo dejó.

Inicialización

Es posible que tras la instalación tenga que realizar algunas acciones para inicializar GECOS Centro de Control, como creación de un administrador, importación de políticas y quizás otros datos. A continuación se explican.

Nota: para facilitar las siguientes acciones guarde la ruta a su instalación de gecoscc-ui en la variable de entorno GECOSCC_HOME. Ejecute el comando export GECOSCC_HOME=/opt/gecosccui-2.X.X indicando su versión de gecoscc-ui.

Roles de administrador

Existen varios roles de administrador que trabajan con GECOS Centro de Control. Cree los que considere necesarios:

  • Superadministrador: posee todos los privilegios, puede crear otros administradores desde la interfaz y asignarles unidades organizativas. Puede crearlo con el siguiente comando (nótese la opción -s de superusuario).
    • $GECOSCC_HOME/bin/pmanage $GECOSCC_HOME/gecoscc.ini create_chef_administrator -u nuevo_admin -e nuevo_admin@domain.com -a admin -s -k /etc/chef-server/admin.pem -n
  • Administrador (tipo I): puede controlar las unidades organizativas que le haya asignado un superadministrador y aplicar políticas.
  • Administrador (tipo II): puede vincular puestos de trabajo al servidor GECOS a través del Asistente de Configuración de GECOS (pero no controla los puestos desde la interfaz).

El superadministrador puede crear estos tres tipos de administradores desde la interfaz de GECOS Centro de Control.

Importación de políticas

Para importar las políticas existentes en chef-server haga lo siguiente:

* <code>$GECOSCC_HOME/bin/pmanage $GECOSCC_HOME/gecoscc.ini import_policies -a admin -k /etc/chef-server/admin.pem</code>

Nota: Este paso debe realizarse al actualizar la versión de gecosscc-ui y al añadir o modificar recetas en el chef-server.

Actualización de la lista de modelos de impresoras

Para actualizar la lista de impresoras, necesaria para activar el autocompletado de marca y modelo, haga lo siguiente:

* <code>$GECOSCC_HOME/bin/pmanage $GECOSCC_HOME/gecoscc.ini update_printers</code>

Nota: Este paso debe ejecutarse periódicamente para añadir o eliminar nuevos modelos de impresoras.

Actualización de la lista de paquetes

Para actualizar la lista de paquetes que se encuentran en los repositorios, necesaria para activar el autocompletado en la política de instalación de paquetes, haga lo siguiente:

Nota: Este paso puede tardar varios minutos en ejecutarse.

* <code>$GECOSCC_HOME/bin/pmanage $GECOSCC_HOME/gecoscc.ini synchronize_repositories</code>

Nota: Este paso debe ejecutarse al añadir o eliminar repositorios del archivo de configuración $GECOSCC_HOME/gecoscc.ini.

Actualización de los perfiles de software

Los perfiles de software disponibles en la aplicación se definen en el archivo de configuración del centro de control de GECOS $GECOSCC_HOME/gecoscc.ini, en el campo software_profiles.

Para crear los perfiles de software definidos, necesarios para el funcionamiento de la política de perfiles de software, ejecute el siguiente comando:

* <code>$GECOSCC_HOME/bin/pmanage $GECOSCC_HOME/gecoscc.ini create_software_profiles</code>

Acceder a GECOS CC

Interfaz de GECOS Centro de Control recién instalado.

Para acceder a GECOS Centro de Control, abra el navegador y cargue la dirección http://servidor:80/. En la pantalla de bienvenida e identificación que se muestra, rellene el nombre y contraseña del administrador que creó en la sección anterior.

Si lo necesita, chef-server se encuentra en https://servidor:443/.

Solución de problemas

Si le surgen problemas durante la instalación, compruebe lo siguiente:

  • Tiene al menos 2 GB de memoria RAM, ya que el proceso de compilación es costoso.
  • Tiene al menos 20 GB libres de disco duro, por el mismo motivo anterior.
  • No ha habido ningún problema de red que haya afectado a la descarga de algún paquete. Si ha sucedido, relance el script.
  • Si ha fallado nginx, relance el script.

Importador de Directorio Activo

Si en la red de su organización se utiliza Directorio Activo, puede importar la estructura de usuarios, grupos, impresoras, etc, a GECOS Centro de Control fácilmente. Para ello, debe utilizar el script ad-export.ps1 que encontrará en el proyecto [[https://github.com/gecos-team/gecos-ad-sync|gecos-ad-sync]] (es importante que el directorio Pscx con las dependencias esté en la misma ruta de ejecución que el script).

El script importa los siguientes elementos: unidades organizativas, usuarios, grupos, ordenadores, impresoras compartidas y carpetas compartidas. La ejecución del script la puede realizar de dos modos, con una importación puntual o programando una tarea para que se realice de manera periódica.

Configuración del script

En las primeras líneas del script dispone de unas variables de configuración. Abra el script y rellénelas con los valores adecuados.

Variable Posible valor Significado
$GecosCCAPIUrl "http://gecoscc/api/ad_import/" La URL de la API de importación. Será la IP/dominio más /api/ad_import/.
$GecosCCAPIUsername "ad-import" Un administrador de GECOS CC.
$GecosCCAPIPassword "ad-import" La contraseña de dicho administrador.
$GecosCCAPIRootOU "root" o "id" El identificador de la unidad organizativa en la que importar los elementos. Si prefiere la unidad raiz utilice "root", si prefiere otra, extraiga el identificador a partir de su URL (http://gecos-server/#ou/id-ou-padre/ou/id).

Opción 1: Importación puntual

Para la importación puntual siga estos pasos:

  • Paso 1: Abra la terminal de Powershell.
  • Paso 2: Vaya a la ruta donde tenga el script ad-export.ps1 con el comando cd, por ejemplo: cd C:\ruta_del_script</code>.
  • Paso 3: Ejecute el script con la instrucción .\ad-export.sh (nótese el punto antes de la barra).

Opción 2: Importación periódica

Para hacer la importación periódicamente haga lo siguiente:

  • Paso 1: Abra «Administrador del servidor» desde el menú «Equipo» y «Administrar».
  • Paso 2: En el árbol de la izquierda, despliegue «Configuración» y entre en «Programador de tareas».
  • Paso 3: Escoja «Crear tarea» en la lista de acciones de la derecha.
  • Paso 4: En la pestaña «General» rellene el nombre y la descripción, por ejemplo ad-export y script de importación de AD para GECOSCC, respectivamente.
  • Paso 5: En la pestaña «Desencadenadores» añada uno nuevo e indique la frecuencia y/o fecha y hora.
  • Paso 6: En la pestaña «Acciones» cree una nueva y elija el script ad-export.ps1 junto con la ruta donde se encuentre.

Firma de scripts

Si es necesario por defecto firmar los scripts para Powershell y eso le está impidiendo ejecutarlo, puede desactivarlo indicando la siguiente instrucción en la terminal: set-executionpolicy unrestricted

Configuración avanzada

GECOS CC puede configurarse a través del fichero de configuración /opt/gecosccui-(versión en uso)/gecoscc.ini (ver plantilla) aunque se trata de opciones avanzadas que no debería cambiar a menos que tenga conocimientos adecuados.

Parámetro Valor Descripción
chef.url https://localhost/ Conexión con Chef.
mongo_uri mongodb://localhost:27017/gecoscc Conexión con Mongo.
session.data_dir %(here)s/sessions/data Datos de sesión.
session.lock_dir %(here)s/sessions/lock Datos de sesión.
pyramid.xyz true/false/lang Especialmente interesante es pyramid.default_locale_name, que es el idioma en el que aparecerá la interfaz.
firstboot_api.organization_name Organization name El nombre de su organización.
firstboot_api.media %(here)s/../gecoscc/media/users Ruta donde se guardan datos de usarios y firstboot, especialmente los ficheros PEM.
workers 4 Número de hilos.
worker_class gevent Activar/Desactivar websockets.
timeout 600 Tiempo tras el cual la conexión expira.
level INFO/DEBUG Nivel de verbosidad en los logs.

Conexiones

GECOS Centro de Control establece distintas conexiones a través de sus APIs internas y externas (ver lista). A continuación se describen las externas.

API Ruta Descripción
ad_import.py /api/ad-import/ Importación de datos de Active Directory.
admin_users.py /auth/config/ Las unidades organizativas del administrador, variables, etc, en JSON.
chef_status.py /chef/status/ Devuelve el estado de las tareas para la pestaña de eventos y cola.
public_computers.py /computers/list/ Lista de puestos existentes.
public_ous.py /ou/list/ Lista de unidades organizativas.
register_computer.py /register/computer/ Para vincular el puesto de trabajo al Centro de Control.
register_user.py /register/user/ Para vincular un usuario al Centro de Control en su primer login.

Además cada puesto de trabajo se comunica con el Centro de Control a través de su chef-client.

Actualización a una versión superior

Cuando aparezca una versión superior de GECOS Centro de Control quizás le interese realizar una actualización para disfrutar de las mejoras. El script de actualización descargará la versión más reciente disponible de GECOS Centro de Control.

Es recomendable detener todos los procesos de la versión anterior del centro de control antes de proceder a la actualización:

  • /etc/init.d/supervisord stop

Lance el script automático usando el siguiente comando como root:

El proceso durará unos minutos. Si el modelo de datos interno ha cambiado, se proporcionará un script que haga la conversión para que sea transparente para el usuario.

Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.