G.3 Utilidad del agente de Migrate para Linux

G.3.1 Descarga e instalación del agente de Migrate en una carga de trabajo Linux de origen

Antes de instalar la utilidad del agente de Migrate para Linux, asegúrese de que el equipo de origen tiene instalada la biblioteca GNU C (glibc) 2.11.3 o una versión superior.

Asegúrese de que descarga la aplicación con la arquitectura adecuada para sus equipos Linux de origen. El nombre del archivo distingue entre mayúsculas y minúsculas.

  • 64 bits: MigrateAgent-x86_64.tar.gz

  • 32 bits: MigrateAgent-x86.tar.gz

Para descargar e instalar la utilidad del agente de Migrate para Linux en la carga de trabajo de origen:

  1. Entre en la carga de trabajo Linux de origen como usuario Root.

  2. Utilice uno de estos métodos para obtener el archivo MigrateAgent-arq.tar.gz.

    Sustituya arq con la arquitectura adecuada (x86_64 o x86).

    • Descargue el archivo comprimido de la interfaz Web:

      1. En un navegador Web, lance la interfaz Web de PlateSpin Migrate y entre.

        https://<Servidor_de_PlateSpin>/Migrate

        Sustituya Servidor_de_PlateSpin por el nombre DNS o la dirección IP del servidor de PlateSpin Migrate.

      2. Haga clic en la pestaña Downloads (Descargas).

      3. Haga clic en el enlace de la aplicación del agente de Migrate para la plataforma Linux apropiada (x86_64 o x86) y, a continuación, guarde el archivo MigrateAgent-arq. tar.gz.

      -O bien-

    • Utilice el comando wget para copiar el archivo desde el servidor de PlateSpin.

      NOTA:si el sistema operativo del host del servidor de PlateSpin acepta solo conexiones TLS 1.2, utilice wget versión 1.16.1 o superior en la carga de trabajo Linux de origen.

      1. Lance un terminal e introduzca:

        wget --no-check-certificate --http-user=<username> --http-password=<password> https://<Your_PlateSpin_Server>/Migrate/Downloads/MigrateAgent-<arch>.tar.gpz 

        Sustituya Servidor_de_PlateSpin por el nombre DNS o la dirección IP del servidor de PlateSpin Migrate. Sustituya arq por x86_64 o x86.

  3. Abra el archivo MigrateAgent-arq.tar.gz en el Administrador de archivos y extraiga el directorio MigrateAgent y su contenido en el directorio raíz (/).

    Como alternativa, en un indicador de shell, introduzca lo siguiente:

    tar xvf MigrateAgent-<arch>.tar.gz

    Sustituya arq por x86_64 o x86.

  4. Cambie al directorio /MigrateAgent y muestre su contenido. En un terminal, introduzca:

    cd MigrateAgent
    ls

    El directorio contiene un archivo commands y el archivo de guion MigrateAgent.

  5. Para acceder a la ayuda, introduzca:

    ./MigrateAgent -h

G.3.2 Comandos del agente de Migrate para Linux

La sintaxis para ejecutar la utilidad del agente de Migrate es:

./MigrateAgent [Command] [-h]

En la Tabla G-2 se describen las opciones y los argumentos disponibles para el comando MigrateAgent en Linux.

Tabla G-2 Opciones de comandos y argumentos de la utilidad del agente de Migrate para Linux

Uso

Descripción

Comandos

register <servidor> <usuario> [[-p contraseña] | [-pf <vía-al-archivo-de-contraseña>]]

Para servidor, especifique el nombre DNS o la dirección IP de su servidor de PlateSpin Migrate.

Para usuario, especifique un nombre de usuario del servidor de PlateSpin válido con derechos de administrador para añadir una carga de trabajo.

Para la contraseña, realice una de estas acciones:

  • Utilice la opción -p y escriba en el comando la contraseña para el usuario de PlateSpin especificado.

    -p micontraseña

  • Use la opción -pf para especificar la vía a un archivo que contenga la contraseña para el nombre de usuario especificado del servidor de PlateSpin.

    -pf /tmp/archivo-contreña-juansalas.txt

  • No especifique la contraseña en el comando. Se le pedirá que la introduzca en la línea de comandos.

Ejemplo:

./MigrateAgent register 10.10.10.101 jsmith -p jspwd 

Registra este equipo como una carga de trabajo en el servidor especificado. También comprueba si hay actualizaciones del controlador en el servidor de PlateSpin especificado.

Permite añadir cargas de trabajo que no se pueden descubrir. Las cargas de trabajo registradas difieren de las cargas de trabajo descubiertas de las siguientes maneras:

  • Las cargas de trabajo de origen registradas no almacenan las credenciales de origen.

  • Debe utilizar el agente de Migrate para instalar, actualizar y eliminar los controladores blkwatch de Linux de las cargas de trabajo de origen registradas.

  • Después de suprimir el contrato de una carga de trabajo de origen registrada, debe eliminar manualmente el controlador OFX de la carga de trabajo. Consulte Sección 42.2.2, Limpieza de las cargas de trabajo Linux.

status [<servidor>]

Para servidor, especifique el nombre DNS o la dirección IP de su servidor de PlateSpin Migrate.

Muestra el estado de instalación de los controladores de PlateSpin.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

driver-install [<servidor>]

Para servidor, especifique el nombre DNS o la dirección IP de su servidor de PlateSpin Migrate.

Instala al controlador blkwatch de PlateSpin adecuado.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

driver-upgrade [<servidor>]

Para servidor, especifique el nombre DNS o la dirección IP de su servidor de PlateSpin Migrate.

Actualiza el controlador blkwatch de PlateSpin instalado.

Si especifica el servidor de PlateSpin, se comprobará si hay actualizaciones del controlador en el servidor.

driver-uninstall

Desinstala el controlador blkwatch de PlateSpin instalado de la carga de trabajo Linux de origen.

configure <servidor> <nuevo-servidor>

Para servidor, especifique el nombre DNS o la dirección IP de su servidor de PlateSpin Migrate.

Para nuevo-servidor, especifique el nombre DNS o la dirección IP nuevos del servidor de PlateSpin Migrate.

Ejemplo:

./MigrateAgent configure 10.10.10.10 10.10.20.20

Detiene el servicio del controlador OFX (ofxcontroller), modifica el archivo de configuración del controlador OFX con la nueva dirección y reinicia el servicio. Si modifica la dirección IP pública del servidor de PlateSpin, debe ejecutar este comando en cada una de las cargas de trabajo de origen que se configuren para el servidor.

Opciones de comando

servidor

Especifica el nombre DNS o la dirección IP del servidor de PlateSpin Migrate.

Descarga los controladores blkwatch del servidor especificado cuando se invocan las opciones status, driver-install o driver-upgrade.

user

Especifica el nombre de usuario del servidor de PlateSpin para un usuario administrador con derechos para añadir una carga de trabajo.

Opciones

-h, --help

Muestra el uso y las opciones del comando.

-p, --password

-p <contraseña_de_usuario>

Especifica la contraseña para el nombre de usuario del servidor de PlateSpin.

Si excluye la contraseña de la línea de comandos, el guion se la solicitará. La contraseña se oculta a medida que la escribe y no aparece en la lista de procesos.

No combine esta opción con passwordfile.

-pf, --passwordfile

-pf <vía_del_archivo_de_contraseña>

Especifica la vía a un archivo que contiene la contraseña para el nombre de usuario del servidor de PlateSpin especificado.

No combine esta opción con password.

Registro

logging.json

Contiene los valores de configuración de registro en formato JSON para las acciones de registro de la utilidad del agente de Migrate.

Para ver los valores de registro, utilice el comando cat:

cat MigrateAgent/logging.json

Puede editar el archivo en un editor de texto. Establezca el nivel de registro cambiando el valor "level:" de "DEBUG" a "INFO" o "ERROR". Por ejemplo:

"level": "DEBUG"

O bien

"level": "INFO"

O bien

"level": "ERROR"

Los mensajes registrados se escriben por defecto en el archivo MigrateAgent.log en el directorio MigrateAgent. Puede modificar el valor del nombre del archivo de registro en el archivo logging.json.

MigrateAgent.log

Contiene los mensajes registrados para el comando MigrateAgent. Para ver el registro, utilice el comando cat.

cat MigrateAgent.log