Guía del usuario

Procedimiento 3.1. Cómo crear una nueva organización

1. Haga clic en Administrar → Organizaciones del menú de la esquina superior derecha.
2. Haga clic en el botón Nueva organización.
3. Escriba el nombre de la nueva organización en el campo Nombre.
4. Escriba la etiqueta de la nueva organización en el campo Etiqueta.
5. Escriba la descripción de la nueva organización en el campo Descripción.
6. Haga clic en el botón Enviar.
7. Seleccione los hosts que desea asignar a la nueva organización.
   • Haga clic en el botón Asignar todos para asignar todos los hosts, que no tienen una organización, a la nueva organización.
   • Haga clic en el botón Asignar manualmente para seleccionar manualmente los hosts sin organización y asignarles una organización.
   • Haga clic en el botón Proseguir a editar para ignorar la asignación de hosts.

Procedimiento 3.2. Creación de un nuevo certificado de depuración de una nueva organización

1. Haga clic en Administrar → Organizaciones del menú de la esquina superior derecha.
2. Seleccione una organización de la lista a la izquierda.
3. Haga clic en el botón Generar una descarga. Esto genera un certificado de depuración. Guarde el certificado en un lugar seguro.

Procedimiento 3.3. Cómo modificar una organización

1. Haga clic en Administrar → organizaciones en el menú de la esquina superior derecha.
2. Haga clic en el nombre de la organización que desea modificar.
3. Seleccione el recurso a modificar de la lista a la derecha.
4. Haga clic en el nombre del ítem deseado para agregarlo a la lista de Ítemes seleccionados
5. Haga clic en el botón Enviar.

Procedimiento 3.4. Cómo retirar una organización

1. Haga clic en Administrar → Organizaciones del menú de la esquina superior derecha.
2. Seleccione Borrar desde el menú desplegable a la derecha del nombre de la organización que desea borrar.
3. Aparece un cuadro de alerta:

   Borrar Nombre de organización?

4. Haga clic en el botón Aceptar.

Procedimiento 3.5. Cómo crear una ubicación

1. Haga clic en Administrar → Ubicación del menú de la esquina superior derecha.
2. Haga clic en el botón Nueva ubicación.
3. Escriba el nombre del nuevo sitio en el campo Nombre y haga clic en el botón Enviar.
4. Seleccione los hosts que desea asignar a la nueva ubicación.
   • Haga clic en el botón Asignar todos para asignar todos los hosts, que no tienen un sitio para la nueva ubicación.
   • Haga clic en el botón Asignar manualmente para asignar de ese modo, los hosts que no tienen ubicación.
   • Haga clic en el botón Proseguir a editar para ignorar la asignación de hosts.

Procedimiento 3.6. Cómo modificar un sitio

1. Haga clic en Administrar → Ubicación del menú de la esquina superior derecha.
2. Haga clic en el nombre de la ubicación que desea modificar.
3. Seleccione el recurso a modificar de la lista a la derecha.
4. Haga clic en el nombre del ítem deseado para agregarlo a la lista de Ítemes seleccionados
5. Haga clic en el botón Enviar.

Procedimiento 3.7. Cómo retirar una ubicación

1. Haga clic en Administrar → Ubicación del menú de la esquina superior derecha.
2. Seleccione Borrar desde el menú desplegable a la derecha del nombre de la organización que desea retirar.
   Aparece un cuadro de alerta:

   Borre Nombre de ubicación

3. Haga clic en el botón Aceptar.

Procedimiento 3.8. Cómo crear un entorno de ciclo de vida

1. Haga clic en el menú Contenido → Entornos de ciclo de vida
2. Haga clic en el botón Nueva ruta de entorno.
3. Escriba un nombre en el campo Nombre.
4. Escriba una etiqueta en el campo Etiqueta.
5. Haga una descripción en el campo Descripción.
6. Haga clic en el botón Guardar.

Procedimiento 3.9. Cómo retirar un entorno de ciclo de vida

1. Haga clic en el menú Contenido → Entornos de ciclo de vida
2. Haga clic en el nombre del entorno de ciclo de vida que va a retirar.
3. Haga clic en el botón Retirar entorno en el botón a la derecha.
4. Aparece un cuadro de alerta:

   ¿Está seguro de que desea retirar el entorno Nombre de entorno?

5. Haga clic en el botón Retirar.

Procedimiento 4.10. A fin de configurar un host para sincronizar y exportar contenido desde Red Hat CDN:

1. Utilice Red Hat Subscription Manager para registrar el host de sincronización a RHN.
2. Liste todas las suscripciones disponibles para encontrar el producto correcto de Red Hat Satellite a asignar al sistema:

   # subscription-manager list --available --all

   Este comando muestra salida similar a la siguiente:

   +-------------------------------------------+
       Available Subscriptions
   +-------------------------------------------+
   
   
   ProductName:        Red Hat Satellite
   ProductId:          SKU123456
   PoolId:             e1730d1f4eaa448397bfd30c8c7f3d334bd8b
   Quantity:           10
   Multi-Entitlement:  No
   Expires:            08/20/2013
   MachineType:        physical
   

   Nota

   El ID de SKU y POOL dependen del tipo de producto Red Hat Satellite que corresponde a la versión de su sistema y tipo de producto.
3. Suscriba al grupo mediante el siguiente comando:

   # subscription-manager subscribe --pool=Red_Hat_Satellite_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Pool_Id
   # subscription-manager subscribe --pool=Red_Hat_Enterprise_Linux_Software_Collections_Pool_Id
   

4. Inhabilite todos los repositorios existentes:

   # subscription-manager repos --disable "*"
   

5. Habilite los repositorios Red Hat Satellite y Red Hat Enterprise Linux y Red Hat Software Collections. Asegúrese de que el repositorio Red Hat Enterprise Linux coincida con la versión específica que está utilizando.

   # subscription-manager repos --enable rhel-6-server-rpms \
   --enable rhel-server-rhscl-6-rpms \
   --enable rhel-6-server-satellite-6.0-rpms
   

   Nota

   Los comandos anteriores se basan en Red Hat Enterprise Linux 6. Si utiliza una versión diferente a Red Hat Enterprise Linux, cambie el repositorio
6. Instale katello-utils y los RPM asociados:

   # yum install python-qpid-qmf python-qpid  qpid-cpp-server-store katello-utils
   

   katello-utils incluye la funcionalidad katello-disconnected requerida para configurar repositorios a importar mientras los paquetes relacionados a qpid son necesarios para la configuración de pulp.
7. Genere una cadena secreta de 32 caracteres para la entrada de oauth_secret en el archivo/etc/pulp/server.conf:

   # tr -dc "[:alnum:]" < /dev/urandom | head -c 32 
   randomly_generated_value

8. En /etc/pulp/server.conf, descomente la entrada [oauth] y añada el valor generado de forma aleatoria desde el paso anterior como el valor oauth_secret:

   [oauth]
   enabled: true
   oauth_key: katello
   oauth_secret: randomly_generated_value

9. Inhabilite autenticación en/etc/qpid/qpidd.conf:

   # Configuration file for qpidd. Entries are of the form: 
   #   name=value 
   #
   # (Note: no spaces on either side of '=').
   # Run "qpidd --help" or see "man qpidd" for more details.
   
   auth=no
   

   Todas las conexiones se autentican mediante el reino predeterminado de Satellite.
10. Configure la conexión desde katello-disconnected a Pulp con el valor generado anteriormente como la opción --oauth-secret:

    # katello-disconnected setup --oauth-key=katello --oauth-secret=randomly_generated_value

    Así sitúa el valor de configuración en ~/.katello-disconnected.
11. Configure Pulp en Synchronization Server:

    sudo service qpidd start
    sudo chkconfig qpidd on
    sudo service mongod start
    sleep 10
    sudo chkconfig mongod on
    sudo -u apache pulp-manage-db
    sudo service httpd restart
    sudo chkconfig pulp_workers on
    sudo service pulp_workers start
    sudo chkconfig pulp_celerybeat on
    sudo service pulp_celerybeat start
    sudo chkconfig pulp_resource_manager on
    sudo service pulp_resource_manager start
    

12. Importe el manifiesto:

    # katello-disconnected import -m ./manifest.zip
    

    Al importar el manifiesto, configura la lista de repositorios disponibles a sincronizar según las suscripciones seleccionadas.

1. Inhabilite todos los repositorios:

   # katello-disconnected disable --all
   

   katello-disconnected habilita de forma predeterminada todos los repositorios.
2. Elija los repositorios que desea sincronizar al listar todos los repositorios disponibles en el manifiesto:

   # katello-disconnected list --disabled
   rhel-5-server-debug-rpms-5Server-i386
   rhel-5-server-debug-rpms-5Server-ia64
   rhel-5-server-debug-rpms-5Server-x86_64
   rhel-5-server-debug-rpms-5_7-i386
   rhel-5-server-debug-rpms-5_7-ia64
   rhel-5-server-debug-rpms-5_7-x86_64
   rhel-5-server-debug-rpms-5_8-i386
   rhel-5-server-debug-rpms-5_8-ia64
   rhel-5-server-debug-rpms-5_8-x86_64
   rhel-5-server-debug-rpms-5_9-i386
   rhel-5-server-debug-rpms-5_9-ia64
   rhel-5-server-debug-rpms-5_9-x86_64
   rhel-5-server-isos-5Server-i386
   

3. Habilite los repositorios seleccionados para sincronización:

   # katello-disconnected enable -r rhel-6-server-sam-rpms-6_4-x86_64
   

4. Cree los repositorios y envíelos a Pulp para permitir sincronización:

   # katello-disconnected configure
   

   Nota

   La opción de configuración para katello-disconnected lee el manifiesto, crea repositorios Pulp y genera scripts antes de sincronización. Se debe ejecutar cada vez que un repositorio esté inhabilitado o habilitado.
5. Sincronizar los repositorios:

   # katello-disconnected sync
   

   Puede usar la opción watch para monitorizar el proceso de sincronización.

   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   running:
   rhel-6-server-sam-rpms-6_4-x86_64 
   ...
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64 
   
   
   Watching finished
   

1. Exporte los repositorios sincronizados:

   # katello-disconnected export -t /var/tmp/export
   

   La salida se será similar a esta:

   
   # katello-disconnected export -t /var/tmp/export
   # katello-disconnected watch
   Watching sync... (this may be safely interrupted with Ctrl+C)
   running:
   rhel-6-server-sam-rpms-6_4-x86_64
   
   finished:
   rhel-6-server-sam-rpms-6_4-x86_64
   Watching finished
   Done watching ...
    Copying content to /var/tmp/export
    Archiving contents of /var/tmp/export into 4600M tar archives.
    NOTE: This may take a while.
   tar: Removing leading `/' from member names
   
   Done exporting content, please copy /var/tmp/export/* to your disconnected host
   

   La operación creará los siguientes archivos en /var/tmp/export:

   # ls /var/tmp/export/
   content-export-00 content-export-01 content-export-02 expand_export.sh
   

2. Copie los archivos desde /var/tmp/export al medio externo.

   Nota

   Si los archivos son demasiado grandes para su medio externo, los archivos serán copiados de forma secuencial en una serie de DVD.

1. Copie el contenido exportado de los medios externos al directorio en el Satellite desconectado.

   Nota

   Si el contenido exportado fue colocado en dispositivos de medios externos diferentes, asegúrese de copiar todo el contenido en un directorio en Satellite desconectado.
2. Ejecute el script expand_export.sh copiado junto con el contenido exportado:

   # ./expand_export.sh 
   *** Done expanding archives. ***
   

   Aviso

   Satellite desconectado debe tener el mismo espacio que el del archivo exportado antes de expandir el contenido exportado. De otra manera, el script falla.
   El script expandirá el archivo en un directorio.
3. Desplace el contenido del árbol del directorio expandido a /var/www/html en Satellite Server y restaure los contextos SELinux en los archivos desplazados:

   # mv var/tmp/export/* /var/www/html/
   # cd /var/www/html
   # restorecon -r *
   

   Nota

   Satellite ahora actúa como su propio CDN con los archivos localizados en http://localhost/content. Este no es un requisito. El CDN puede albergarse en una máquina diferente dentro de la misma red desconectada siempre y cuando esté accesible al Satellite Server vía HTTP.
4. Agregue la dirección CDN a la interfaz web de Satellite:
   1. Ingrese a la interfaz de red de Satellite.
   2. Haga clic en Contenido → Red Hat Subscriptions y luego en Administrar manifiesto.
   3. En la pantalla de información del Manifiesto de suscripción, desplácese hasta Información del proveedor Red Hat. Haga clic en el icono de editar en la entrada de la URL de repositorio y cambie la entrada a la URL de repositorio del CDN.
   4. Haga clic en Navegar para elegir el archivo de manifiesto.
   5. Haga clic en Cargar para importar su manifiesto.
5. Habilite los repositorios desde el CDN local:
   1. Haga clic en Content → Red Hat Repositories
   2. Habilite los repositorios seleccionados en la sección: Cómo sincronizar contenido.
6. Haga clic en Contenido → Estatus de sincronización.
7. Seleccione los archivos que quiere sincronizar y haga clic en Sincronizar ahora.

Procedimiento 5.1. Cómo crear un filtro

1. Haga clic en Contenido → Vistas de contenido.
2. Seleccione la vista de contenido que desea filtrar.
3. Haga clic en la subpestaña Contenido → Filtros
4. Haga clic en el botón + Nuevo Filtro.
5. Escriba el nombre del nuevo filtro en el campo Nombre.
6. Elija el Tipo de contenido desde el menú desplegable.
7. Elija si el fitro incluye o excluye el tipo de contenido seleccionado en el menú desplegable Tipo.
8. De forma alternativa, ingrese una descripción en el campo Descripción
9. Haga clic en el botón Guardar para guardar su nuevo filtro.

1. Haga clic en Contenido → Vistas de contenido.
2. Seleccione la vista de contenido que desea filtrar.
3. Haga clic en la subpestaña de Contenido → Filtros..
4. Haga clic en el nombre del filtro de paquete creado. La lectura será diferente, según el tipo de filtro seleccionado.
   1. Si el filtro se creó para paquetes:
      1. Ingrese el nombre de paquete y seleccione un valor de Información desde el menú desplegable. Haga clic en el botón +Añadir para agregar el paquete al filtro.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos los o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   2. Si el filtro fue creado para grupos:
      1. Haga clic en el la subpestaña Añadir y elija el grupo de paquetes deseado. Haga clic en el botón +Añadir grupo de paquetes.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos los o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   3. Si el filtro ha sido creado para erratas:
      1. Haga clic en la subpestaña Añadir. Marque las casillas deseadas para el tipo de erratas, ya sea Seguridad, Mejoras, o Corrección de errores. Luego elija una fecha de inicio y finalización. Haga clic en el botón +Añadir erratas.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos los o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   4. Si el filtro fue creado para erratas- fecha y tipo:
      1. En la subpestaña Rango de fecha de errata, marque las casillas deseadas para el tipo de erratas: Seguridad, Mejoras o Corrección de errores. Luego elija fecha de inicio y finalización. Haga clic en el botón Guardar.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos los o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
5. Haga clic en el botón Publicar nueva versión. Ingrese un comentario si desea, luego haga clic en el botón Guardar.

1. Haga clic en Contenido → Vistas de contenido.
2. Seleccione la vista de contenido que desea filtrar.
3. Haga clic en la subpestaña Contenido → Filtros.
4. Haga clic en el nombre del filtro de paquete creado. La lectura será diferente, según el tipo de filtro seleccionado.
   1. Si el filtro se creó para paquetes:
      1. Haga clic en la subpestaña Paquetes luego en Nombre de paquete en la casilla de verificación al lado del paquete que va a retirar. Haga clic en el botón Retirar paquetes para quitar los paquetes del filtro.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   2. Si el filtro se creó para grupos:
      1. Haga clic en la subpestaña Listar/Retirar luego haga clic en Nombre en la casilla de verificación al lado del paquete que va a retirar. Haga clic en el botón Retirar grupo de paquetes para quitar el grupo de paquetes del filtro.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   3. Si el filtro se creó para erratas:
      1. Haga clic en la subpestaña Listar/Retirar y luego haga clic en la casilla de verificación ID de erratas al lado de la errata que va a retirar. Pulse el botón Retirar erratas para retirar erratas del filtro.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
   4. Si el filtro se creó para erratas- fecha y tipo:
      1. En la subpestaña Rango de fecha de errata, marque las casillas deseadas para el tipo de erratas: Seguridad, Mejoras o Corrección de errores. Luego modifique la fecha de inicio y finalización. Haga clic en el botón Guardar.
      2. En la pestaña Repositorios afectados, elija si el filtro afectará todos o a un subconjunto de repositorios. Si elige un subconjunto de repositorios, entonces seleccione los repositorios deseados y haga clic en el botón Actualizar repositorios.
5. Haga clic en el botón Publicar nueva versión. Ingrese un comentario si desea, luego haga clic en el botón Guardar.

Procedimiento 5.2. Retirar un filtro

1. Haga clic en Contenido → Vistas de contenido.
2. Seleccione la vista de contenido que desea filtrar.
3. Haga clic en la subpestaña Contenido → Filtros.
4. Haga clic en la casilla de verificación al nombre del filtro de paquetes que desea retirar.
5. Haga clic en el botón Retirar filtros.

Procedimiento 7.3. Para agregar una suscripción de host a una llave de activación:

1. Haga clic en Contenido → Llaves de activación.
2. Haga clic en el nombre de la llave de activación a la que desea añadir suscripciones.
3. Haga clic en clic en Suscripciones → Añadir.
4. En la lista de suscripciones disponibles, seleccione las suscripciones que desea agregar y luego haga clic en Añadir seleccionadas.

Procedimiento 7.4. Para agregar colecciones de host a una llave de activación:

1. Haga clic en Contenido → Llaves de activación.
2. Haga clic en la llave de activación a la que desea añadir una colección de hosts.
3. Haga clic en Colecciones de hosts y luego en Añadir colecciones para mostrar la lista de colecciones de hosts disponibles.
4. Seleccione las colecciones de hosts que desea agregar y luego haga clic en Añadir para agregarlas a la llave de activación.

Procedimiento 7.5. Retirar suscripciones de la llave de activación

1. Haga clic en Contenido → Llaves de activación.
2. Se desplegará una lista de llaves de activación. Haga clic en la llave de activación de la que desea retirar suscripciones.
3. Haga clic en la subpestaña de aplicación Suscripciones.
4. Se desplegará una lista de suscripciones. Seleccione las suscripciones que desea retirar.
5. Haga clic en el botón Retirar seleccionadas para retirar las suscripciones de la llave de activación.

Procedimiento 7.6. Retirar colecciones de hosts de una llave de activación

1. Haga clic en Contenido → Llaves de activación.
2. Se presenta una lista de llaves de activación. Haga clic en la llave de activación de la que desea retirar colecciones de hosts.
3. Haga clic en la subpestaña Colecciones de hosts.
4. Se presenta una lista de colecciones de hosts adjuntos a la llave de activación. Seleccione la casilla de las colecciones de hosts que desea borrar.
5. Haga clic en el botón Retirar seleccionadas para retirar las colecciones de hosts de la llave de activación.

Procedimiento 9.1. Para agregar un grupo de hosts a Satellite:

1. Haga clic en Configurar → Grupos de hosts y luego en Nuevo grupo de hosts.
2. Ingrese la información requerida para el grupo de hosts y luego haga clic en Enviar.

1. Haga clic en Configurar → Parámetros globales.
2. Haga clic en el botón Nuevo parámetro.
3. Escriba el Nombre para la llave del parámetro.
4. Escriba un Valor para el parámetro.
5. Haga clic en el botón Enviar

1. Haga clic en Configurar → Clases Puppet.
2. Haga clic en el botón Nueva clase Puppet.
3. Escriba el Nombre para la clase Puppet.
4. Escriba un Entorno Puppet para la clase Puppet.
5. Seleccione uno o más grupos de hosts que poseen la clase Puppet.
6. Haga clic en el botón Enviar

Procedimiento 9.2. Para configurar parámetros Smart:

1. Haga clic en Configurar → Clases Puppet.
2. Seleccione una clase de la lista.
3. Haga clic en la pestañas Variables Smart. Así, despliega una nueva ventaña. La sección izquierda contiene una lista de los posibles parámetros que la clase soporta. La sección derecha contiene las opciones de configuración para el parámetro seleccionado. Haga clic en Añadir variable para agregar un nuevo parámetro. De lo contrario, seleccione un parámetro de la lista a mano izquierda.
4. Escriba un nombre para el campo Parameter
5. Modifique la casilla de texto Descripción para agregar las notas de texto plano.
6. Seleccione Tipo de parámetro de los datos que va a pasar. Por lo general, se trata de una cadena, sin embargo, otros tipos de datos reciben soporte.
7. Escriba un Valor predeterminado para un parámetro.
8. Use la sección Validador de salida opcional para restringir los valores seleccionados para el parámetro. Elija un Tipo de validador (una lista de valores separados por coma o una expresión regular, regexp) y salida que permite los valores o código de expresión regular en el campo Regla de validador.
9. La sección Sobrescribir valores para hosts específicos, al final de la página, proporciona opciones para valores de sobrescritura con base en los argumentos condicionales conocidos como Matchers. Defina el Orden en que se resuelven los valores de host, luego haga clic en Añadir Matcher-Value para agregar un argumento condicional.
   Por ejemplo, si el valor deseado del parámetro es test para un host con un nombre de dominio completamente calificado de www.example.com, especifique Match como fqdn=www.example.com y el Valor como test.
10. Haga clic en Enviar para guardar sus cambios.

Procedimiento 9.3. Para importar clases con parámetros

1. Haga clic en Configurar → Clases Puppet.
2. Haga clic en Importar desde Nombre de host para importar clases con parámetros desde su Puppet Master.
3. La página Clases Puppet muestra las nuevas clases en la lista.

Procedimiento 9.4. Para configurar las clases con parámetros

1. Haga clic en Configurar → Clases Puppet.
2. Seleccione una clase de la lista.
3. Haga clic en la pestaña Parámetro Smart Class. Aparece una nueva pantalla. La sección de la izquierda contiene una lista de los posíbles parámetros que la clase soporta. La sección de la derecha contiene las opciones de configuración para el parámetro seleccionado.
4. Seleccione un parámetro de la lista a mano izquierda.
5. Modifique la casilla de texto Descripción para agregar las notas de texto plano.
6. Haga clic en la casilla Sobrescribir para permitir que Satellite controle la variable. Si no selecciona esta casilla, Satellite no pasa esta variable a Puppet.
7. Seleccione Tipo de parámetro de los datos que va a pasar. Por lo general, se trata de una cadena, sin embargo, otros tipos de datos reciben soporte.
8. Escriba un Valor predeterminado para un parámetro.
9. La sección Sobrescribir valores para hosts específicos, al final de la página, proporciona opciones para valores de sobrescritura con base en los argumentos condicionales conocidos como Matchers. Defina el Orden en que se resuelven los valores de host, luego haga clic en Añadir Matcher-Value para agregar un argumento condicional.
   Por ejemplo, si el valor deseado del parámetro es test para un host con un nombre de dominio completamente calificado de www.example.com, especifique Match como fqdn=www.example.com y el Valor como test.
10. Haga clic en Enviar para guardar sus cambios.

1. Tome nota del nombre del host de Red Hat Satellite o del nombre de dominio completamente calificado (fqdn).
2. Abra una consola de la terminal e inicie sesión como root en la línea de comandos.
3. Descargue e instale una copia de un certificado CA para Red Hat Satellite:

   yum -y --nogpgcheck install http://[hostname]/pub/katello-ca-consumer-[hostname]-1.0-1.noarch.rpm
   

   Importante

   yum en Red  Hat Enterprise Linux 5 no soporta la instalación vía HTTP. Si registra un cliente Red  Hat Enterprise Linux 5, primero descargue el paquete RPM y luego ejecute yum en el paquete. Por ejemplo:

   # wget http://[hostname]/pub/katello-ca-consumer-[hostname]-1.0-1.noarch.rpm
   # yum -y --nogpgcheck install katello-ca-consumer-[host]-1.0-1.noarch.rpm
   

   Nota

   katello-ca-consumer-latest.noarch.rpm es un rpm katello-ca-consumer adicional que no contiene el nombre de host de servidor. Este rpm siempre reflejará la versión más actualizada del paquete. Ambos sirven el mismo propósito.

1. Realice los siguientes cambios en /etc/rhsm/rhsm.conf:

   [server]
   hostname =[satellite_fqdn]
   
   
   [rhsm]
   baseurl=https://[fqdn_pulp]/pulp/repos/
   repo_ca_cert = %(ca_cert_dir)scandlepin-local.pem
   ca_cert_dir = /etc/rhsm/ca/
   

2. Cambie directorios al directorio ca, retire la copia y desplace el certificado candlepin-ca.crt:

   # cd /etc/rhsm/ca
   scp  [satellite.fqdn]:/etc/candlepin/certs/candlepin-ca.crt .
   mv candlepin-ca.crt candlepin-local.pem
   

Procedimiento 10.2. Registro de un sistema

1. Abra una consola de la terminal e inicie sesión como root en la línea de comandos.
2. Limpie los datos antiguos del sistema como preparación para el registro. Esto es con el fin de que los datos actualizados del sistema se carguen apropiadamente.

   subscription-manager clean
   

3. Registre el sistema mediante Red Hat Subscription Manager (RHSM):

   # subscription-manager register --org [your_org_name] --activationkey [your_activation_key]
   

   Nota

   Las llaves de activación le permitirán agregar entornos, plantillas del sistema y dictar las suscripciones que estén disponibles y que se deben aplicar al sistema de registro.

   Hay varias opciones que se pueden agregar. Para mayor información, use el comando man subscription-manager.

Procedimiento 10.3. Cómo instalar y configurar Katello Agent

1. Abra una consola de la terminal e inicie sesión como root en la línea de comandos.
2. Instale katello-agent mediante el siguiente comando:

   Nota

   El repositorio Red Hat Common debe estar habilitado, ya que es el que proporciona puppet-agent.

   # yum install katello-agent
   

Procedimiento 10.4. Cómo instalar y configurar Puppet Agent

1. Abra una consola de la terminal e inicie sesión como root en la línea de comandos.
2. Instale puppet-agent mediante el siguiente comando:

   Nota

   El repositorio Red Hat Common debe estar habilitado ya que proporciona puppet-agent.

   # yum install puppet-agent
   

Procedimiento 10.5. Cómo configurar Puppet Agent

1. Configure puppet-agent al modificar el archivo /etc/puppet/puppet.conf:

   # vi /etc/puppet/puppet.conf
   

   [main]
       # The Puppet log directory.
       # The default value is '$vardir/log'.
       logdir = /var/log/puppet
   
       # Where Puppet PID files are kept.
       # The default value is '$vardir/run'.
       rundir = /var/run/puppet
   
       # Where SSL certificates are kept.
       # The default value is '$confdir/ssl'.
       ssldir = $vardir/ssl
   
   [agent]
       # The file in which puppetd stores a list of the classes
       # associated with the retrieved configuratiion.  Can be loaded in
       # the separate ``puppet`` executable using the ``--loadclasses``
       # option.
       # The default value is '$confdir/classes.txt'.
       classfile = $vardir/classes.txt
       pluginsync = true
       report = true
       ignoreschedules = true
       daemon = false
       ca_server = satellite.example.com
       server = satellite.example.com
   
       # Where puppetd caches the local configuration.  An
       # extension indicating the cache format is added automatically.
       # The default value is '$confdir/localconfig'.
       localconfig = $vardir/localconfig
   

2. Ejecute el agente Puppet en el host:

   # puppet agent -t --server satellite.example.com

3. Firme el certificado SSL para el cliente Puppet a través de la interfaz web de Satellite Server:
   1. Ingrese a Satellite Server a través de la interfaz web.
   2. Seleccione Infraestructura → Cápsulas.
   3. Haga clic en Certificados a la derecha del host requerido.
   4. Haga clic en Firmar.

Procedimiento 11.3. Cómo agregar paquetes a colecciones de hosts

1. Haga clic en Hosts → Colecciones de hosts.
2. Haga clic en la colección de host en donde se debe agregar el paquete.
3. Haga clic en la subpestaña Acciones de colecciones.
4. Haga clic en el enlace Instalación de paquetes, remoción y actualizaciones.
5. En el campo proporcionado, escriba el paquete o el nombre del grupo del paquete. Luego haga clic en:
   • Instalar ‐ si desea instalar un nuevo paquete
   • Actualizar ‐ si desea actualizar un paquete existente en la colección de hosts.

Procedimiento 11.4. Cómo agregar erratas a una colección de hosts

1. Haga clic en Hosts → Colecciones de hosts.
2. Seleccione la colección de hosts en donde se deben agregar las erratas.
3. Haga clic en la subpestaña Acciones de colecciones.
4. Haga clic en el enlace Instalación de erratas.
5. Seleccione las erratas que desea enviar a la colección de hosts y haga clic en Instalar seleccionadas.

Procedimiento 13.2. Para crear un usuario

1. Haga clic en Administrar → Usuarios y luego en Nuevo usuario.
2. Ingrese la información requerida en la pestaña Usuario.
3. En la pestaña Ubicación, seleccione los sitios para este usuario.
4. En la pestaña Organizaciones, seleccione las organizaciones requeridas para el usuario.
5. En la pestaña Roles, seleccione los roles requeridos para este usuario. Los roles activos se despliegan en el panel derecho.
6. Haga clic en el botón Enviar para crear el usuario.

Procedimiento 13.3. Modifique el usuario existente

1. En la esquina superior derecha de la página web, haga clic en Administrar → Usuarios.
2. Haga clic en el nombre de usuario del usuario requerido. La información general sobre el usuario aparecerá a la derecha.
3. Modifique el nombre de usuario del usuario, nombre, apellido, correo-e, ubicación predeterminada, organización predeterminada, idioma y contraseña en la pestaña Usuario.
4. Modifique los sitios de usuario asignados en la pestaña Ubicación.
5. Modifique las organizaciones de usuario asignadas en la pestaña Organizaciones.
6. Modifique los roles de usuario asignados, en la pestaña Roles.
7. Haga clic en el botón Guardar para guardar sus cambios.

Procedimiento 13.4. Para eliminar un usuario existente:

1. Haga clic en Administrar → Users en la esquina superior derecha de la página web.
2. Haga clic en el enlace Borrar a la derecha del nombre de usuario que desea borrar de la lista de usuarios disponibles.
3. Aparece un cuadro de alerta:

   ¿Borrar Nombre de usuario?

4. Haga clic en el botón Aceptar.

Procedimiento 13.5. Crear un rol

1. Haga clic en Administrar → Roles en la esquina superior derecha de la página web.
2. Haga clic en el enlace Nuevo rol.
3. Proporcione un Nombre para el rol.
4. Haga clic en el botón Enviar para guardar el nuevo rol.

Procedimiento 13.6. Cómo añadir permisos a un rol existente

1. En la esquina superior derecha de la página web, haga clic en Administrar → Roles.
2. Seleccione Añadir permiso desde el menú desplegable a la derecha del rol requerido.
3. Seleccione el Tipo de recurso del menú desplegable.
4. Seleccione con un clic el permiso requerido en la lista de Permisos para pasarlo a la lista de Ítemes seleccionados.
5. Seleccione si el permiso es Ilimitado o no , en la cajillla de verificacion.
6. Haga clic en Siguiente. Aparece una lista de los permisos disponibles.
7. Haga clic en el botón Enviar para guardar los cambios.

Procedimiento 13.7. Cómo retirar un rol existente

1. En la esquina superior derecha de la página web, haga clic en Administrar → Roles.
2. Seleccione Borrar desde la casilla del menú desplegable a la derecha del rol que desea borrar.
3. Aparece un cuadro de alerta:

   ¿Borrar Rol?

4. Haga clic en el botón Aceptar.

Procedimiento 15.1. Ver el historial de importaciones

1. Haga clic en Contenido → Red Hat Subscriptions.
2. Haga clic en el botón Administrar manifiesto.
3. Haga clic en la pestaña Historial de importación.

Procedimiento 15.2. Procedimiento de respaldo Red Hat Satellite

1. Prepare la ubicación de su copia de seguridad:

   umask 0027
   export BDIR=/backup
   mkdir $BDIR
   chgrp postgres $BDIR
   chmod 770 $BDIR
   cd $BDIR
   

2. Haga una copia de seguridad de la configuración y los archivos de datos:

   # tar --selinux -czvf config_files.tar.gz \
   /etc/katello \
   /etc/elasticsearch \
   /etc/candlepin \
   /etc/pulp \
   /etc/gofer \
   /etc/grinder \
   /etc/pki/katello \
   /etc/pki/pulp \
   /etc/qpidd.conf \
   /etc/sysconfig/katello \
   /etc/sysconfig/elasticsearch \
   /root/ssl-build \
   /var/www/html/pub/* \ 
   
   # tar --selinux -czvf elastic_data.tar.gz /var/lib/elasticsearch

3. Haga una copia de seguridad de los repositorios. Los archivos RPM en repositorios ya usan compresión y no pueden comprimirse más. Por lo tanto, dependiendo del tamaño de la instancia, el archivador de respaldo (pulp_data.tar) puede resultar bastante grande.
   Hay dos opciones para hacer copias de seguridad de repositorios:
   Primera opción: copia de seguridad de los repositorios en línea

   Realiza una suma de verificación de todas las marcas de tiempo, hace una copia de seguridad del repositorio y realiza nuevamente la suma de verificación.

   # find /var/lib/pulp -printf '%T@
   ' | md5sum
   # tar --selinux -cvf pulp_data.tar /var/lib/pulp /var/www/pub
   # find /var/lib/pulp -printf '%T@
   ' | md5sum

   Si ambas sumas de verificación coinciden, entonces la copia de seguridad en línea es correcta y se puede utilizar. Si las sumas de verificación, no coinciden, entonces realiza nuevamente la copia de seguridad del repositorio.

   Nota

   Use el comando rsync para agilizar el copiado para que las sumas de verificación coincidan.
   Segunda opción: copia de seguridad de los repositorios fuera de línea

   Detenga el servidor Pulp y realice la copia de seguridad. Después de completar la copia de seguridad reinicie el servidor Pulp.

   # service pulp-server stop
   # tar --selinux -cvf pulp_data.tar /var/lib/pulp /var/www/pub
   # service pulp-server start

   Nota

   Cuando el servidor Pulp esté caído, Red Hat Satellite y los clientes Yum, podrán mantener la conexión. Cualquier acción de repositorio realizada en Red Hat Satellite fallará durante esta inactividad.
4. Realice una copia de seguridad de sus bases de datos:
   Copia de seguridad de la base de datos

   Haga una copia de seguridad fuera de línea mediante estos comandos:

   tar --selinux -czvf mongo_data.tar.gz /var/lib/mongodb
   tar --selinux -czvf pgsql_data.tar.gz /var/lib/pgsql/data/
   

   Aviso

   Red Hat Satellite debe estar completamente inactivo para realizar una copia de seguridad fuera de línea. El uso de este paso mientras Satellite se esté ejecutando, puede generar datos corruptos.

   Este método archiva todos los datos de las bases de datos PostgreSQL y MongoDB. Se recomienda hacer esta copia de seguridad durante los periodos de mantenimiento.
   Copias de seguridad de las bases de datos PostgreSQL

   Verifique los nombres para las bases de datos PostgreSQL de Red Hat Satellite. Los nombres predeterminados de base de datos son foremanschema y candlepin. Busque los valores predeterminados en la página de manual katello-configure o en el archivo /usr/share/katello/install/default-answer-file. Si la instancia Red Hat Satellite no usa los nombres predeterminados, verifique katello-configure.conf, el cual almacena todas las opciones provistas para el comando katello-configure y busque db_name.

   # grep db_name /etc/katello/katello-configure.conf

   Ejecute el comando pg_dump para crear en línea copias de seguridad de base de datos. No es necesario detener PostgreSQL ni Red Hat Satellite, y este proceso no bloquea usuarios registrados. Sin embargo, el proceso puede tardar unos minutos para terminar según el tamaño de las bases de datos.

   # runuser - postgres -c "pg_dump -Fc foremanschema > /backup/foreman.dump"
   # runuser - postgres -c "pg_dump -Fc candlepin > /backup/candlepin.dump"

   Nota

   Para obtener mayor información sobre copias de seguridad de PostgreSQL, consulte la página de manual pg_dump o visite http://www.postgresql.org/docs/8.4/static/backup.html.
   Copia de seguridad de la base de datos MongoDB

   Use las herramientas en línea para realizar una copia de seguridad de la base de datos Pulp (MongoDB) mientras que la base de datos se esté ejecutando. Ejecute el siguiente comando en el directorio de respaldo:

   # mongodump --host localhost --out $BDIR/mongo_dump

   Esta herramienta crea el directorio /backup/mongo_dump/pulp_database, incluidos los archivos JSON.

   Nota

   Para obtener mayor información, consulte la página de manual mongodump o visite http://www.mongodb.org/display/DOCS/Backups.
5. Verifique el proceso de copia de seguridad. El proceso crea los siguientes archivos y un directorio:

   # ls $BDIR
   candlepin.dump    
   config_files.tar.gz    
   elastic_data.tar.gz    
   katello.dump
   mongo_dump/
   pulp_data.tar
   

   Si realizó la copia de seguridad opcional fuera de línea de las bases de datos, entonces también aparecerán los siguientes archivos:

   mongo_data.tar.gz
   pgsql_data.tar.gz
   

   Ahora, Red Hat Satellite tiene una copia de seguridad. Red Hat Satellite debe estar en línea.

Procedimiento 15.3. Procedimiento para restaurar Red Hat Satellite

1. Prepare el host Red Hat Satellite para recuperación. Este proceso restablece la copia de seguridad en el mismo servidor que generó la copia de seguridad. Si el sistema original no está disponible, proporcione la misma configuración (nombre de host, dirección IP, etc) y ejecute katello–configure con las mismas opciones de la copia de seguridad de la configuración:

   # tar --selinux -xzvf config_files.tar.gz -C /tmp
   # katello-configure --answer-file=/tmp/etc/katello/katello-configure.conf

2. Cambie al directorio de la copia de seguridad.

   # export BDIR=/backup
   # chgrp postgres -R $BDIR
   # cd $BDIR

3. Verifique los nombres para las bases de datos PostgreSQL de Red Hat Satellite. Los nombres predeterminados de base de datos son foremanschema y candlepin. Busque todos los valores predeterminados en la página de manual o en /usr/share/katello/install/default-answer-file. Si la instancia Red Hat Satellite no usa los nombres predeterminados, verifique katello-configure.conf, el cual almacena todas las opciones provistas para el comando katello-configure y busque db_name.

   # grep db_name /etc/katello/katello-configure.conf

4. Detenga todos los servicios antes de recuperar las bases de datos:

   # katello-service stop
   # service postgresql stop
   

5. Recupere los archivos del sistema. Asegúrese de que los archivos se extraigan en el host correcto. Restablezca todos los archivos del sistema con los siguientes comandos ejecutados desde el directorio de la copia de seguridad:

   # tar --selinux -xzvf config_files.tar.gz -C /
   # tar --selinux -xzvf elastic_data.tar.gz -C /
   # tar --selinux -xvf pulp_data.tar -C /

6. Borre las bases de datos PostgreSQL de Red Hat Satellite, si existe alguna:

   # service postgresql start
   # runuser - postgres -c "dropdb foremanschema"
   # runuser - postgres -c "dropdb candlepin"

   Nota

   Es posible que aparezca el siguiente error al borrar la base de datos:

   database xxx is being accessed by other users

   Asegúrese de que todos los procesos estén detenidos.
7. Recupere las bases de datos PostgreSQL de Red Hat Satellite con los siguientes comandos:

   # runuser - postgres -c "pg_restore -C -d postgres /backup/katello.dump"
   # runuser - postgres -c "pg_restore -C -d postgres /backup/candlepin.dump"

   Nota

   Para mayor información sobre las copias de seguridad de PostgreSQL consulte la página del manual pg_dump o visite http://www.postgresql.org/docs/8.4/static/backup.html.
8. Asegúrese de que MongoDB esté ejecutándose y borre los datos viejos:

   # service mongod start
   # echo 'db.dropDatabase();' | mongo pulp_database

9. Ejecute el siguiente comando proporcionando el --username y --password en el directorio de archivadores de copias de seguridad.

   # mongorestore --host localhost mongo_dump/pulp_database/

   Nota

   Para mayor información, consulte la página del manual mongorestore o visite http://www.mongodb.org/display/DOCS/Backups.
10. Reinicie todos los procesos de Red Hat Satellite:

    # service postgresql start
    # katello-service start
    

11. Revise los archivos de registro, marque audit.log para negaciones e intente hacer ping en la instancia Red Hat Satellite :

    # hammer -u admin -p admin ping

1. En la esquina superior derecha, haga clic en Red Hat Access → Búsqueda.
2. Haga clic en Ingresar en la esquina derecha del panel para entrar a Red Hat Customer Portal.

   Nota

   Para acceder a recursos de Red Hat Customer Portal, necesita ingresar con su identificación de usuario y contraseña de Red Hat Customer Portal.
3. Ingrese su búsqueda en el campo Red Hat Search:. El resultado de la búsqueda se despliega en la lista de Recomendaciones
4. Haga clic en la lista de Recomendaciones para ver el artículo de soluciones. La solución aparecerá en el panel principal.

1. En la esquina superior derecha, haga clic en Red Hat Access → Registros.
2. Haga clic en Ingresar en la esquina derecha del panel para entrar a Red Hat Customer Portal. Si ya ha ingresado, omita este paso.

   Nota

   Para acceder a recursos de Red Hat Customer Portal, necesita ingresar con su identificación de usuario y contraseña de Red Hat Customer Portal.
3. En el árbol de archivos a la izquierda, seleccione un archivo de registro y haga clic en el nombre de archivos.
4. Haga clic en Seleccionar archivo para elegir este archivo para consulta. Aparece una ventana independiente con el contenido de archivo de registro.
5. Resalte cualquier sección de texto del archivo de registro. Al resaltar las secciones de texto, se activa el botón Diagnóstico Red Hat
6. Haga clic en Diagnóstico Red Hat. Así, enviará la información resaltada a Red Hat Customer Portal y proporcionará soluciones relacionadas muy de cerca con la información de registro provista.
7. Si una de las soluciones presentadas:
   • Coincide con el problema que tiene, haga clic en la solución y siga los pasos requeridos para identificar y resolverlo.
   • No coincide con el problema, haga clic en Abrir un caso de soporte.

1. En la esquina superior derecha, haga clic en Red Hat Access → Soporte → Mis casos.
2. Haga clic en Ingresar en la esquina derecha del panel para entrar a Red Hat Customer Portal. Si ya ha ingresado, omita este paso.

   Nota

   Para acceder a recursos de Red Hat Customer Portal, necesita ingresar con su identificación de usuario y contraseña de Red Hat Customer Portal.
3. Busque el caso de soporte específico de los casos existentes:
   1. Al proporcionar una palabra clave o frase en el campo de Búsqueda.
   2. Al elegir un Grupo de caso específico de la lista desplegable. Los Grupos de casos son definidos dentro de Red Hat Customer Portal por su organización.
   3. Elija un estatus de caso.
4. Elija entre los resultados, un caso de soporte específico y haga clic en el ID de caso.

1. En la esquina superior derecha, haga clic en Red Hat Access → Soporte → Nuevo caso.
2. Haga clic en Ingresar en la esquina derecha del panel para entrar a Red Hat Customer Portal. Si ya ha ingresado, omita este paso.

   Nota

   Para acceder a recursos de Red Hat Customer Portal, necesita ingresar a su identificación de usuario y contraseña de Red Hat Customer Portal.
3. Los campos de Producto y Versión del producto se llenan automáticamente. Llene los campos relevantes:
   • Resumen - un resumen del problema
   • Descripción - una descripción detallada del problema.

     Nota

     Aparecerán en el panel principal recomendaciones para posibles soluciones basadas en el resumen.
4. Haga clic en Siguiente.
5. En la segunda pantalla, elija lo apropiado:
   • Gravedad - Se basa en la urgencia del tiquete, puede clasificarse como 4 (baja), 3 (normal), 2 (alta> y 1 (urgente).
   • Grupo de casos - Se basa en el quién debe ser notificado. Los grupos de casos pueden asociarse al caso de soporte. Los grupos de casos solo pueden seleccionarse en Red Hat Satellite. Los grupos de caso se crean dentro del portal del cliente.
6. Adjunte los archivos requeridos. Agregue una descripción de archivo y haga clic en Adjuntar.
   Para asegurarse de que la información necesaria se proporcione, se recomienda adjuntar la salida de los siguientes comandos:

   # sosreport
   # foreman-debug
   

   Importante

   Durante la recolección de la información, foreman-debug retira toda la información de seguridad, tal como la contraseña, token y llave. Sin embargo, el tarball aún puede contener información confidencial sobre Red Hat Satellite Server. Se recomienda enviar la información directamente al destinatario y no de manera pública.

   Nota

   Los nombres de archivos tienen un límite de 80 caracteres. El tamaño máximo para adjuntos de archivos cargados a la red es de 250 MB. Utilice FTP para archivos más grandes.
7. Haga clic en Enviar.