...
Excerpt | |||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
After you have completed the upgrade of the software on the
Migrate Values to Configuration ServiceThe
These steps are managed via scripts described in the sections below. 1 - Export configuration valuesYou must export your old configuration so that it can be re-ingested post-upgrade into the new Configuration Service. Details are provided later in this workflow.
Run the following commands as the
2 - Create new databases
After upgrade, you may need to create new databases depending on your pre- and post-upgrade releases. Below, you can see the databases that were introduced by release. | |||||||||||||||||||||||||
Database Name | Description | Introduced Release | |||||||||||||||||||||||
Configuration Service DB | Storage of parameter settings at the workspace level | Release 6.0 | Artifact Storage Service DB | Storage for feature usage data such value mappings for the standardization feature | Release 6.0
Code Block |
---|
/opt/trifacta/bin/setup-utils/db/pg_hba.conf.SAMPLE |
- CentOS/RHEL dir:
/var/lib/pgsql/9.6/data/pg_hba.conf
Ubuntu dir:
/etc/postgresql/9.6/main/pg_hba.conf
From the SAMPLE
file, copy the following appropriate declarations and paste them into the production pg_hba.conf
file above any other declarations:
Configuration Service database:
.
0.0.1/32 md5 host trifactaconfigurationservice trifactaconfigurationservice ::1/128 md5Artifact Storage Service database:
Code Block |
---|
local trifactaartifactstorageservice trifactaartifactstorageservice md5
host trifactaartifactstorageservice trifactaartifactstorageservice 127.0.0.1/32 md5
host trifactaartifactstorageservice trifactaartifactstorageservice ::1/128 md5 |
For more information on the declarations, see Configure the Databases in the Databases Guide.
Save the file.
Create DBs
Run the following script, which creates any new databases and users and roles for accessing them.
PostgreSQL:
Code Block sudo /opt/trifacta/bin/setup-utils/db/trifacta-create-postgres-roles-dbs.sh
MySQL:
Code Block /opt/trifacta/bin/setup-utils/db/trifacta-create-mysql-users-dbs.sh -u <MySql_admin_username> -w <MySql_admin_password>
- See Create Databases and Users in the Databases Guide.
- Restart the databases.
Import configuration values
The Configuration Service database must be loaded with the exported configuration values. For more information on the specific properties that have been migrated, see Changes to Configuration in the Release Notes Guide.
Steps:
If you have not done so already, create a backup of the file containing the migrated parameter values (
migrated_triconf_values.json
) outside of the
.D s item item install directory Start the platform:
Code Block sudo service trifacta start
Import the configuration values that you exported before upgrading as the
.D s defaultuser Type os.user Full true Code Block source /opt/trifacta/conf/env.sh /opt/trifacta/services/configuration-service/bin/import.sh -f /opt/trifacta/tools/config-service-tools/resources/migrate.conf
(optional) You can modify post-upgrade any of the values in the Configuration Service. Some of these values are available through the Workspace Admin page of the application.
Info NOTE: Changing these values after import overwrites the imported values.
Code Block vi /opt/trifacta/tools/config-service-tools/resources/migrated_triconf_values.json /opt/trifacta/services/configuration-service/bin/import.sh -f /opt/trifacta/tools/config-service-tools/resources/migrate.conf
You should perform a backup of the Configuration Service database after completing the import. See Backup and Recovery in the Admin Guide.
Merge Customized Configuration Files
Warning |
---|
After upgrading the software, you should scan the install directory tree for |
Steps:
Review the following directories and files for
.rpmnew
versions:Code Block /opt/trifacta/conf/env.sh /opt/trifacta/conf/nginx.conf /opt/trifacta/conf/supervisord.conf /etc/init.d/trifacta /opt/trifacta/pkg3p/tripache/conf/conf.d/*
- Configuration settings from the old files must be explicitly merged into the new files (
*.rpmnew
). - Remove old files from
:D s item item install directory - Create a directory outside of the
.D s item item install directory Move all of the config files from the previous version into this directory.
Info NOTE: Do not leave the old config files in the install directory. There should not be multiple configuration files of the same kind.
- Rename these old config files outside of the directory to include a
.backup
extension. You could also put the version number of the config file.
- Create a directory outside of the
- The
.rpmnew
extension must be removed from the new files. - Your previous configuration should be carried forward into the new version.
Next Steps
While the platform can now start, you should avoid doing so until have you completed all required steps in this guide.
Info |
---|
NOTE: Please be sure to review any post-upgrade instructions and perform any post-upgrade cleanup in the following sections. |