Skip to main content
Version: 9.3.0

Sistema

Usuarios​

Crear un nuevo usuario​

Este comando sirve para crear un nuevo usuario a nivel de sistema operativo.

Cambiar contraseña de usuario​

Este instructivo indica cómo cambiar la contraseña de un usuario del entorno. Estos pasos deben ser ejecutados en todos los servidores que componen el entorno (servidores de administración, de aplicación y web). La contraseña debe ser la misma en todos los servidores que componen el entorno.

  1. Primero se debe hacer login con el usuario cuya contraseña se desea cambiar.

  2. A continuación, ejecutar el siguiente comando:

    passwd
    info

    Este comando iniciará un proceso interactivo. Se pedirán los siguientes valores:

    • Current password: La contraseña actual del usuario.
    • New password: La nueva contraseña del usuario. Debe tener 8 caracteres como mínimo o será rechazada.
    • Retype new password: La contraseña ingresada en **New password:**.

Modo mantenimiento​

Habilitar y Deshabilitar el modo mantenimiento​

Estos comandos sirven para habilitar o deshabilitar el modo mantenimiento.

Para habilitar el mantenimiento ejecutar:

ansible-playbook admin.yml -K -t maintenance-enable

Para deshabilitar el mantenimiento ejecutar:

ansible-playbook admin.yml -K -t maintenance-disable

Actualizar certificado SSL​

warning

El certificado cert.pem debe tener el EKU de Autenticación TLS como Servidor.

  1. En el servidor de administración, en el directorio ansible, en la ruta /tls, reemplazar los archivos:

    • cert.pem. Certificado SSL fullchain en formato PEM, incluyendo CA si el CA no es autofirmado.
    -----BEGIN CERTIFICATE-----
    Certificado del servidor
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    Certificado intermedio 1
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    Certificado intermedio 2 (si fuera necesario)
    -----END CERTIFICATE-----
    • key.pem. Llave privada del certificado en formato PEM

    • ca.pem. Certificado CA que ha firmado el último certificado de la cadena en cert.pem. Debe ser autofirmado

    -----BEGIN CERTIFICATE-----
    Certificado CA
    -----END CERTIFICATE-----
  2. Si VIRIDIAN indicara que se debe realizar un cambio en los certificados internos, en el servidor de administración, en el directorio ansible, ejecutar los siguientes comandos:

    cp tls/internalcert.pem tls/cert1.pem
    cp tls/internalkey.pem tls/key1.pem
  3. Si VIRIDIAN indicara que se debe realizar un cambio en los certificados internos, en el servidor de administración, en el directorio ansible, en la ruta /tls, reemplazar los archivos:

    danger

    Los archivos que inician con el prefijo internal serán proporcionados por VIRIDIAN.

    • internalcert.pem. Certificado SSL interno de la solución VIRIDIAN.
    -----BEGIN CERTIFICATE-----
    Certificado del servidor
    -----END CERTIFICATE-----
    • internalkey.pem. Llave privada del certificado en formato PEM.

    • internalca.pem. Certificado VIRIDIAN CA.

    -----BEGIN CERTIFICATE-----
    Certificado CA
    -----END CERTIFICATE-----
  4. En el servidor de administración, habilitar el modo mantenimiento.

  5. En el servidor de administración, copiar los archivos actualizados.

    ansible-playbook tls.yml -K -t deploy
  6. En el servidor de administración, ejecutar el siguiente comando ansible para reiniciar los servidores de aplicación::

    ansible-playbook -l app admin.yml -K -t reboot
  7. En el servidor de administración, ejecutar el siguiente comando:

    sudo reboot
    info

    Este comando reinicia el servidor de administración.

  8. Cuando todos los servidores hayan reiniciado, en el servidor de administración, desellar vault.:

    ansible-playbook vault.yml -K -t unseal
  9. En el servidor de administración, reiniciar los servidores web.:

    ansible-playbook -l web admin.yml -K -t reboot
  10. Cuando todos los servidores hayan reiniciado, en el servidor de administración, deshabilitar el modo mantenimiento.

Ejecutar un cron task​

Este comando sirve para ejecutar manualmente un cron task.

Reiniciar Servidores del Entorno.​

warning

El reinicio de servidores debería hacerse a una hora de bajo tráfico.

  1. En el servidor de administración, el Modo Mantenimiento

  2. En el servidor de administración, ejecutar el siguiente comando ansible:

    ansible-playbook admin.yml -K -t stop-netcore
  3. En el servidor de administración, ejecutar el siguiente comando ansible:

    ansible-playbook admin.yml -K -t stop-vdb-frontend
  4. En el servidor de administración, ejecutar el siguiente comando ansible:

    ansible-playbook admin.yml -K -t stop-kafka
  5. En el servidor de administración, ejecutar el siguiente comando ansible:

    ansible-playbook admin.yml -K -t stop-redis
  6. Ejecutar en cada servidor elsiguiente comando:

    shutdown

Variable Locales​

Ver archivo de variables locales​

  1. En el servidor de administración, ejecutar el siguiente comando:

    cat defaults/local_vars.yml

Editar archivo de variables locales​

  1. En el servidor de administración, ejecutar el siguiente comando:

    vi defaults/local_vars.yml
  2. Una vez que se haya terminado de editar el archivo, presionar la tecla Esc, escribir :wq y presionar ENTER.

    danger

    Las únicas variables que deberían ser editadas son las que se encuentran en el apartado network para habilitar nuevas ip's y/o segmentos de red. Cualquier cambio en las demás variables puede provocar que los servicios de la solución dejen de estar operativos. Igualmente, tomar en cuenta que la pérdida de valores del archivo defaults/local_vars.yml podría no ser reversible.