J.2 Antes de usar la herramienta

J.2.1 Configuración previa de los valores del servidor de Migrate para la CLI

Antes de empezar a usar la utilidad de línea de comandos, debe asegurarse de que el servidor de Migrate se ha configurado correctamente. Puede comprobar la configuración en el archivo PlateSpin.Migrate.Console.exe.config, situado en la misma vía que la utilidad de línea de comandos. Después de instalar Migrate, el siguiente archivo config ya debe contener valores.

<?xml version="1.0" encoding="utf-8 ?>"
<configuration>
  <appSettings>
    <add key="MigrateServerURL" value="https://localhost/PlateSpinMigrate/"/>
    <add key="ServerDomain" value=""/>
    <add key="psuser" value="administrator"/>
    <add key="pspassword" value="encoded_password"/>
    <add key="encoded" value="yes"/>
  </appSettings>
</configuration>

La herramienta usa estos valores cuando ejecuta comandos. Debe reconciliar los valores del archivo con la configuración del servidor de Migrate con el que desea conectar.

El valor de la clave pspassword está vacío por defecto y debe especificar una contraseña cifrada como valor. Para cifrar la contraseña, utilice el comando encode. Para obtener más información acerca de los comandos, consulte la Sección J.2.2, Familiarización con los comandos.

Si decide proporcionar contraseñas cifradas para las plataformas de destino y las cargas de trabajo de origen, defina el valor de la clave cifrada en la siguiente línea del archivo PlateSpin.Migrate.Console.exe.config con el valor yes (sí). De lo contrario, emplee el valor no.

<add key ="encoded" value="no"/>

J.2.2 Familiarización con los comandos

Para mostrar los comandos admitidos en la herramienta, ejecútela con la opción Help o con la opción ? desde el indicador de comandos, como en este ejemplo:

C:\Archivos de programa\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe Help

La herramienta muestra una matriz que incluye información similar a la mostrada en la tabla siguiente:

Tabla J-1 Comandos disponibles en la herramienta de interfaz de línea de comandos de Migrate

Comando

Descripción

run

Ejecuta un archivo .ini configurado como si fuera un trabajo programado. Cuando se añade el parámetro /wait=no y el trabajo empieza a ejecutarse, su ID de trabajo se muestra en la interfaz.

query

Ejecuta una consulta en el trabajo (si se especifica un ID de trabajo) para mostrar su estado actual.

discover

Ejecuta una operación que realiza un inventario de los detalles de una carga de trabajo admitida o un equipo de destino como preparación para la migración o para "convertir" el trabajo.

refresh

Actualiza un servidor descubierto.

unDiscover

Anula el descubrimiento de un servidor.

imageserver

Realiza operaciones de generación de imágenes en una carga de trabajo (es decir, instalar el servidor, desinstalar el servidor o actualizar las herramientas) en un servidor.

abort

Aborta un trabajo programado.

licenseInfo

Muestra la información de licencia del servidor de migración.

serversync

Prepara el servidor para la operación de Server Sync y ejecuta una tarea serversync empleando el archivo de configuración.

encode

Cifra la entrada de texto o los datos del archivo de texto.

massdiscover

Permite realizar un descubrimiento masivo de cargas de trabajo de origen y de destinos. Las cagas de trabajo y los destinos descubiertos se muestran tanto en el cliente como en la interfaz Web de PlateSpin Migrate.

Para descubrir cargas de trabajo y destinos en masa, primero debe mostrar las cargas de trabajo y los destinos que desea descubrir en un archivo CSV. Para crear este archivo CSV, consulte el archivo CSV de muestra situado en \Cliente de PlateSpin Migrate\CommandLine\Sample INI\MassDiscovery.csv.

Si se ejecuta uno de estos comandos, debe incluir sus parámetros requeridos en la línea de comandos. También puede incluir parámetros opcionales, si se precisan. Por ejemplo, el parámetro savejob= guarda la tarea en la ubicación por defecto.

Para mostrar una lista de estos parámetros en el indicador de comandos, ejecute el comando sin ningún parámetro. Por ejemplo, si ejecuta el comando discover sin parámetros, como en este ejemplo:

C:\Archivos de programa\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover

La interfaz de línea de comandos muestra lo siguiente:

[discover]                      discovers a server
Required Parameters:
    /machineAddress=      machine address to discover
    /userName=            the username to use   
    /password=            the password to use        
    /type=                type like windows, linux,vmware_esx,vmware_vcenter,
    Optional Parameters:
    /network=             network name to connect to
    /address=             server address to connect to
    /psuser=              Username used for accessing PlateSpin Migrate server as user different from the one logged on this computer
    /pspassword=          Password used for accessing Platespin Migrate server for the user different from the one logged on this computer
    /wait=                wait for completion of job [yes,no]
    /clusterName=         clustername to be discovered
    /verbose=             verbose mode for output [on,off]
    /output=              the output file
    /format=              the ouptput format to display in [text,html,xml]
    /sslcertificatewarnings=      Whether to Ignore or Enforce SSL Certificate Warnings [Ignore| Enforce]    

NOTA:debe familiarizarse con los distintos comandos de la interfaz de línea de comandos y sus parámetros necesarios y opcionales respectivos.

Sintaxis de la línea de comandos

Si tuviera que ejecutar el comando discover (que es también un trabajo), debe usar una sintaxis similar a la de este ejemplo en el indicador de comandos:

C:\Archivos de programa\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe discover /machineaddress=10.10.8.100 /username=administrator /password=password /type=windows /wait=no

Tenga en cuenta que en este ejemplo se incluyen todos los parámetros obligatorios y uno opcional.

Cuando se inicia el comando discover (trabajo), la herramienta de CLI muestra el ID de trabajo, que es similar al de este ejemplo:

8be8d306-7665-4869-9795-a9dbb3ce1471

Puede aprovechar este ID para averiguar el estado del trabajo. Solo tiene que usar el comando query como en este ejemplo:

C:\Archivos de programa\PlateSpin Migrate Client\CommandLine>PlateSpin.Migrate.Console.exe query /id=8be8d306-7665-4869-9795-a9dbb3ce1471

El comando query presenta un informe de estado que incluye todos los detalles del trabajo. Se trata del mismo tipo de información que se muestra en la vista de trabajos del cliente de Migrate.