Denodo Technologies, the data virtualization leader for unifying enterprise data and delivering data services for the business, is providing Denodo Platform available on GCP as bring your own license (BYOL) virtual machine (VM). The VMs contain the latest versions of Denodo Solution Manager and Denodo VDP, optimized for use with the GCP Virtual Machines service.
Thank you for your confidence in choosing Denodo as your data virtualization technology!
This quick start guide will give you an overview of the Denodo Platform and how to quickly start building data virtualization solutions on GCP.
This Denodo for GCP offering is based on a Bring Your Own License (BYOL) model under your GCP project.
It is expected that you already have a GCP project that you can use to logon to the GCP Marketplace in order to create and launch the Denodo VM BYOL through the GCP Console. And you are responsible for operating your own GCP project.
The Denodo VM BYOL consists of the same engine as the Denodo Platform. Some of the key features include:
The VMs available are based on CentOS Linux:
In the sections below you can find more information on how to deploy.
This is a BYOL offering and requires you to work with Denodo directly to obtain licenses. If you currently do not hold a license agreement for Denodo Platform, please contact Denodo directly to get a license to use the software.
Once you have obtained a Denodo Platform license:
The high level list of steps needed to provision and configuring your Denodo SM BYOL on GCP is the following:
All the process can take an approximate time of 30 to 50 minutes.
You are responsible for operating your own GCP project.
You can create and launch your Denodo SM for GCP BYOL VM using your GCP user.
The GCP offering includes a Linux Server Virtual Machine with Denodo SM 8.0 installed.
Log on to the GCP Marketplace and search for the Denodo Platform 8.0 SM for GCP BYOL listing.
Note: The GCP interface is subject to change and the exact options you see depend on whether or not you have existing projects.
And then click the LAUNCH button.
Then, Select a project or Create a project page could be the next. Enter a project name and select a value from the Organization drop‑down, then click the Create button.
After selecting the Denodo Solution Manager 8.0 BYOL on Linux Server available through the GCP Marketplace you have to complete some few configuration steps in order to launch the Denodo virtual machine through the GCP console.
NOTE: see Denodo SM Hardware Requirements before choosing the VM Size.
Then Click the Deploy button.
The Denodo services require a Denodo license to start.
Once the Denodo SM BYOL VM is running you have to log in Linux with your user through a SSH Connection. Detailed instructions are available on Connect to a Linux Virtual Machine.
Then copy your previously obtained Denodo Solution Manager license file to the GCP VM, rename the file as denodo.lic, and save it in the following directory:
/opt/denodo/denodo-solution-manager-8.0/conf
Logged in with your user through SSH and once a Denodo license is installed you can start enjoying Denodo software.
Use the terminal to run these commands in your instance to start Denodo services in the following order:
sudo systemctl start licensemanagerserver
sudo systemctl start solutionmanagerserver
After executing those commands the following services will be started:
You can check the status of the Denodo Services with the following commands:
systemctl status licensemanagerserver
systemctl status solutionmanagerserver
And you can stop the Denodo Services with the following commands:
sudo systemctl stop licensemanagerserver
sudo systemctl stop solutionmanagerserver
NOTE: The Denodo services are not configured to start at instance boot time. You can configure those services to start at instance boot time with the commands:
sudo systemctl enable licensemanagerserver
sudo systemctl enable solutionmanagerserver
The Solution Manager is a component to help you manage Denodo deployments.
Once you logged in, the Denodo Solution Manager Administration Tool provides a single point of entry to all the web applications of the Denodo deployment.
Check first the list of Supported Browsers for Solution Manager admin tool.
Then use a supported browser to point to the URL to access Denodo Solution Manager Administration Tool with the following pattern:
http://<sm_ip>:19090/solution-manager-web-tool/Login
Where <sm_ip> is the IP address or DNS name for the Solution Manager virtual machine in the stack deployed.
NOTE: the application may take some time to start so you may need to wait for a couple of minutes before the link works correctly. You may get a connection error or a ‘404 Not Found’ error if you try to access it before the service has completely started.
The user is admin and the password by default is admin so the recommendation is to change the default password first thing:
Then logout and sign in again with admin as username and the new password.
A Denodo Environment is defined as a set of servers, of the same or different type, working together for a common purpose. For example, Production, Development or Staging environments.
For creating a new Platform Mode Environment from the Denodo Solution Manager Administration Web Tool:
Repeat above steps for all environments and clusters you want to set up.
With the environment and cluster created everything is ready to add Denodo servers like VDP or Scheduler.
Last step is registering deployed Denodo servers (like VDP or Schedulers) in created clusters.
Instructions on how to deploy a Denodo VDP Virtual Machine are available in a chapter below in this guide.
For adding a new Denodo server to a cluster from the Denodo Solution Manager Administration Web Tool:
Repeat above steps for all deployed Denodo servers.
The Design Studio provides a web interface to the developers to create data sources, base views, derived views, publish web services, etc.
Check first the list of Supported Browsers for the Design Studio tool.
Then use a supported browser to point to the following URL of the Design Studio Web Tool following the pattern:
http://<sm_ip>:19443/denodo-design-studio/
Where <sm_ip> is the IP address or DNS name for the Solution Manager virtual machine in the stack deployed.
In the Solution Manager Web Tool homepage you have links to the Design Studio and Scheduler Web Tools: select the Environment and then click on the Open link for going to the homepage of the Design Studio preloaded with the connection data to the cluster in that environment.
Refer to Main Areas of the Design Studio for more information.
Note that certain administrative tasks like cache configuration, setting-up the authentication, user management, etc can be done by graphical way only by using the Virtual Dataport Administration tool (desktop based).
The high level list of steps needed to provision and configuring your Denodo VDP BYOL is the following:
Note: The GCP interface is subject to change and the exact options you see depend on whether or not you have existing projects.
Log on to the GCP Marketplace and access the Denodo Platform 8.0 VDP (BYOL).
And then click the LAUNCH button.
Then, Select a project or Create a project page could be the next. Enter a project name and select a value from the Organization drop‑down, then click the Create button.
After that the deployment configuration appears where you can select appropriate values for zone, machine type, and so on.
For choosing the machine type please see Denodo Hardware Requirements.
Then Click the Deploy button.
As soon as the project deploys, and the new virtual machine (VM) instance starts running, the following services are automatically started:
The Denodo services require a Denodo license to start.
Log in the Denodo VDP for GCP BYOL on Linux with your user through a SSH Connection. Detailed instructions are available on Connect to a Linux Virtual Machine.
You need a Denodo Solution Manager installed and running, and accessible in the same network from the Denodo VDP for GCP virtual machine through internal IPs registered in the internal DNS.
The Denodo servers need to be previously registered in the Denodo Solution Manager in one of the clusters for an environment. You can find more detailed information on the Denodo official documentation on how to create a server in the Solution Manager. Be sure of declaring the correct hostname of the Denodo server. You can register the following Denodo servers in the Denodo Solution Manager: VDP Server; Scheduler Server; Data Catalog Server.
Then, in the Denodo VDP for GCP BYOL VM logged as your GCP user edit the /opt/denodo/denodo-platform-8.0-linux64/conf/SolutionManager.properties file and set the value of these properties:
Logged in with your GCP user through SSH and once a Denodo license is installed you can start enjoying Denodo software.
Use the terminal to run this command to start the Denodo VDP Service:
sudo systemctl start vqlserver
Additionally you can start other Denodo Services (if they are allowed by your acquired Denodo License):
sudo systemctl start schedulerserver
sudo systemctl start schedulerwebadmintool
sudo systemctl start designstudio
sudo systemctl start datacatalog
sudo systemctl start diagnosticmonitoringtool
You can check the status of the Denodo Services with the following commands:
sudo systemctl status vqlserver
sudo systemctl status schedulerserver
sudo systemctl status schedulerwebadmintool
sudo systemctl status designstudio
sudo systemctl status datacatalog
sudo systemctl status diagnosticmonitoringtool
NOTE: The Denodo services are not configured to start at instance boot time. You can configure those services to start at instance boot time with the commands:
sudo systemctl enable vqlserver
sudo systemctl enable schedulerserver
sudo systemctl enable schedulerwebadmintool
sudo systemctl enable designstudio
sudo systemctl enable datacatalog
sudo systemctl enable diagnosticmonitoringtool
The Design Studio provides a web interface to the developers to create data sources, base views, derived views, publish web services, etc.
The URL of the Design Studio Web Tool follows the pattern:
http://<vm_ip>:9090/denodo-design-studio/
Where <vm_ip> is the IP address or DNS name for the Denodo Platform VDP virtual machine in the deployment.
The username is admin and the password is the one you can see in the GCP Console for the deployment.
Refer to Main Areas of the Design Studio for more information.
There are a couple of optional steps that we recommend you to take in order to improve the security of your GCP deployment.
As the first step of the configuration of your new Denodo Platform virtual machine you should change the default administrator password. It is extremely important that you change this default password to ensure that you are operating under a secure environment.
You have to configure the Virtual DataPort server in order to receive connections from external clients to the VM.
The default ports for the Denodo Platform based on the connection protocol are:
VM must be configured to allow the connections to ports enumerated above according to the connection protocol needed:
As a side note, take into account that by default an ephemeral external IP address is assigned to the VM instance. If you require a static external IP address, you may promote the address to static. Be sure that the VDP server is set correctly for accepting connections through that IP by changing the Host Name in the VDP server.
You can find details about how to secure with SSL the connections between the Solution Manager servers, the administration tools and their clients in Enable SSL in the Solution Manager.
Additionally you can find details about how to secure the connections for Denodo VDP servers in Enable SSL in Denodo.
Solution Manager requires privileged connections to manage the Denodo VDP servers. It uses a temporary system token with the necessary permissions to perform administrative tasks and therefore, the Denodo VDP server must be configured with Denodo Security Token authentication in order to validate these tokens.
See Enable Denodo Security Token for details.
Once you are all set to start building your data virtualization solutions on GCP, we recommend that you check out all the available information: