Activate your Commerce Intelligence Account for On-Premise and Starter Subscriptions
To activate Commerce Intelligence for on-premise subscriptions, first create a Commerce Intelligence account, enter your settings information, then connect Commerce Intelligence to your Commerce database.
Create your Commerce Intelligence account
To create your account, contact your Adobe Account Team or Customer Technical Advisor.
Create your password
After your account has been created, check your email for an account notification email from The Magento BI Team@rjmetrics.com. Use the link provided in the email to access your Commerce Intelligence account and create your password. Go to your inbox and verify your email address.
If you did not receive an email, contact support.
Set your store preferences
Before you configure the database connection, complete the store information form. This information is required to complete the Connect your Database setup.
Add Commerce Intelligence users
After you set your password and log into Commerce Intelligence, you can add other users to your Commerce Intelligence account. When adding users, add admin users with appropriate permissions to complete the activation process.
Create a dedicated Commerce Intelligence user in the Commerce admin
To use Commerce Intelligence, you must add a permanent and dedicated user to the Commerce project. This dedicated user serves as a permanent connection to Commerce that enables the fetch and transfer of new data to the account’s Commerce Intelligence Data Warehouse.
Configuring a dedicated Commerce Intelligence user ensures that the account is not deactivated or deleted, thus stopping the Commerce Intelligence connection.
After you created the dedicated user for Commerce Intelligence in the Admin, add the same user to the primary environment of the Commerce project with a Master setting of Contributor.
Get your Commerce Intelligence SSH keys
-
On the Connect your database page for Commerce Intelligence setup, scroll down and select Encryption settings.
-
For Encryption Type, select
SSH Tunnel. -
From the drop-down, copy the public key that is provided.
Add your public key to the Commerce Intelligence
-
From the Commerce Admin, sign in using the login information for the Commerce Intelligence user you just created.
-
Select the Account Settings tab.
-
Scroll down and expand the SSH Keys drop-down. Then, select Add a public key.
-
Paste the public key that you copied in the Encryption Type step above.
Provide Commerce Intelligence Essentials MySQL credentials
-
Update your
.magento/services.yaml.
-
Update your
.magento.app.yaml.
Get database connection information
Get the database connection information to the Commerce database to Commerce Intelligence
-
Run the following to get your information.
echo $MAGENTO_CLOUD_RELATIONSHIPS | base64 --decode | json_pp -
Review the database information, which should look similar to the following example.
Connect Commerce Intelligence to your Commerce database using an encrypted connection
SSH tunnel tunnel to make the database connection. However, if this method is not an option, you can still link Commerce Intelligence to your database using a direct connection.Enter your Commerce Intelligence information in the Connect your Magento Database screen.
Inputs:
Integration Name: [choose a name for your Commerce Intelligence instance]
Host: mbi.internal
Port: 3306
Username: mbi
Password: [input password displayed in the previous section]
Database Name: main
Table Prefixes: [leave blank if there are no table prefixes]
Set your Time Zone settings
Inputs:
Database Timezone: UTC
Desired Timezone: [choose the time zone for which you want your data to display]
Get your encryption settings information
The project UI provides an SSH access string. This string can be used for gathering the information needed for the Remote Address and Username. Use the SSH Access string by selecting the access site button on the Master branch of the Project UI. Then, find your User Name and Remote Address as shown below.
Input your Encryption settings
Inputs:
Encryption Type: SSH Tunnel
Remote Address: ssh.us-3.magento.cloud [from the previous step]
Username: vfbfui4vmfez6-master-7rqtwti—mymagento [from the previous step]
Port: 22
Save your integration.
After completing the configuration steps, apply the changes by selecting Save Integration.
You have now successfully connected your Commerce database to your Commerce Intelligence account.
After you complete the configuration, sign in to your Commerce Intelligence account.