Configuración de la base de datos de MSSQL para ThingWorx: Windows
En MSSQL Server, es necesario crear una conexión antes de crear un usuario. La conexión se crea fuera de la base de datos. Después, se crea una base de datos. Dentro de la base de datos, se crea un usuario y se le asigna la conexión creada. Luego se crea un esquema en la base de datos. Por último, el propietario del esquema será el usuario creado anteriormente. Con respecto a ThingWorx, SSMS creará manualmente la conexión twadmin. Los pasos restantes se realizan mediante la ejecución de scripts bat.
 |
Si no se utiliza Windows, se debe ir a la sección Configuración de la base de datos de MSSQL para ThingWorx: Linux.
|
Creación de la conexión twadmin
|
|
Antes de ejecutar los siguientes pasos, verifique que se realizan las secciones de Instalación de SQL Server Management Studio (cliente de administración de base de datos) en un ordenador Windows.
|
Se puede utilizar la GUI o la línea de comandos para crear la conexión.
|
|
Los pasos de la GUI se indican a continuación. Si se utiliza el editor de consultas en SSMS, se debe introducir el siguiente comando de Transact-SQL:
CREATE LOGIN twadmin WITH PASSWORD = '<password>';
|
1. En SQL Server Management Studio (SSMS), abra el explorador de objetos y expanda la carpeta de la instancia del servidor en la que se debe crear la nueva conexión.
2. Pulse con el botón derecho del ratón en la carpeta Seguridad, señale a Nuevo y pulse en Inicio de sesión.
3. En la página General, introduzca un nombre para la nueva conexión en el cuadro Nombre de inicio de sesión.
4. Seleccione Autenticación de SQL Server.
5. Introduzca una contraseña para la conexión.
6. Pulse en Aceptar.
Configuración y ejecución del script de configuración de base de datos
1. Obtenga el script de configuración de base de datos (thingworxMssqlDBSetup.bat) del software descargado de ThingWorx.
2. Abra el símbolo del sistema y vaya al directorio de la carpeta de scripts.
3. Introduzca el siguiente comando:
thingworxMssqlDBSetup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -l <login-name> -d <thingworx-database-name> -u <thingworx-user-name> -s <schema-name>
4. Cuando se ejecute, se solicitará la contraseña de database-admin-user. Introduzca la contraseña y pulse Intro.
5. Defina la clasificación. Para definir la clasificación mediante SQL Server Management Studio, seleccione Base de datos > Propiedades > Opciones y seleccione Latin1_General_100_CS_AS_SC del menú desplegable.
6. Defina las siguientes propiedades en ON:
◦ READ_COMMITTED_SNAPSHOT
◦ ALLOW_SNAPSHOT_ISOLATION
Una vez ejecutado el script, se creará una base de datos que incluye el usuario con la conexión asociada. A este usuario se le asignará el rol db_owner en la base de datos creada. También se creará un esquema si se proporciona en la línea de comandos. Se otorgará la autorización de este esquema al usuario creado.
|
Opción
|
Parámetro
|
Por defecto
|
Descripción
|
Ejemplo
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN o IP de servidor de base de datos
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<en blanco>
|
Nombre de instancia proporcionado durante la instalación de la base de datos.
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Puerto de SQL Server
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
Nombre del usuario administrador que tiene los derechos adecuados.
|
-a sa
|
||
|
-l
|
login-name
|
twadmin
|
Nombre de conexión creado de forma manual anteriormente.
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Nombre de base de datos
|
-d thingworx
|
||
|
-u
|
thingworx-user-name
|
<igual-que-login-name>
|
Nombre del usuario que se creará en la base de datos.
|
-u twadmin
|
||
|
-s
|
schema-name
|
twschema
|
Nombre del esquema creado en la base de datos thingworx.
|
-s twschema
|
||
|
-r
|
password
|
Password@123
|
Contraseña de database-admin-user
|
"Password@123"
|
Configuración y ejecución del script de esquemas del proveedor de modelos/datos
1. En el símbolo del sistema, ejecute el fichero bat (thingworxMssqlSchemaSetup.bat) con los parámetros adecuados (que se indican en la siguiente tabla):
thingworxMssqlSchemaSetup.bat -h <server> -i <server-instance> -p <port> -l <login-name> -r <password> -d <thingworx-database-name> -o <option (all,model,data,property,modelwithproperty)>
Al ejecutar el fichero bat, se solicitará la contraseña de conexión (creada manualmente arriba) para cada script. Introduzca la contraseña y pulse Intro cada vez.
|
|
Se muestra el siguiente aviso previsto al ejecutar el script: Warning! The maximum key length for a clustered index is 900 bytes. The index 'data_table_indexes_pkey' has maximum length of 902 bytes. For some combination of large values, the insert/update operation will fail.
|
Al ejecutar estos scripts, todas las tablas, los índices, los procedimientos, etc. necesarios para configurar ThingWorx Platform se crearán en la base de datos thingworx con el esquema por defecto twschema.
|
Opción
|
Parámetro
|
Por defecto
|
Descripción
|
Ejemplo
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN o IP de servidor de base de datos
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<en blanco>
|
Nombre de instancia proporcionado durante la instalación de la base de datos
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Puerto de SQL Server
|
-p 1433
|
||
|
-l
|
login-name
|
twadmin
|
Nombre de conexión creado de forma manual anteriormente.
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Nombre de base de datos
|
-d thingworx
|
||
|
-o
|
option
|
all
|
Para ejecutar todos los scripts. Se ejecutarán el modelo, los datos, la propiedad y el model con propiedades.
|
-o all
|
||
|
-r
|
password
|
Password@123
|
Contraseña para login-name
|
"Password@123"
|
Configuración y ejecución del script de limpieza de base de datos
El script bat de limpieza de base de datos (thingworxMssqlDBCleanup.bat) se proporciona por comodidad y para el desarrollo/prueba. La ejecución de los pasos de esta sección solo es necesaria si todo el objeto y los datos de la base de datos se deben borrar para poder comenzar desde cero.
1. En el símbolo del sistema, ejecute el fichero bat con los parámetros adecuados (que se indican en la siguiente tabla):
thingworxMssqlDBCleanup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -d <thingworx-database-name>
|
Opción
|
Parámetro
|
Por defecto
|
Descripción
|
Ejemplo
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN o IP de servidor de base de datos
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<en blanco>
|
Nombre de instancia proporcionado durante la instalación de la base de datos
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Puerto de SQL Server
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
El nombre de usuario administrador que dispone de los derechos adecuados.
|
-a sa
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Nombre de base de datos
|
-d thingworx
|
||
|
-r
|
password
|
Password@123
|
Contraseña de database-admin-user
|
"Password@123"
|