FAQ

General

+ What is Canvas ?

The Canvas platform is a combination of client side components and an application server that simplifies requests to TM1. Canvas has numerous components / controls that have been based on existing TM1 functionalities, such as: DBR, DBRW, DBRA, SUBNM and Active Forms. The goal is to leverage the knowledge of TM1 and add to that mix, technologies that are broadly supported in the web development world.

+ What do you need to know before using Canvas ?

All Canvas applications are authored in HTML. Canvas comes with a complete set of HTML planning and reporting samples which will help you to quickly build out your new TM1 web applications.

The expectation is that if you know how to write a rule or a Turbo Integrator process, you will quickly learn how to use HTML with TM1. Learning HTML will provide you with a skill that will always be in fashion.

+ Can Canvas replaces Cognos BI?

Yes&No, If you uses Cognos BI just for Dashboarding then Yes Canvas can replaces it but if you use the bursting and offline mode features of Cognos BI, these features are currently not available with Canvas. What is more, Canvas has Read/Write capabilities! It is more than just a BI tool, with Canvas you can also do Planning and dashboarding.

Configuration

+ Canvas prerequisites

TM1 server should be on version 10.2.2 FP5 as minimum. To use the TM1 drillthrough, you will need 10.2.2 FP6 as minimum.

Canvas comes with an application server "Cubewise Application Server" and a TM1 instance "CXMD" (required for the samples). In order to set up Canvas, you will need to have a minimum of 3 port number available:

  • Canvas server
  • CXMD portnumber
  • CXMD HTTPportnumber
  • Then one port number per TM1 instance in order to enable TM1 REST API.

+ Can we update the Canvas port number later on

Yes, that can be changed anytime, just restart the "Cubewise Application Server" once the port number has been updated.

+ What versions of TM1 does Canvas support?

Canvas supports all versions of TM1 from 10.2.2 FP4 onwards.

+ What TM1 Security does Canvas support?

Canvas supports TM1 Security mode 1,2,4 and 5. Canvas supports CAM authentication which allows any LDAP directory to be used including the Active Directory (see how to set up CAM security).

+ Can we avoid the CWAS folder being placed at the root of the C: drive?

Yes, you can put the CWAS folder anywhere you like. Be aware that if you put it inside C:\Program Files for example, you might have to deal with Windows security everytime you update your Canvas files.

+ What does the CWAS folder do?

The CWAS contains the Tomcat server and the webapps folder. Just by copying the files you have "installed" tomcat. It does not have to be installed as a service to run it, you can just double-click on the bin/startup.bat file to start it up. It is preferable though that you install it as a Windows service, especially if it is going to be used in production.

Technical

+ Which type of server is behind the Cubewise Application server?

Canvas uses a Apache Tomcat server, which is different to an Apache HTTP Server. Tomcat is a Java application server that can be used for lots of purposes including serving HTML pages, CSS, etc..

+ In which language the Canvas server has been written?

Canvas' server component is written in Java.

+ Does Canvas uses its own REST API or does it uses the TM1 REST API ?

Canvas uses TM1's REST API, while at the same time exposing its own REST APIs that simplifies the calls to often used functions with TM1.

Canvas is the middle layer illustrated below:

Canvas client (browser) > Canvas' REST API > Canvas Server > TM1's REST API > TM1 (and back the other way)

+ Can we have multiple Tomcat running at the same time with different versions?

You can have multiple versions of Tomcat running as long as they each have their own ports. For example, TM1 Web uses version 6 and we are using version 7.
If you want to use Canvas with an existing Tomcat server it has to be version 7 at least.

+ Will there be compatibility issues with other web servers (for example IIS)

Canvas does not work with IIS but can work side by side, with the only issue being port conflicts. This is as each port can only be used by one program.