DASH Install

Server and Operating SystemFrom Marvelit

Server Requirements MARVELit DASH is a JAVA application and as such can execute on any platform that suports the Java Virtual Machine. We have installed DASH on Windows, Linux, and Macintosh platforms successfully. Dashwill execute on a smaller footprint machine for a workgroup - or a server for more users. We havesuccessfully implemented DASH on a 1U Windows Server supporting 300 users. It is recommended that adedicated machine be used but DASH will function on a notebook computer for demonstrations or can be installed alongside a data base server. (MySQL, etc.)

For simplicity sake - we will document installation of DASH on Windows and Macintosh environments. TheMac environment is a unix type of installation and as such should be similar to an installation on Linux or Unix. If you are installing DASH on those platforms - we assume that you will be able to review theseinstructions and tailor them for your platform.

Installing Java DASH needs the current JAVA SDK to run.

Windows - access Java 5.0 Downloads (http://java.sun.com/javase/downloads/index_jdk5.jsp) - select the download button next to JDK 5.0 Update 14. You will be taken to a download page - where you candownload the version for your operating system. Download to a folder on your drive - and double click toinstall on your machine. Note the install path as you will need this to set your JAVA_HOME variable in thenext step.

Macintosh - Tiger (10.4.x) has the JAVA SDK installed by default. It's location is /Library/Java/Home. It isnot necessary to install J2SE 5.0 but having it installed will not hurt anything. For more information onJAVA on the Macintosh - see the Apple Java Page (http://www.apple.com/macosx/features/java/)

Setting Java_Home After JAVA is installed - the JAVA_HOME environment variable must be pointed to your JAVA installation.

Windows - Windows allows editing of environment variables in the My Computer - Properties Tab. Right Click on My Computer - select Properties. Select the Advanced Tab and Click on the Environment VariablesButton.

MARVELIT DASH Installation Instructions

1 of 18

In the User Variables box - Edit the JAVA_HOME variable or click New if there is no JAVA_Home displayed. Enter the appropriate entries and click OK. In the above example - Java is installed in theC:\Program Files\Java\jdk1.5.0_02 directory. Some users have reported that they need to also add a Base Directory variable on Windows. To be safe - enter another environment variable: BASEDIR =C:\DASH The directory path needs to be the directory that you will install the software into in the next step. Click OK twice to return to the desktop.

Macintosh - You need to set the JAVA_HOME variable in a terminal session for the login used to start DASH. Click on the terminal program icon in your dock or in the Applications / Utilities folder. A unix shellscript window is opened. Type env and hit enter - the environment variables for that login are displayed.

If your JAVA_HOME variable is missing - enter the following - than hit enter:


2 of 18

export JAVA_HOME=/Library/Java/Home

This will set the JAVA_HOME variable for the session. To have it automatically set whenever you login toterminal - you will need to have that command executed in the profile for that login. See the MAC OS X BASH (http://www.macdevcenter.com/pub/a/mac/2004/02/24/bash.html?page=1) Page for a discussion of this process. See the Working with Bash - Customizing Your Environment section for further information on how to do this.

Retrieved from "http://wiki.marvelit.com/index.php?title=Server_and_Operating_System"


3 of 18

Execute DASH InstallerFrom Marvelit

After you have downloaded the dash.zip file - unpack it into a folder on your hard drive. Two files will bedisplayed. dash-installer.jar and the mysql jdbc driver. To start the install process - double click thedash-installer.jar file.

STEP 1 - The installer start screen is displayed. Click Next.

STEP 2 - Accept the Apache License - Click Accept


4 of 18

STEP 3 - Select an installation Folder - Click the Select Folder button to display a select destination folder screen. Select or create a folder for the installation. Click Next

STEP 4 - Confirm Jetspeed Components - Click Next


5 of 18

STEP 5 - Select your desired Database for DASH and click Next. The standard download contains code forApache derby or MySQL. Derby is an imbedded database and will start automatically with DASH. SelectingDerby will bypass Steps 6,7 as no additional information is needed. If you wish to install on MySQL - clickMySQL and complete Step 6.

STEP 6 - If you selected MySQL - enter the database details. You will need to create a database for DASH -See: Data Base Preparation (http://wiki.marvelit.com/index.php?title=Data_Base_Preparation) For Instructions. If you have downloaded the PDF instructions - see the last several pages of the PDF for details.

The JDBC File for MySQL was included in the dash.zip file. Click Select File navigate and select the mysql-connector-java-5.0.4-bin.jar file.


6 of 18

STEP 7 - If you chose MySQL - Test the database connection by clicking Next. Resolve any connection errors by modifying the parameters in STEP 6.

STEP 8 - Confirm your Installation by clicking Next


7 of 18

STEP 9 - Click Install to begin the Installation

STEP 10 - View Installation Progress


8 of 18

STEP 11 - Installation is Complete. Click OK to leave the installer.

Retrieved from "http://wiki.marvelit.com/index.php?title=Execute_DASH_Installer"


9 of 18

Startup DASH and Update DASH Connection

From Marvelit

Contents

1 Start-up and Shutdown1.1 Windows1.2 Macintosh, Linux or Unix1.3 Execute Startup Scripts1.4 Login as Admin1.5 Enter Key

Start-up and Shutdown

Starting up the Jetspeed portal for the first time will expand all the wars and create a dashboard environment

for you. The startup and shutdown scripts are in the /DASH/bin folder.

Windows

To start the portal on windows, navigate to the bin folder and double click on the startup.bat file. A DOS

window id displayed and messages will display as the portal is started and WARs expanded. The first time the

portal is started - it will expand the Jetspeed WARs and build initial configuration files.

Dash can be set to start as a service. See Setup Tomcat as a Service

(http://tomcat.apache.org/tomcat-5.5-doc/windows-service-howto.html) for instructions on how to set this up.

Once this done, you will start and stop DASH via services in the Windows Management panel. Dash can be set

to start on Windows startup using this method.

To shutdown the portal - double click on shutdown.bat file or close the DOS window to shutdown the portal.

Macintosh, Linux or Unix

To start the portal - you need to execute several commands in a terminal session. Start terminal and navigate to

the bin folder. You can navigate to the /DASH folder in the finder, type cd in your terminal window and drag

the bin folder to your open terminal window. Terminal will place the path to that folder after your cd entry.

Press enter to set the path.

To start the portal - type:

sudo ./catalina.sh start

Hit the return key. Enter your admin password and hit return. Several messages will display. If there is a

JAVA_HOME error - it will display in the window.

To shutdown the portal - type:

sudo ./catalina.sh stop

Hit the return key. Enter your admin password and hit return. Several messages will display. To close the


10 of 18

terminal window - type logout and hit enter.

Execute Startup Scripts

Execute the startup script for your platform.

After the portal is started - wait several minutes DASH to startup.

Login as Admin

Access your DASH installation by entering the following address in your browser:

http://localhost:8080 - this assumes that you are accessing on your machine - otherwise change localhost to a

server name or ip address.

The new Login page is displayed:

Login as admin with admin as the password.

You will need to change your admin password at first login. Type admin as the old password and enter your

new password twice. Click Save.

After you successfully change your admin password - the demo dashboard will be displayed.


11 of 18

Enter Key

DASH is free - and the necessary key for the program to function is provided in the installer. To view this key -

login as admin - select Jetspeed Administration Portlets and pull down to DASH Administration.

Selecting MARVELit Administration displays a page for entering the MARVELit Key, setting the default data

source, setting data maps and adding/updating data sources. See Administration Portlets for more information

on the Administrative portlets.

The first entry is for entering the MARVELit License key. DASH will not operate without a valid Key entered

into this field. The key is included in the installer folder in the README and KEY.TXT files.

After pasting in the key - scroll down several pages - pass the data map section and click the Save Properties

button.

Retrieved from "http://wiki.marvelit.com/index.php?title=Startup_DASH_and_Update_DASH_Connection"


12 of 18

Sample DashboardFrom Marvelit

WELCOME After you have entered your license key - you have installed DASH. We have provided a smapleDASHBOARD for you to use as an example. Click the DASH menu item and the sample dashboard page displays.


13 of 18

You are All Done That's it. You now have DASH configured and can build your own dashboards. Some things to review onthe Welcome pane.

Review each Portlet - click on the pencil icon in the upper right corner of each portlet. Read the sections onMeter, Chart and Report portlets in this wiki.

Chart Portlets (http://wiki.marvelit.com/index.php?title=Chart_Portlets) , How to update and save MARVELit Charts

Report Portlet (http://wiki.marvelit.com/index.php?title=Report_Portlet) , How to update and save MARVELit Reports

Meter Portlet (http://wiki.marvelit.com/index.php?title=Meter_Portlet) , How to update and save MARVELit Meters (dials)

Review the Levers - Select Jetspeed Administration Portlets - than DASH Levers Administration - the Levers are displayed. See the Levers sections for further information.

Levers Portlet (http://wiki.marvelit.com/index.php?title=Levers_Portlet) , How to add Levers (pull down selections) and have them work on a page

Review the Page Layout - click on the pencil icon in the upper right corner of the Welcome page. See thePage Layout sections for further information.

Formating Panes (http://wiki.marvelit.com/index.php?title=Formating_Panes) , Adding Columns andRows to existing Dashboard Panes

What's Next You now can build your own DASHBOARDS. Review the following secitons of this wiki to help you getstarted.

Administration Portlets(http://wiki.marvelit.com/index.php?title=Administration_Portlets#Adding_Data_Sources) , Adding Data Sources - Set up your own data sources

Adding Panes (http://wiki.marvelit.com/index.php?title=Adding_Panes) , How to add or modify dashboard panes in the portalFormating Panes (http://wiki.marvelit.com/index.php?title=Formating_Panes) , Adding Columns andRows to existing Dashboard PanesAdding Portlets to a Pane (http://wiki.marvelit.com/index.php?title=Adding_Portlets) , Adding MARVELit portlets to panes to create dashbboards

Chart Portlet (http://wiki.marvelit.com/index.php?title=Chart_Portlets) , How to update and save MARVELit ChartsReport Portlet (http://wiki.marvelit.com/index.php?title=Report_Portlet) , How to update and save MARVELit ReportsMeter Portlet (http://wiki.marvelit.com/index.php?title=Meter_Portlet) , How to update and save MARVELit Meters (dials)Levers Portlet (http://wiki.marvelit.com/index.php?title=Levers_Portlet) , How to add Levers (pull down selections) and have them work on a pagePortlet Variables (http://wiki.marvelit.com/index.php?title=Portlet_Variables) , How to use Variables in


14 of 18

Portlet configurationsFormat Portlets using XML (http://wiki.marvelit.com/index.php?title=Portlet_XML_Formatting) , How to use XML tags to create custom colors, fonts, and threshholds

There are also some flash movie files on our web site at video.html (http://www.marvelit.com/video.html) that provide a good overview.

Retrieved from "http://wiki.marvelit.com/index.php?title=Sample_Dashboard"


15 of 18

Data Base PreparationFrom Marvelit

MARVELit DASH can obtain data from many types of data sources and use it in creating Charts, Meters and Reports. Additionally, Portal settings and other configuration information needs to be stored in a data base aswell.

Apache Jetspeed 2.1 is the portal used in MARVELit DASH. Jetspeed supports several different databasesystems (mysql, postgres, hsql, derby, oracle, mssql) for storing portal configuration information.

Create Schema We will demonstrate creating a schema for Jetspeed using the MySQL Administration Manager application. You can choose many different tools toaccomplish this. Use the one that you are most comfortable with.

We started the Administration application - clicked Catalogs - clicked the + icon at the bottom of the Schemata List and entered dash as our database. Any name can beused. Just remember it as you will need it during the configuration tasks.

Create User


16 of 18

Once the schema is created, a user needs to be created that will have access to that schema. Once again we used the MySQL Administration application. We created auser named marvelit with access from localhost.

Set User Privliges Finally the user needs to have full control over the schema. Once again we used the MySQL Administrationapplication.


17 of 18

Once JAVA is installed and the data base is set up to receive the portal configuration tables - you can proceed to the next step.

Retrieved from "http://wiki.marvelit.com/index.php?title=Data_Base_Preparation"


18 of 18

Documents

DASH Install