Manual Database Install
As needed, you can perform manual creation of users and individual databases used by the Designer Cloud Powered by Trifacta platform.
Tip
In most installation scenarios, manual database installs are not needed.
Prerequisites
The database server must be installed and available:
The databases must be initialized.
Note
If you are using non-standard database names, users, passwords, port numbers, that information must be applied during installation and afterwards in the Designer Cloud Powered by Trifacta platform configuration.
For more information, see Configure the Databases.
Required special database permissions
If you are manually installing any of the following databases, special database permissions are required for the user performing the installation and access. When the Designer Cloud Powered by Trifacta platform is initialized for the first time, a cross-migration of data is performed between these databases, which is required for successful installation and enablement of the related services. This cross-migration process requires special database privileges.
To execute the cross-migration, the database user for the following databases requires special privileges:
trifacta
databasetrifactaauthorizationservice
database
The privileges required for cross-migration depend on the database server on which these databases are being installed:
Database Type | Required permissions for database user |
---|---|
PostgreSQL | SUPERUSER |
MySQL | FILE |
Warning
If the cross-migration is run as part of the normal install or upgrade script, then these permissions are already set for the above databases. If for some reason, you are manually installing or upgrading these databases, the above privileges must be applied.
After install or upgrade, the above privileges are not required for normal operations on these databases. These privileges must be re-applied if cross-migrations need to be performed in the future.
Manual DB Install for PostgreSQL
Use the following steps to manually create the users and databases required by the platform in PostgreSQL.
Launch PostgreSQL
Prerequisites for PostgreSQL:
The installing user must have write permissions to the directory from which the commands are executed.
The installing user must have sudo privileges.
Switch to the Postgres user. Launch psql.
sudo su - postgres
Note
Unless the port number for postgres has been modified, it should be listening at the default value:
5432
.Launch psql using the following command, applying the admin password when prompted:
psql --host=${POSTGRES_HOST_NAME} --port=${POSTGRES_HOST_PORT} --username=${POSTGRES_ADMIN_USERNAME} --password=${POSTGRES_ADMIN_PASSWORD}
where:
Parameter
Description
host
Public DNS value for database server instance
port
Port number value for database server instance
username
Admin username for database server instance
password
Password for admin username
Execute the following commands using the
postgres
user.Note
The values in platform configuration must match the values that you use below. Below are the default values.
Alteryx database
CREATE ROLE trifacta LOGIN ENCRYPTED PASSWORD '<pwd_trifacta>'; CREATE DATABASE trifacta WITH OWNER trifacta;
Jobs database
CREATE ROLE trifactaactiviti WITH LOGIN ENCRYPTED PASSWORD '<pwd_trifactaactiviti>'; CREATE DATABASE "trifacta-activiti" WITH OWNER trifactaactiviti;
Scheduling database
CREATE ROLE trifactaschedulingservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaschedulingservice>'; CREATE DATABASE trifactaschedulingservice WITH OWNER trifactaschedulingservice;
Time-based Trigger database
CREATE ROLE trifactatimebasedtriggerservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactatimebasedtriggerservice>'; CREATE DATABASE trifactatimebasedtriggerservice WITH OWNER trifactatimebasedtriggerservice;
Configuration Service database
CREATE ROLE trifactaconfigurationservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaconfigurationservice>'; CREATE DATABASE trifactaconfigurationservice WITH OWNER trifactaconfigurationservice;
Artifact Storage Service database
CREATE ROLE trifactaartifactstorageservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaartifactstorageservice>'; CREATE DATABASE trifactaartifactstorageservice WITH OWNER trifactaartifactstorageservice;
Job Metadata Service database
CREATE ROLE trifactajobmetadataservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactajobmetadataservice>'; CREATE DATABASE trifactajobmetadataservice WITH OWNER trifactajobmetadataservice;
Authorization Service database
CREATE ROLE trifactaauthorizationservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaauthorizationservice>'; CREATE DATABASE trifactaauthorizationservice WITH OWNER trifactaauthorizationservice;
Orchestration Service database
CREATE ROLE trifactaorchestrationservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaorchestrationservice>'; CREATE DATABASE trifactaorchestrationservice WITH OWNER trifactaorchestrationservice;
Optimizer Service database
CREATE ROLE trifactaoptimizerservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaoptimizerservice>'; CREATE DATABASE trifactaoptimizerservice WITH OWNER trifactaoptimizerservice;
Secure Token Service database
CREATE ROLE trifactasecuretokenservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactasecuretokenservice>'; CREATE DATABASE trifactasecuretokenservice WITH OWNER trifactasecuretokenservice;
Connector Configuration Service database
Note
The default values for this database do not follow the naming conventions for other databases.
CREATE ROLE trifactaconnectorconfigservice LOGIN ENCRYPTED PASSWORD '<pwd_trifactaconnectorconfigservice>'; CREATE DATABASE trifactaconnectorconfigservice WITH OWNER trifactaconnectorconfigservice;
Manual DB Install for MySQL
Use the following steps to manually initialize the databases required by the platform in MySQL.
Launch MySQL
Prerequisites for MySQL:
The installing user must have write permissions to the directory from which the commands are executed.
The installing user must have sudo privileges.
Login to MySQL as the root user. When prompted, enter the password for
root
user:mysql -u root -p
Execute the following commands using the
root
user.Note
The values in platform configuration must match the values that you use below. Below are the default values.
Alteryx database
Create USER 'trifacta' IDENTIFIED BY '<pwd_trifacta>'; CREATE DATABASE trifacta; Grant all on trifacta.* to trifacta;
Jobs database
Create USER 'trifactaactiviti' IDENTIFIED BY '<pwd_trifactaactiviti>'; CREATE DATABASE trifacta-activiti; Grant all on trifacta-activiti.* to trifactaactiviti;
Scheduling database
Create USER 'trifactaschedulingservice' IDENTIFIED BY '<pwd_trifactaschedulingservice>'; CREATE DATABASE trifactaschedulingservice; Grant all on trifactaschedulingservice.* to trifactaschedulingservice;
Time-based Trigger database
Create USER 'trifactatimebasedtriggerservice' IDENTIFIED BY '<pwd_trifactatimebasedtriggerservice>'; CREATE DATABASE trifactatimebasedtriggerservice; Grant all on trifactatimebasedtriggerservice.* to trifactatimebasedtriggerservice;
Configuration Service database
Create USER 'trifactaconfigurationservice' IDENTIFIED BY '<pwd_trifactaconfigurationservice>'; CREATE DATABASE trifactaconfigurationservice; Grant all on trifactaconfigurationservice.* to trifactaconfigurationservice;
Artifact Storage Service database
Create USER 'trifactaartifactstorageservice' IDENTIFIED BY '<pwd_trifactaartifactstorageservice>'; CREATE DATABASE trifactaartifactstorageservice; Grant all on trifactaartifactstorageservice.* to trifactaartifactstorageservice;
Job Metadata Service database
Create USER 'trifactajobmetadataservice' IDENTIFIED BY '<pwd_trifactajobmetadataservice>'; CREATE DATABASE trifactajobmetadataservice; Grant all on trifactajobmetadataservice.* to trifactajobmetadataservice;
Authorization Service database
Create USER 'trifactaauthorizationservice' IDENTIFIED BY '<pwd_trifactaauthorizationservice>'; CREATE DATABASE trifactaauthorizationservice; Grant all on trifactaauthorizationservice.* to trifactaauthorizationservice;
Orchestration Service database
Create USER 'trifactaorchestrationservice' IDENTIFIED BY '<pwd_trifactaorchestrationservice>'; CREATE DATABASE trifactaorchestrationservice; Grant all on trifactaorchestrationservice.* to trifactaorchestrationservice;
Optimizer Service database
Create USER 'trifactaoptimizerservice' IDENTIFIED BY '<pwd_trifactaoptimizerservice>'; CREATE DATABASE trifactaoptimizerservice; Grant all on trifactaoptimizerservice.* to trifactaoptimizerservice;
Secure Token Service database
Create USER 'trifactasecuretokenservice' IDENTIFIED BY '<pwd_trifactasecuretokenservice>'; CREATE DATABASE trifactasecuretokenservice; Grant all on trifactasecuretokenservice.* to trifactasecuretokenservice;
Connector Configuration Service database
Note
The default values for this database do not follow the naming conventions for other databases.
Create USER 'trifactaconnectorconfigservice' IDENTIFIED BY '<pwd_trifactaconnectorconfigservice>'; CREATE DATABASE trifactaconnectorconfigservice; Grant all on trifactaconnectorconfigservice.* to trifactaconnectorconfigservice;