Descripción de Propiedades de Claves de Licencia

Las Ediciones Profesional y Estándar del Java Service Wrapper se activan a través de de un conjunto de Claves de Licencia. Las Claves de Licencia deben establecerse en la propiedad de Clave de licencia incluida como parte del archivo de configuración del Wrapper.

Lista de Propiedades de Claves de Licencia

A continuación se describe detalladamente cada tipo de propiedad de la clave de licencia (Clave de Licencia para Servidor, Clave de Licencia de Desarrollo).

  • wrapper.license.debug
  • wrapper.license.dev_application
  • wrapper.license.features
  • wrapper.license.host_id
  • wrapper.license.id
  • wrapper.license.key.<n>
  • wrapper.license.lease_term.begin_date
  • wrapper.license.lease_term.end_date
  • wrapper.license.licensee
  • wrapper.license.type
  • wrapper.license.upgrade_term.begin_date
  • wrapper.license.upgrade_term.end_date

¿Tiene dudas?

Si experimenta algún problema con su licencia, por favor configure la propiedad wrapper.license.debug y habilite la depuración del archivo de inclusión. En combinación, la mayoría de los problemas de configuración se hacen evidentes.

Descripción de Propiedades de Clave de Licencia para Servidor

Las Claves de Licencia para Servidor consisten en un conjunto de propiedades que se colocan directamente en archivo de configuración wrapper.conf o o incluidas usando un archivo de configuración en cascada. La clave de licencia está vinculada a un HostId específico.

El HostId de un srevidor se puede obtener al ejecutar wrapper -h desde un shell o símbolo del sistema en la ubicación del Wrapper binario (normalmente la carpeta bin). from within a shell or command prompt in the location of the binary (usually the bin folder). Esto resultará en la siguiente salida de datos:

Ejemplo de Salida de Datos:
Java Service Wrapper Professional Edition nn-bit n.n.n
  Copyright (C) 1999-20nn Tanuki Software, Ltd. All Rights Reserved.
    https://wrapper.tanukisoftware.com

The Java Service Wrapper requires a License Key to activate the
software.  Licenses can be purchased on the Java Service Wrapper
web site:
  https://wrapper.tanukisoftware.com/purchase

You can also immediately obtain a one-month Free trial license:
  https://wrapper.tanukisoftware.com/trial

License Keys can be generated for any of the following HostIds:
  HostId #1:   00123456789a
  HostId #2:   00123456789b

You may include license keys for several servers within a single file by
  prefixing the property names of each key with their respective
  server host name or HostId. Please use the following syntax:
  wrapper.<hostname|hostid>.license.*.
  The host name of this machine is: myhost

Cualquiera de los HostIds mostrados puede utilizarse para generar la clave de licencia.

Ejemplo de Clave de Licencia para Servidor:
wrapper.license.type=NODE
wrapper.license.id=200804010006
wrapper.license.licensee=Acme, Inc.
wrapper.license.host_id=00123456789a
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2024-04-01
wrapper.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.license.key.2=007d-7e3c-5e2a-427e
wrapper.license.key.3=ce16-f5f0-59f4-d18a
wrapper.license.key.4=b6ca-c31a-6be8-323d
  • El valor de wrapper.license.type siempre será 'NODE' para claves de Licencias para Servidor.

  • El valor de wrapper.license.id se usa para identificar de manera única a la Clave de Licencia y se mostrará en su página de Administrar Licencias.

  • El valor de wrapper.license.licensee se mostrará en la consola y en el archivo wrapper.log cada vez que se inicie el Wrapper. En el caso de la Clave de la Licencia anterior, el resultado será el siguiente:

    Java Service Wrapper Professional Edition nn-bit n.n.n
      Copyright (C) 1999-2023 Tanuki Software, Ltd.  All Rights Reserved.
        https://wrapper.tanukisoftware.org
      Licensed to Acme, Inc.
    
  • La propiedad wrapper.license.host_id identifica el servidor únicoen el que se autorizará la ejecución del Wrapper.

  • Los valores en wrapper.license.features se utilizan para describir el bit y la edición del Wrapper que se autoriza. En este caso, se autoriza 64-bit, Edición Profesional. Esto también autorizará la ejecución de las versiones inferiores 32-bit y Edición Estándar del Wrapper.

  • wrapper.license.upgrade_term.begin_date y wrapper.license.upgrade_term.end_date especifican las fechas de publicación del Wrapper autorizadas por la Clave de Licencia. La licencia anterior autorizará las versiones del Java Service Wrapper publicadas antes de 2024-04-01. Las versiones del Wrapper publicadas antes del La licencia en la parte de arriba autorizará la descarga de versiones del Wrapper que han sido liberadas antes de esta fecha 2024-04-01. Las versiones del Wrapper publicadas dentro del término de actualización especificado estarán autorizadas a actualizarse y también a ejecutarse incluso después de que el Término de Actualización haya terminado.

  • También puede aparecer un plazo de arrendamiento (lease term) opcional en algunas Claves de Licencias de prueba. Esto especifica las fechas específicas del tiempo en el cual se podrá ejecutar el Wrapper. Una vez que dicho arrendamiento haya expirado, el Wrapper ya no se iniciará.

  • Las propiedades wrapper.license.key.1-4 se utilizan para validar el resto de propiedades de licencia.

NOTA

Los valores de las propiedades de la Clave de la Licencia son únicos y la Clave de la Licencia no autorizará el Wrapper si alguno de sus valores se modifica de alguna manera.

También es posible incluir Claves de Licencias de varios servidores en un único archivo al incluir los nombres de host en los nombres de las propiedades de la Clave de Licencia. El siguiente ejemplo muestra una Clave de Licencia con el nombre de host "myhost". Es posible cambiar la parte del nombre de host de las propiedades de la Clave de Licencia sin la necesidad de volver a generar otra clave.

wrapper.myhost.license.type=NODE
wrapper.myhost.license.id=200804010006
wrapper.myhost.license.licensee=Acme, Inc.
wrapper.myhost.license.host_id=00123456789a
wrapper.myhost.license.features=pro, 64bit
wrapper.myhost.license.upgrade_term.begin_date=2008-04-01
wrapper.myhost.license.upgrade_term.end_date=2024-04-01
wrapper.myhost.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.myhost.license.key.2=007d-7e3c-5e2a-427e
wrapper.myhost.license.key.3=ce16-f5f0-59f4-d18a
wrapper.myhost.license.key.4=b6ca-c31a-6be8-323d

Alternativamente, a partir de la versión de Wrapper ver. 3.3.2, es posible usar los mismos HostIds desde los nombres de las propiedades de la Clave de la Licencia. Esto permite definir más de una Clave de Licencia, cada una para un HostId diferente. Un ejemplo de donde esto es necesario es un sistema que utiliza una tarjeta de red de carga balanceada donde el HostId cambia dependiendo de la tarjeta física subyacente actualmente activa.

wrapper.00123456789a.license.type=NODE
wrapper.00123456789a.license.id=200804010006
wrapper.00123456789a.license.licensee=Acme, Inc.
wrapper.00123456789a.license.host_id=00123456789a
wrapper.00123456789a.license.features=pro, 64bit
wrapper.00123456789a.license.upgrade_term.begin_date=2008-04-01
wrapper.00123456789a.license.upgrade_term.end_date=2024-04-01
wrapper.00123456789a.license.key.1=0222-2e8a-6f6d-4a4a
wrapper.00123456789a.license.key.2=007d-7e3c-5e2a-427e
wrapper.00123456789a.license.key.3=ce16-f5f0-59f4-d18a
wrapper.00123456789a.license.key.4=b6ca-c31a-6be8-323d

Descripción de Propiedades de Clave de Licencia de Desarrollo

Las Claves de Licencias de Desarrollo consisten en un conjunto de propiedades que se colocan directamente en archivo de configuración wrapper.conf o o incluidas usando un archivo de configuración en cascada. La clave de licencia está vinculada a una aplicación específica usando los valores de la clase principal de la aplicación.

La clase principal de la aplicación se epecifica usando la propiedad wrapper.java.mainclass. Si la clase principal es una de las clases auxiliares incluidas con el Wrapper (org.tanukisoftware.wrapper.WrapperSimpleApp o org.tanukisoftware.wrapper.WrapperStartStopApp), entonces la clase principal se especificará usando la propiedad wrapper.app.parameter.1. En cualquier caso, la licencia autorizará el Wrapper solo si la clase principal permanece sin cambio alguno.

Ejemplo de Clave de Licencia de Desarrollo:
wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.upgrade_term.begin_date=2008-04-01
wrapper.license.upgrade_term.end_date=2024-04-01
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=9296-6f2d-0e58-75e6
wrapper.license.key.3=0f5d-2cf2-ad36-54f9
wrapper.license.key.4=b859-dc75-61d7-b0ca
  • El valor de wrapper.license.type siempre será 'DEV' para Claves de Licencias de Desarrollo.

  • El valor de wrapper.license.id se utiliza para identificar de manera única la Clave de Licencia que se mostrará en su página de Administrar Licencias.

  • Los valores de wrapper.license.licensee y wrapper.license.dev_application se mostrarán el la consola y en el archivo wrapper.log cada vez que se inicia el Wrapper. En el caso de la Clave de la Licencia anterior, el resultado será el siguiente:

    Java Service Wrapper Professional Edition nn-bit n.n.n
      Copyright (C) 1999-2023 Tanuki Software, Ltd.  All Rights Reserved.
        http://wrapper.tanukisoftware.org
      Licensed to Acme, Inc. for Acme Control Server
    
  • Los valores en wrapper.license.features se utilizan para describir el bit y la edición del Wrapper que se autoriza. En este caso, se autoriza 64-bit, Edición Profesional. Esto también autorizará la ejecución de versiones inferiores 32-bit y Edición Estándar del Wrapper.

  • wrapper.license.upgrade_term.begin_date y wrapper.license.upgrade_term.end_date especifican las fechas de publicación del Wrapper autorizadas por la Clave de Licencia. La licencia anterior autorizará las versiones del Java Service Wrapper publicadas antes de 2024-04-01. Las versiones del Wrapper publicadas antes del La licencia en la parte de arriba autorizará la descarga de versiones del Wrapper que han sido liberadas antes de esta fecha 2024-04-01. Las versiones del Wrapper publicadas dentro del término de actualización especificado estarán autorizadas a actualizarse y también a ejecutarse incluso después de que el Término de Actualización haya terminado.

  • También puede aparecer un plazo de arrendamiento (lease term) opcional en algunas Claves de Licencias de prueba. Esto especifica las fechas específicas del tiempo en el cual se podrá ejecutar el Wrapper. Una vez que dicho arrendamiento haya expirado, el Wrapper ya no se iniciará.

  • The wrapper.license.key.1-4 properties are used to validate the rest of the license properties.

    A partir de Wrapper ver. 3.3.6, es posible ocultar el término de actualización en un quinto valor de clave. Esto puede ser útil para evitar mostrar a los clientes cuándo finaliza el plazo de actualización de un proveedor de software. Debido a que el término de actualización de la Clave de la Licencia está ofuscado, por supuesto, puede hacer que sea un poco más difícil brindar soporte a los usuarios que están actualizando el Wrapper por su cuenta. Cuando se ejecuta un Wrapper binario que es más nuevo que lo que permite el término de actualización, el mensaje de error incluirá la fecha de finalización del término, por lo que este es un problema menor.

    La característica del término de actualización oculto puede accederse al descargar un Clave de Licencia nueva o existente.

Ejemplo de Clave de Licencia de Desarrollo:
wrapper.license.type=DEV
wrapper.license.id=200804010003
wrapper.license.licensee=Acme, Inc.
wrapper.license.dev_application=Acme Control Server
wrapper.license.features=pro, 64bit
wrapper.license.key.0=ada5-ac8d-6f2d-54f9
wrapper.license.key.1=a0a5-b478-ca71-8d59
wrapper.license.key.2=5296-6d2d-0e58-79e6
wrapper.license.key.3=6f5d-acf2-3d36-64f9
wrapper.license.key.4=c859-dcf5-61d7-b8ca

NOTA

Los valores de las propiedades de la Clave de la Licencia son únicos y la Clave de la Licencia no autorizará el Wrapper si alguno de sus valores se modifica de alguna manera.

Archivo de Licencia en Archivo de Configuración en Cascada

Generalmente es deseable colocar las propiedades de la Clave de Licencia del Wrapper en un archivo distinto de wrapper.conf. Esto puede hacerse fácilmente utilizando la funcionalidad "Archivo de inclusión" (en modo cascada) del archivo de configuración.

Se sugiere que las propiedades de la Clave de Licencia se coloquen en un archivo llamado wrapper-license.conf, ubicado en el mismo directorio que el archivo wrapper.conf. El archivo de licencia se incluye colocando una línea como la siguiente en la parte superior de su archivo wrapper.conf:

#include ../conf/wrapper-license.conf

Tome en cuenta que la ruta del "Archivo de inclusión" es relativa a la ubicación del Wrapper binario y NO a la ubicación del archivo wrapper.conf. Vea la sección sobre Configuración de Archivos en Cascada ("archivo de inclusión") para más detalles y consejos de cómo llevar a cabo una depuración de problemas con Archivo de inclusión.

Para facilitar la gestión de un gran número de archivos de licencia, el Wrapper puede configurarse para cargar los archivos de licencia basados en los nombres de host. Esto permite desplegar todos los archivos de licencia en todos los servidores.

#include ../conf/wrapper-license-%WRAPPER_HOST_NAME%.conf

¿Tiene dudas?

Si experimenta algún problema con su licencia, por favor configure la propiedad wrapper.license.debug y habilite la depuración del archivo de inclusión. En combinación, la mayoría de los problemas de configuración se hacen evidentes.