Implementación con MDM
Si gestionas Mac con una herramienta de gestión de dispositivos (MDM), como Jamf Pro, Kandji o Microsoft Intune, puedes activar VMPal en ellos con un archivo de clave de licencia. VMPal lee el archivo al iniciarse o cuando el archivo cambia, y activa la clave por su cuenta. También puedes exigir la clave de tu organización, para que VMPal no se pueda usar sin ella. Y, en el Administrador de licencias, puedes desactivar funciones y elegir la versión a la que se actualizan los Mac. VMPal para Windows también lee archivos de clave: consulta En equipos con Windows.
Los archivos de clave de licencia y las restricciones que se describen a continuación requieren una versión de VMPal compatible con ellos. Las versiones anteriores los ignoran.
Crea el archivo de clave
El archivo de clave es un archivo de texto sin formato llamado .vmpallicensekey. Escribe tu clave de licencia en la primera línea:
VP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
require: true
La línea require es opcional:
require: true: VMPal no se puede usar hasta que se active la clave, y los usuarios no pueden activar otra clave.require: false, o sin línearequire: activa la clave, pero permite que los usuarios conserven o activen su propia licencia mientras la tuya no se pueda activar.
Algunos detalles:
- También puedes escribir la clave como
key: VP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. requiretambién aceptayesyno,1y0, uonyoff, yrequire = truetambién funciona. Cualquier otro valor cuenta comotrue.- Las líneas que empiezan por
#son comentarios. VMPal ignora los campos que no conoce. - Un archivo con solo líneas en blanco y comentarios cuenta como si no hubiera archivo. Un archivo con campos pero sin clave se ignora. La excepción es
require: trueen/Users/Shared: aunque no haya clave, sigue exigiendo una, así que VMPal no se puede usar hasta que el archivo tenga una clave. - Guárdalo como texto UTF-8.
Instala el archivo de clave
Instala el archivo en /Users/Shared/.vmpallicensekey, con root como propietario y con permiso de escritura solo para root (propietario root:wheel, modo 0644). Así, VMPal activa la clave para todos los usuarios del Mac y usa un solo puesto para el Mac.
Ejecuta este script como root, por ejemplo, como un script de tu política de MDM. Para activar la clave sin exigirla, quita "require: true".
#!/bin/sh
set -eu
KEY="VP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
KEY_FILE="/Users/Shared/.vmpallicensekey"
# Any user can create files in /Users/Shared: write the file under a new name
# only root can change, then move it over whatever is at KEY_FILE. -h replaces
# a link there instead of following it
TMP_FILE=$(mktemp /Users/Shared/.vmpallicensekey.XXXXXX)
printf '%s\n' "$KEY" "require: true" > "$TMP_FILE"
chown root:wheel "$TMP_FILE"
chmod 0644 "$TMP_FILE"
rm -rf "$KEY_FILE"
mv -fh "$TMP_FILE" "$KEY_FILE"
# Fails if a user made a folder there meanwhile: run the script again
[ -f "$KEY_FILE" ] && [ ! -L "$KEY_FILE" ]
Mantén root como propietario del archivo y el permiso de escritura solo para root, como hace el script. VMPal aplica cualquier archivo de clave de
/Users/Shared, sea quien sea su propietario. Un usuario propietario del archivo puede modificarlo o eliminarlo, así que un archivo que un usuario puede modificar le permite saltarserequire. Instala el propio archivo, no un enlace simbólico: VMPal ignora un enlace simbólico en/Users/Shared/.vmpallicensekey. Un enlace físico se lee como el propio archivo: otro nombre para el archivo, en cualquier lugar del Mac, no cambia nada.
VMPal guarda la licencia activada junto al archivo de clave, en /Users/Shared/.vmpallicense, para que la compartan todos los usuarios del Mac y ninguno ocupe otro puesto. Si creas ese archivo de antemano, haz que todos los usuarios puedan escribir en él (modo 0666). Si existe y un usuario no puede escribir en él, la activación falla con “VMPal no pudo guardar la licencia en /Users/Shared”. Junto a él, VMPal guarda la última política del propietario de la licencia, en .vmpallicensepolicy.
También puedes instalar un archivo de clave para un solo usuario, en ~/Library/Application Support/com.tableplus.VMPal/.vmpallicensekey. En ese caso, VMPal guarda la licencia de ese usuario en la misma carpeta. Los usuarios pueden eliminar archivos de su propia carpeta, así que VMPal ignora require ahí. Un archivo de clave en /Users/Shared tiene prioridad sobre uno en la carpeta de un usuario.
Lo que ven los usuarios
VMPal lee el archivo de clave al abrirse y, mientras está abierto, detecta un archivo de clave nuevo o modificado en aproximadamente un minuto.
Con el archivo de clave en /Users/Shared |
Lo que hace VMPal |
|---|---|
| Sin licencia | Activa tu clave sin preguntar. |
| Con una licencia que introdujo el usuario | Indica “Tu organización gestiona VMPal en este Mac” y activa tu clave en lugar de la suya. Su licencia se quita del Mac y su puesto queda libre. |
| Ya activado con tu clave | Nada. Ajustes › Licencia indica “VMPal está activado con la clave de licencia que tu administrador configuró en este Mac” y muestra Activado para: Todos los usuarios de este Mac. Desactivar este Mac está oculto. |
Si tu clave no se puede activar, VMPal explica el motivo en “Activar la clave de licencia ****1234”, con los 4 últimos caracteres de tu clave. Ofrece:
- Reintentar, cuando VMPal no pudo conectar con el servidor de licencias o el servidor tuvo un problema.
- Escribir al propietario de la licencia, cuando todos los puestos están en uso o han terminado las actualizaciones de la licencia. Abre un correo dirigido al administrador secundario de licencias, o a su propietario si no lo hay, con los 4 últimos caracteres de la clave, el motivo, el nombre del Mac y las versiones de macOS y de VMPal.
- Descargar la versión anterior, cuando esta versión de VMPal se publicó después de que terminaran las actualizaciones de la licencia, o Descargar VMPal, cuando esta compilación se retiró. Ambos descargan la versión más reciente que cubre la licencia, o la versión que elegiste en Actualizaciones.
- Probar otra clave y Usar la versión gratuita en un Mac sin licencia, salvo que la clave sea obligatoria. Aceptar en los demás casos.
VMPal muestra esta alerta como máximo una vez por apertura, y vuelve a intentar activar tu clave más tarde. Un usuario que conserva su propia licencia, sin require, la mantiene hasta que VMPal activa tu clave en un intento posterior.
Con require: true
- Hasta que se active tu clave, VMPal muestra “Activando la clave de licencia ****1234” antes de cargar tus máquinas virtuales y el Hub, abrir una ventana, restaurar sus pestañas de terminal, iniciar las máquinas virtuales que se inician al iniciar sesión o responder a los agentes de programación y a
vmpal. Cuando VMPal se abre al iniciar sesión, aparece en el Dock y rebota hasta que alguien lo mira. - Si la activación falla, VMPal explica el motivo y ofrece Reintentar; Escribir al propietario de la licencia cuando todos los puestos están en uso o han terminado las actualizaciones; Descargar la versión anterior cuando la versión es demasiado nueva para la licencia; Descargar VMPal cuando esta compilación se retiró, y Salir. Salir conserva las pestañas de terminal que VMPal restaura en la siguiente apertura.
- VMPal también vuelve a intentarlo por su cuenta: cada minuto después de un error de red o del servidor, y cada 15 minutos en los demás casos. Vuelve a leer el archivo de clave cada minuto, así que un archivo de clave corregido surte efecto en menos de un minuto.
- Los usuarios no pueden activar otra clave. Ajustes › Licencia muestra la tuya, enmascarada, con Activar. Una clave escrita ahí, o que llega desde un enlace
vmpal://license/activate, recibe “Este Mac solo se puede activar con la clave de licencia ****1234 de tu organización. Contacta con tu administrador para cambiarlo.” - VMPal nunca se cierra en mitad de una sesión. Si el Mac pierde su licencia mientras VMPal está abierto, VMPal intenta volver a activar tu clave y, si no puede, indica “VMPal no se podrá volver a abrir hasta que se active esta clave”. Hasta que se active la clave, las máquinas virtuales en marcha siguen funcionando, pero no se inicia ninguna máquina virtual,
vmpalno puede usar VMPal y VMPal queda bloqueado en su siguiente apertura. - Si instalas o cambias el archivo de clave mientras VMPal está abierto, VMPal activa tu clave en aproximadamente un minuto. Hasta entonces, una licencia que VMPal activó desde un archivo de clave sigue funcionando, máquinas virtuales incluidas, pero con una licencia que introdujo un usuario no se inicia ninguna máquina virtual y
vmpalno puede usar VMPal. - La primera apertura necesita conectar con vmpal.com.
Las máquinas virtuales y la línea de comandos
Cada máquina virtual se ejecuta en un proceso propio, que puede iniciarse sin la ventana de VMPal: desde el icono de la máquina virtual en el Dock, al iniciar sesión en el caso de una máquina virtual configurada con Iniciar al iniciar sesión, o desde vmpal. Estos procesos, y vmpal, leen ellos mismos los archivos de licencia, así que siguen las mismas reglas:
- Con
require: true, mientras el Mac no tenga la licencia de tu clave, una máquina virtual no se inicia. Indica “La máquina virtual no se puede iniciar”, con Abrir VMPal, que abre VMPal para activar la clave. - En ese mismo caso, los comandos de
vmpalque necesitan VMPal fallan al instante con “VMPal can't be used until it's activated with your organization's license key ****1234, as device management requires. Open VMPal to activate it.” - Una licencia que VMPal activó desde un archivo de clave es la excepción: mientras VMPal activa tu clave en su lugar, por ejemplo, después de que cambies la clave, las máquinas virtuales siguen iniciándose y
vmpalsigue funcionando con ella. - Las restricciones que se describen a continuación también se aplican en cada máquina virtual.
Restringe funciones y actualizaciones
En el Administrador de licencias, la sección Política de VMPal de una clave de licencia se aplica a todos los Mac y equipos con Windows activados con esa clave, ya sea con un archivo de clave o a mano. Pueden cambiarla el propietario de la licencia y su administrador secundario de licencias. Abre el Administrador de licencias con un enlace de acceso.
| Ajuste | Lo que hace en los Mac |
|---|---|
| Desactivar los agentes de programación (MCP y control por agentes) | Desactiva los servidores MCP de VMPal, la opción de añadir VMPal a los agentes de programación y el control por agentes de todas las máquinas virtuales. vmpal rechaza sus comandos. Los scripts del Hub que se ejecutan en máquinas virtuales también se omiten, porque necesitan el control por agentes |
| Desactivar los scripts del Hub en el Mac | Omite las ejecuciones de los scripts que se ejecutan en el propio Mac, tanto desde Ejecutar ahora como desde vmpal. Los agentes y vmpal no pueden hacer que un script se ejecute ahí. Los scripts en máquinas virtuales se siguen ejecutando |
| Desactivar los informes de errores | Desactiva los informes de errores de VMPal y de las máquinas virtuales |
| Desactivar las carpetas compartidas | Desactiva las carpetas compartidas en todas las máquinas virtuales |
| Desactivar el portapapeles y la función de arrastrar y soltar | Desactiva el portapapeles compartido y la opción de arrastrar archivos hacia las máquinas virtuales y desde ellas, en todas las máquinas virtuales. Con el control remoto, también se desactiva soltar archivos en la pantalla de otro Mac y arrastrarlos desde ella |
| Desactivar el control remoto | Otros Mac no pueden conectarse al Mac, y el Mac no puede conectarse a otros: su interruptor de Control remoto queda desactivado, y ni sus ventanas, ni Añadir ordenador…, ni los agentes de programación pueden llegar a otros Mac |
| Actualizaciones | Automático (última versión disponible) actualiza los Mac a la versión más reciente que permite la licencia. Elige una versión para mantenerlos en ella hasta que la cambies aquí |
Las carpetas compartidas, el portapapeles y el control remoto requieren VMPal 0.95 o posterior en los Mac. Las versiones anteriores desactivan las carpetas compartidas y el portapapeles a la vez, y solo mientras desactives ambos.
En los Mac, los ajustes de lo que desactivas aparecen atenuados, con “Desactivado por el propietario de la licencia. Contacta con tu administrador para desbloquearlo”. Ajustes › Licencia los enumera en Restricciones. A los agentes de programación y a vmpal se les indica “The license owner turned off coding agents for VMPal on this Mac. Contact your admin to unlock it”. Cada máquina virtual conserva sus propios ajustes, que vuelven a aplicarse cuando reactivas una función.
Actualizaciones enumera la versión que estaba vigente cuando se compró la licencia y las posteriores que cubre la licencia. Con una versión elegida, VMPal no instala una más reciente ni vuelve a una anterior: un Mac que ya tiene una versión más reciente se queda en ella. Las pantallas de actualización y Ajustes › Información indican “El propietario de la licencia aprobó las actualizaciones hasta la compilación 88”. Una actualización que VMPal descargó antes de que eligieras una versión se sigue instalando cuando VMPal se cierra. Si retiramos la versión que elegiste, los Mac se actualizan como con Automático (última versión disponible).
VMPal detecta un cambio al abrirse, cuando pasa a primer plano (como máximo una vez por hora) y, en los Mac con un archivo de clave, cada 6 horas. El cambio se aplica al instante, en VMPal y en las máquinas virtuales en marcha, salvo en estos casos:
- Los informes de errores que se vuelven a activar empiezan en la siguiente apertura de VMPal, o de cada máquina virtual.
- Las carpetas compartidas de una máquina virtual con macOS 13 cambian cuando la máquina virtual se vuelve a iniciar.
- Las ejecuciones del Hub que ya están en curso continúan. Las que siguen en espera se omiten.
Un Mac que pierde su licencia conserva la última política mientras el archivo de clave siga instalado. Si no ves la sección de la política, pídenos que la activemos para tu clave de licencia.
Si tu herramienta de MDM instala ella misma las actualizaciones de VMPal, instala solo las versiones que cubre tu licencia, o la versión que elegiste en Actualizaciones. Una versión publicada después de que terminaran las actualizaciones de la licencia no se puede activar y, con
require: true, VMPal queda bloqueado hasta que se instala una compilación anterior.
Cambia o quita la clave
- Cambiar la clave: sustituye el archivo, por ejemplo, con el script anterior. VMPal activa la clave nueva en aproximadamente un minuto, o en su siguiente apertura si no está abierto. La licencia antigua sigue funcionando hasta que se activa la clave nueva, máquinas virtuales incluidas. Sin embargo, con
require: true, la clave exigida es la nueva: hasta que se active, la siguiente apertura de VMPal la espera. - Generar una nueva clave en el Administrador de licencias: actualiza también el archivo de clave con la clave nueva. Los Mac que ya están activados siguen funcionando, pero un Mac que necesite activarse no puede usar la clave antigua y, con
require: true, queda bloqueado. - Liberar un Mac: elimina el archivo de clave (
rm -f /Users/Shared/.vmpallicensekeycomo root) o vacíalo. En aproximadamente un minuto, o en su siguiente apertura si no está abierto, VMPal da de baja el Mac, lo que libera el puesto, quita la licencia y levanta las restricciones. Si en ese momento el Mac no puede conectar con vmpal.com, el puesto sigue ocupado: quita el Mac en el Administrador de licencias.
Un archivo de clave que VMPal no puede leer, como uno con campos pero sin clave, no cambia nada.
En equipos con Windows
VMPal para Windows también lee archivos de clave de licencia, con el mismo formato, y sigue las mismas reglas: las alertas, require y el cambio o la eliminación de la clave. Lo que cambia:
| En un equipo con Windows | |
|---|---|
| Archivo de clave para todos los usuarios | C:\ProgramData\VMPal\.vmpallicensekey, el único lugar en el que funciona require |
| Archivo de clave para un usuario | %LOCALAPPDATA%\VMPal\.vmpallicensekey |
| Licencia para todos los usuarios | C:\ProgramData\VMPal\.vmpallicense, cifrada para el equipo, con la última política al lado, en .vmpallicensepolicy |
| Lo que VMPal ignora de un archivo de clave | %LOCALAPPDATA%\VMPal\Logs\License.log |
Un archivo de clave puede estar en UTF-8, o en UTF-16 con marca de orden de bytes (BOM), como lo guardan el Bloc de notas y Windows PowerShell. VMPal ignora un archivo de clave que sea un enlace (un enlace simbólico o una unión de directorio) o que ocupe más de 1 MB.
Instala el archivo de clave en los equipos con Windows
Cualquier usuario puede crear una carpeta en C:\ProgramData, y quien la crea puede eliminar lo que contiene. Por eso, el script primero entrega C:\ProgramData\VMPal a los administradores, sea quien sea quien la creó. Ejecútalo como administrador o como SYSTEM, por ejemplo, como script de plataforma en Microsoft Intune. Para activar la clave sin exigirla, quita "require: true".
$ErrorActionPreference = "Stop"
$Key = "VP-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
$Folder = Join-Path $env:ProgramData "VMPal"
$KeyFile = Join-Path $Folder ".vmpallicensekey"
# Administrators own the folder. Users can read it and add files, such as
# VMPal's shared license, but can't change or delete the administrators' files
New-Item -ItemType Directory -Force -Path $Folder | Out-Null
takeown /F $Folder /A | Out-Null
$Acl = New-Object Security.AccessControl.DirectorySecurity
$Acl.SetOwner([Security.Principal.SecurityIdentifier]"S-1-5-32-544")
$Acl.SetAccessRuleProtection($true, $false)
$Both = "ContainerInherit, ObjectInherit"
foreach ($Rule in @(("S-1-5-18", "FullControl", $Both, "None"),
("S-1-5-32-544", "FullControl", $Both, "None"),
("S-1-5-32-545", "ReadAndExecute", $Both, "None"),
("S-1-5-32-545", "CreateFiles", "None", "None"),
("S-1-3-0", "FullControl", $Both, "InheritOnly"))) {
$Acl.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule(
[Security.Principal.SecurityIdentifier]$Rule[0], $Rule[1], $Rule[2], $Rule[3], "Allow")))
}
Set-Acl -LiteralPath $Folder -AclObject $Acl
# Written under a new name, then moved to the key file's path
$Temp = "$KeyFile." + [guid]::NewGuid().ToString("N")
[IO.File]::WriteAllLines($Temp, [string[]]($Key, "require: true"))
$Old = Get-Item -LiteralPath $KeyFile -Force -ErrorAction SilentlyContinue
if ($Old -and $Old.PSIsContainer) { throw "$KeyFile is a folder: delete it, then run this script again" }
# Deletes a link itself, never what it points to
if ($Old) { [IO.File]::Delete($KeyFile) }
# Fails if a user made a file there meanwhile: run the script again
Move-Item -LiteralPath $Temp -Destination $KeyFile
En los equipos con Windows:
- Con
require: true, VMPal muestra “Activating license key ****1234” antes de abrir su ventana, activar el control remoto o iniciar las máquinas virtuales configuradas para iniciarse al iniciar sesión. Al iniciar sesión, si no tiene nada que iniciar, VMPal no espera. - Hasta que se active tu clave, no se inicia ninguna máquina virtual: “Device management requires VMPal to be activated with your organization's license key ****1234 before VMs can start”. Los agentes de programación y
vmpalreciben un rechazo, como en el Mac. Una clave introducida a mano recibe “This PC can only be activated with your organization's license key ****1234. Contact your admin to change it.” - VMPal comprueba la licencia al abrirse y cada hora, y cada minuto mientras espera una clave obligatoria. Lee los archivos de clave cada minuto.
- Download the Old Build y Download VMPal descargan la versión más reciente de VMPal para Windows que cubre la licencia.
La política también se aplica a los equipos con Windows:
| Ajuste | Lo que hace en los equipos con Windows |
|---|---|
| Desactivar los agentes de programación (MCP y control por agentes) | El servidor MCP de VMPal y vmpal rechazan todas las llamadas, también desde dentro de las máquinas virtuales, y el control por agentes aparece atenuado en los ajustes de cada máquina virtual |
| Desactivar los scripts del Hub en el Mac | Nada: VMPal para Windows no tiene Hub |
| Desactivar los informes de errores | Desactiva los informes de errores de VMPal. Si se vuelven a activar, empiezan en la siguiente apertura de VMPal |
| Desactivar las carpetas compartidas | Desactiva las carpetas compartidas en todas las máquinas virtuales, incluidas las que están en marcha. Las copias de los agentes de programación siguen funcionando, salvo que también estén desactivados los agentes de programación |
| Desactivar el portapapeles y la función de arrastrar y soltar | Desactiva el portapapeles compartido, y la copia y el arrastre de archivos hacia las máquinas virtuales y desde ellas. Una sesión mejorada lo aplica a partir de su siguiente conexión. Con el control remoto, el portapapeles y la opción de soltar archivos quedan desactivados en ambos sentidos |
| Desactivar el control remoto | Otros equipos no pueden conectarse al equipo con Windows, y este no puede conectarse a otros. Las conexiones que ya están abiertas se cierran |
| Actualizaciones | Los equipos con Windows siempre se actualizan a la versión más reciente que permite la licencia. La versión que elijas se aplica a los Mac |
| Mensaje en un equipo con Windows | Qué hacer |
|---|---|
| VMPal couldn't save the license in C:\ProgramData\VMPal. | Vuelve a ejecutar el script: permite que todos los usuarios añadan archivos a la carpeta. |
| VMPal couldn't save the license on this PC. | Para un archivo de clave en la carpeta de un usuario, asegúrate de que el usuario pueda escribir en %LOCALAPPDATA%\VMPal. |
Solución de problemas
| Mensaje | Qué hacer |
|---|---|
| Todos los puestos de esta licencia están en uso. | Quita en el Administrador de licencias los Mac que ya no uses, o añade puestos. |
| Esta clave de licencia no es válida. | Comprueba la clave del archivo, sobre todo después de generar una nueva clave. |
| Esta versión de VMPal se publicó después de que terminaran las actualizaciones de la licencia. | Instala una compilación anterior con Descargar la versión anterior, o renueva la licencia. |
| Esta compilación se retiró del registro. Actualiza VMPal e inténtalo de nuevo. | Instala otra versión con Descargar VMPal, en la misma alerta: descarga la versión más reciente que cubre la licencia, o la versión que elegiste en Actualizaciones. |
| VMPal no pudo conectar con el servidor de licencias. Comprueba tu conexión de red e inténtalo de nuevo. | Asegúrate de que el Mac pueda conectar con vmpal.com por HTTPS. VMPal no sigue sus redirecciones. |
| VMPal no pudo guardar la licencia en /Users/Shared. | Quita /Users/Shared/.vmpallicense, o conviértelo en un archivo en el que todos los usuarios puedan escribir (modo 0666), no en un enlace. |
| VMPal no pudo guardar la licencia en este Mac. | Para un archivo de clave en la carpeta de un usuario, asegúrate de que el usuario pueda escribir en ~/Library/Application Support/com.tableplus.VMPal. |
| VMPal no pudo activar esta clave de licencia. | Vuelve a intentarlo más tarde y, si sigue ocurriendo, ponte en contacto con nosotros. |
| La máquina virtual no se puede iniciar | Abre VMPal, que activa tu clave. |
VMPal registra lo que ignora de un archivo de clave, como un campo que no conoce o un valor de require que interpreta como true. Para verlo:
log show --last 1d --predicate 'eventMessage CONTAINS "License key file"'
Un administrador local todavía puede quitar el archivo de clave. Para mantener todos los Mac en una versión que lea archivos de clave, gestiona las actualizaciones de VMPal con tu herramienta de MDM.