Carga del esquema de base de datos de HCL Commerce

Es necesario utilizar un script para cargar el esquema de base de datos de HCL Commerce.

Antes de empezar

Prepare una base de datos Oracle para utilizarla con HCL Commerce.

Por qué y cuándo se efectúa esta tarea

Este script competa las siguientes tareas:
  • Crea el esquema de HCL Commerce incluidas tablas, vista y procedimientos almacenados en la base de datos.
  • Carga datos de bootstrap.
  • Crea dos usuarios predeterminados en la base de datos.
    wcsadmin
    El administrador del sitio.
    spiuser
    El usuario interno con el rol "RemoteConfigurationReaders". Este usuario se utiliza solo para la invocación de API del servidor entre componentes. El usuario spiuser se configura en Store server, Search server y Customization server, y se utiliza en la invocación de API desde dichos servidores a Transaction server. Este usuario no se puede inhabilitar. En el caso de que este usuario esté inhabilitado, los servidores de componentes necesarios no podrán conectarse a Transaction server.

Procedimiento

  1. Inicie la sesión en el servidor dedicado que aloja el Utility server Docker container.
    Si Utility server Docker container no se ha implementado, consulte Preparar un servidor de host de Docker para iniciar Utility server Docker container.
  2. Introduzca el Utility server Docker container.
    Por ejemplo,
    docker exec -it utility_container_name bash
  3. Vaya al directorio /opt/WebSphere/CommerceServer90/bin.
  4. Ejecute el siguiente mandato para crear el esquema de base de datos de HCL Commerce.
    • Para Linux:
      ./initdb_oracle_sample.sh staging|production dbName dbServer dbPort dbaUser dbaPassword dbUser dbPassword merchantKey wcsadminSalt wcsadminPassword spiuserSalt spiuserPassword sampleData|noSample [sslKeyFile sslKeyPassword]
    • Para Windows: 
      ./initdb_oracle_sample.bat type dbName dbServer dbPort dbaUser dbaPassword dbUser dbPassword merchantKey wcsadminSalt wcsadminPassword spiuserSalt spiuserPassword withSample sslKeyFile sslKeyPassword
    En el ejemplo siguiente se muestra el comando para crear una base de datos staging e incluir datos de ejemplo para la tienda de ejemplo Aurora: 
    ./initdb_oracle_sample.sh staging orclpdb1 mydb.hcl.com 1521 system diet4coke wcs wcs1 1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b 3h8x876vd8g3 wcs1admin 7j2lhm2vjpoc QxV7uCk6RRiwvPVaa4wdD78jaHi2za8ssjneNMdu3vgqi sampleData /opt/utilities/config/keystore.jks ibmkey
    tipo
    El tipo de entorno. Los valores válidos son staging o production.
    staging
    Especifique este valor si desea habilitar espacios de trabajo. El espacio de trabajo predeterminado es cinco. El script crea cinco esquemas de lectura y esquema de escritura en la base de datos.
    production
    Especifique este valor si no desea habilitar espacios de trabajo y cargar un esquema para la producción.
    nombreBD
    El nombre de la base de datos que ha creado.
    dbServer
    El nombre de host de servidor de base de datos.
    dbPort
    El puerto de servidor de base de datos.
    dbaUser
    El nombre de usuario del administrador de base de datos.
    Contraseñadba
    Contraseña de administrador de base de datos.
    dbUser
    El nombre de usuario de base de datos. Asegúrese de que no está utilizando el mismo nombre de usuario que el administrador de la base de datos.
    dbPassword
    Contraseña de usuario de base de datos.
    merchantKey
    Una clave de comerciante no cifrada de texto sin formato.
    • Debe utilizarse un carácter hexadecimal 32. Los caracteres pueden ser 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e o f.
    • Debe contener como mínimo un carácter alfabético.
    • Debe contener como mínimo un carácter numérico.
    • Debe estar en minúsculas.
    • No puede contener más de 4 caracteres consecutivos idénticos.

      Por ejemplo, 1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b.

    Importante: Debe especificar sus propios valores de clave de comerciante y clave de cifrado de claves para la seguridad de la instalación HCL Commerce. No utilice los valores predeterminados contenidos en los archivos de configuración de ejemplo y ejemplos de documentación proporcionados.
    wcsadminSalt
    Especifique una serie aleatoria para utilizarla para cifrar wcsadminPassword.
    wcsadminPassword
    Este script crea un usuario administrador del sitio denominado wcsadmin. Especifique una contraseña para wcsadmin. Utilice el nombre de usuario wcsadmin y esta contraseña para iniciar la sesión en las herramientas de HCL Commerce tales como Management Center, HCL Commerce Accelerator y la Consola de administración.
    spiuserSalt
    Especifique una serie aleatoria para utilizarla para cifrar spiuserPassword.
    spiuserPassword
    Este script crea un usuario SPI llamado spiuser. Póngase en contacto con el administrador que haya preparado las imágenes de Docker en el registro. Utilice la misma contraseña de spiuser en texto sin formato que haya utilizado el administrador al preparar las imágenes de Docker. Para obtener más información, consulte Establecimiento de la contraseña de spiuser en las imágenes de Docker.
    Este usuario se utiliza solo para la invocación de API del servidor entre componentes. El spiuser se configura en el servidor de tienda, el servidor de búsqueda y el servidor de personalización, y se utiliza en la invocación de API desde dichos servidores al servidor de transacciones. Este usuario no puede inhabilitarse, de lo contrario los servidores de componentes no pueden conectarse al servidor de transacciones.
    withSample
    Determine si desea cargar datos de ejemplo para la tienda de ejemplo Aurora. Los valores válidos son sampleData o noSample.
    sampleData
    Cargar datos de ejemplo para la tienda de ejemplo Aurora. Especifique este valor si desea ver la tienda de ejemplo Aurora para fines de aprendizaje o para utilizar la tienda como punto de validación. Al final del procedimiento de configuración, si puede ver una tienda funcional, el entorno se ha instalado correctamente. Si especifica sampleData, los datos del catálogo de ejemplo y las imágenes se cargan en la base de datos. Se cargan las siguientes tiendas de ejemplo:
    • ExtendedSitesHub
    • ExtendedSitesCatalogAssetStore
    • AuroraStorefrontAssetStore
    • Auroraesite
    • AuroraB2BStorefrontAssetStore
    • AuroraB2BESite
    noSample
    No cargar datos de ejemplo. Especifique este valor cuando vaya a crear su propia tienda.

    Para aprender cómo rellenar sus propios datos, consulte Creación y configuración de la tienda personalizada.

    sslKeyFile
    (Opcional) Si se ha configurado el soporte de SSL en el servidor de la base de datos, especifique la vía de acceso al archivo de claves SSL. Es posible que desee ponerse en contacto con el administrador de base de datos para averiguar si se ha configurado el soporte SSL.
    Por ejemplo, para crear una base de datos de transición e incluir datos de ejemplo para la tienda de ejemplo Aurora:
    ./initdb_oracle_sample.bat staging orcl mydb.hcl.com 1521 system manager wcs wcs1 1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b wcsadminSalt1 wcsadminPwd1 spiuserSalt1 passw0rd sampleData opt/utilities/config/keystore.jks hclkey
    Atención: Este script tarda aproximadamente 30 minutos en completarse. Si el script falla, debe reiniciar la base de datos antes de intentar volver a ejecutar el mandato.

    Para obtener más información sobre cómo restaurar la base de datos, consulte RESTORE DATABASE COMMAND para DB2, o Oracle Database 12c Versión 2 para Oracle.

  5. Cambie la clave de comerciante predeterminada HCL Commerce y la clave de cifrado de clave con sus propios valores.
    1. Ejecute wcs_encrypt.sh para cifrar la tecla de comerciante de texto sin formato. 
      ./wcs_encrypt.sh merchantKey KeyEncryptionKey
      merchantKey
      La misma clave de comerciante no cifrada en texto sin formato que se ha utilizado al ejecutar initdb_db2_sample.
      KeyEncryptionKey
      Especifique la clave personalizada de texto sin formato y 32 caracteres hexadecimales en el archivo siguiente: /opt/WebSphere/AppServer/profiles/default/installedApps/localhost/ts.ear/xml/config/KeyEncryptionKey.xml
      Por ejemplo,
      ./wcs_encrypt.sh 1a1a1a1a1a1a1a1a2b2b2b2b2b2b2b2b 3c3c3c3c3c3c3c3c4d4d4d4d4d4d4d4d
    2. Copie la serie cifrada ASCII y haga que sea accesible para su implementación. Esta clave es necesaria para iniciar el Transaction server.
      • Para la implementación de Kubernetes, almacene el valor en función de cómo se proporcionen los valores de entorno a la implementación:
        • Dentro de Vault, almacene el valor en la ruta de la clave Tenant/EnvName/EnvType/merchantKeyEncrypted.

          Para obtener más información, consulte Datos de entorno en Vault.

        • Dentro del archivo de configuración de values.yaml de implementación, almacene el valor quitando los comentarios de la siguiente línea.
          #merchantKey:ASCII_encrypted_string
      • Para una implementación basada en Docker:
        • Añada la variable de entorno MERCHANTKEY_ENCRYPT en el archivo de configuración de Docker Compose, docker-compose.yml, dentro de la configuración de entorno Transaction server.
          Por ejemplo:
          txn:
environment:
  - MERCHANTKEY_ENCRYPT=ASCII_encrypted_string
        • Si está iniciando los contenedores Docker manualmente, también puede pasar la serie a través de la línea de mandatos.

          Por ejemplo:

           docker run -d -e LICENSE=accept -e MERCHANTKEY_ENCRYPT=ASCII_encrypted_string

Resultados

El esquema HCL Commerce se carga en la base de datos.