Installing the Viewpoint Development Portal 13.02

Viewpoint
Teradata Viewpoint is Teradata's strategic and innovative SOV (single operational view) for Teradata DB, Aster, and HDP Hadoop systems management and monitoring that enables Teradata's Unified Data Architecture (UDA).
Teradata Employee

Installing the Viewpoint Development Portal 13.02

This tutorial steps through install the Teradata Viewpoint Development Portal, a cut-down version of Viewpoint, on your local desktop machine. These instructions are specifically for Windows, though the PDK has been validated to work on Mac OS X, Linux, and Solaris.

Step 1: Install Prerequisite Software

Java 1.5 SDK

Download and install "Java 2 Platform, Standard Edition 5.0". You'll want the JDK 5.0 without the NetBeans IDE or the Java EE. After installing the Java SDK, add a JAVA_HOME environment variable that points to the installation location of the JDK. Don't forget to add the Java JDK bin directory to the Windows PATH environment variable, as described in the Java installation instructions.

Ant 1.7.x

Download and install Ant. After installation, add Ant's bin directory to your Windows PATH environment variable.

PostgreSQL 8.x

Download PostgreSQL and run the installer.

  1. On the "Service configuration" screen, either choose a secure password or accept the offer to allow the system to replace your weak password with a secure auto-generated one. If you use a weak password, the install will fail later with the inability to create the user.
    • Use the default superuser name of postgres and enter a password. Be sure to remember the password for this superuser!
    • If you want to connect to the database from another system, check the box "Accept connections on all addresses, not just localhost".
    • If there are separate Encoding fields for Server and Client they should both be SQL_ASCII.
    • If you change the PostgreSQL port number, you will need to remember the new port as well.
  2. Uncheck "Launch Stack Builder at exit" on the last install screen.

Step 2: Setting Up the PostgreSQL Database

  1. Under the folder PostgreSQL is installed in, edit data\postgresql.conf:
    • Under QUERY TUNING, set constraint_exclusion = on and remove the "#" from the beginning of the line.
  2. Open a command prompt and navigate to the directory PostgreSQL is installed in, then enter these commands:
    cd bin
    createlang --username=postgres --password=<SERVICE_ACCOUNT_PASSWORD> plpgSQL template1

    Enter the PostgreSQL superuser password when prompted. If you receive a warning that the language plpgSQL already exists, you can ignore it and proceed.
  3. Run "pgAdmin III" from the Start menu under PostgreSQL.
  4. Double-click "PostgreSQL Database Server 8.1 (localhost)" to connect, and enter the superuser password. Replace "8.1" with the version that is installed.
  5. Right-click on Login Roles, and select New Login Role...

  6. Create a role named viewpoint that can create database objects.



    Be sure to remember this password! This is the password that will be used for setting up the Teradata Viewpoint Portal in the following steps.
  7.  
  8. Create a database named lportal with owner viewpoint

  9. Repeat the previous two steps to create databases named dcsdb, td_portal, and td_portlets (all with owner viewpoint).
  10. Create a schema under dcsdb called tasm with owner viewpoint.  You can do this by expanding the tree for dcsdb created in Step 9.  Right click on Schemas and select New Schema.  Enter tasm as the Name and select viewpoint as the Owner.  Click OK to save.

Step 3: Unzip the Teradata Viewpoint PDK

  1. Download the Teradata Viewpoint PDK.
  2. Unzip the file, creating a folder called tdpdk-xx.xx.xx.xx, where the xx's indicate the version number. The rest of this tutorial assumes that this folder is located at C:\tdpdk-xx.xx.xx.xx, but it can be located elsewhere if desired.

Step 4: Configuring the Teradata Viewpoint Portal 

While configuring the Teradata Viewpoint Portal, you might need to modify JDBC URLs for the PostgreSQL database. If the PostgreSQL database is running on your local machine with the default port(5432), you do not need to make any changes to these URLs.

If the database is running on a separate system, you need to replace "localhost" with the name of the database system. If you are using a custom PostgreSQL port number, replace "5432" with the custom port number.

Important: Do not make any other changes to these URLs.

Edit C:\tdpdk-xx.xx.xx.xx\viewpoint-portal\conf\server.xml

<!-- DCS datasource -->
<Resource name="jdbc/dcs"
auth="Container"
driverClass="org.postgresql.Driver"

jdbcUrl="jdbc:postgresql://localhost:5432/dcsdb"
user="viewpoint"
password="TDv1i2e3w4"

maxPoolSize="100"
minPoolSize="1"
acquireIncrement="1"
maxIdleTime="120"
factory="org.apache.naming.factory.BeanFactory"
type="com.mchange.v2.c3p0.ComboPooledDataSource"/>

<!-- TD Portlets datasource -->
<Resource name="jdbc/td_portlets"
auth="Container"
driverClass="org.postgresql.Driver"

jdbcUrl="jdbc:postgresql://localhost:5432/td_portlets"
user="viewpoint"
password="TDv1i2e3w4"

maxPoolSize="100"
minPoolSize="1"
acquireIncrement="1"
maxIdleTime="120"
factory="org.apache.naming.factory.BeanFactory"
type="com.mchange.v2.c3p0.ComboPooledDataSource"/>
  1. You need to provide the portal with the database address and port number, and the PostgreSQL username and password you set up earlier.
    <!-- Datasource used by the Liferay portal itself -->
    <Resource name="jdbc/LiferayPool"
    auth="Container"
    driverClass="org.postgresql.Driver"

    jdbcUrl="jdbc:postgresql://localhost:5432/lportal"
    user="viewpoint"
    password="TDv1i2e3w4"

    maxPoolSize="100"
    minPoolSize="1"
    acquireIncrement="1"
    maxIdleTime="120"
    factory="org.apache.naming.factory.BeanFactory"
    type="com.mchange.v2.c3p0.ComboPooledDataSource"/>

  2. Next, configure the datasource for the Data Collection Service. If you want to connect to an existing DCS database, enter the DCS database login details here. Otherwise, make the same changes as above.
  3. You also need to modify the TD Portlets datasource. As before, provide the PostgreSQL system name and port, along with the username and password.

As in server.xml, you need to specify the PostgreSQL system name and port, as well as the username and password.

<!-- TD Portal datasource -->
<Resource name="jdbc/td_portal"
auth="Container"
driverClass="org.postgresql.Driver"

jdbcUrl="jdbc:postgresql://localhost:5432/td_portal"
user="viewpoint"
password="TDv1i2e3w4"

maxPoolSize="100"
minPoolSize="1"
acquireIncrement="1"
maxIdleTime="120"
factory="org.apache.naming.factory.BeanFactory"
type="com.mchange.v2.c3p0.ComboPooledDataSource" />

Edit the file C:\tdpdk-xx.xx.xx.xx\viewpoint-portal\setup\config\viewpoint.properties

You need to uncomment (remove the # at the beginning of) several lines in viewpoint.properties. viewpoint.db.host and viewpoint.db.port only need to be uncommented if the database is not on your local system or if you're using a custom port for the database. viewpoint.db.username and viewpoint.db.password should be uncommented and modified to contain your PostgreSQL username and password.

viewpoint.db.host=localhost
viewpoint.db.port=5432

#lportal.db.name=lportal
#tdportal.db.name=td_portal
#tdportlets.db.name=td_portlets
#dcs.db.name=dcsdb

viewpoint.db.username=viewpoint
viewpoint.db.password=TDv1i2e3w4

Step 5: Running the Viewpoint setup script

C:
cd \tdpdk-xx.xx.xx.xx\viewpoint-portal\setup\bin
setup.bat
  1. Create an environment variable CATALINA_HOME that points to the path for the Teradata Viewpoint Portal (C:\tdpdk-xx.xx.xx.xx\viewpoint-portal).
  2. Open a command prompt and execute the following commands:

Step 6: Start Viewpoint

C:
cd \tdpdk-xx.xx.xx.xx\viewpoint-portal\bin
startup.bat
  1. To start Viewpoint, open a command prompt and execute the following commands:
  2. Allow the Viewpoint to start up fully (log output completes) before continuing on to the next step.

Step 7: Login to Viewpoint

  1. Start a web browser and connect to the portal using a URL as follows:
    • If you're accessing the portal from the system it's installed on with the default settings, the portal URL is http://localhost:8080.
    • If the Teradata Viewpoint Portal server is not running on your local machine, or if you've modified the port number, the URL is always in the form http://machinename:portnumber (replace machinename with the machine name and portnumber with the port number).
  2. Log in to the portal using username "admin" with the default password "teradata"(without the quotation marks).
  3. It is recommended that you change this password after logging in by clicking on Profile in the top right of the screen.
Tags (2)