Informatica Vibe Data Stream for Machine Data Version 2.1.0 Quick Start Guide June 2014 Copyright (c) 2014 Informatica. All rights reserved. Contents Overview... 1 Pre-Installation Tasks... 2 Verify Minimum System Requirements.... 2 Verify Port Availability.... 2 Installation... 3 Installing Vibe Data Stream in Typical Mode.... 3 Installing Vibe Data Stream Nodes on Remote Linux Systems.... 3 Post-Installation Tasks... 4 This guide describes how to quickly install and use Vibe Data Stream for Machine Data 2.1.0 on a single machine with default configuration. Overview An Informatica Vibe Data Stream for Machine Data (VDS) deployment consists of the VDS Node, the Administrator Daemon and Informatica Administrator for VDS (the Administrator tool). You can install Vibe Data Stream components in console mode on a Linux machine or in graphical mode on a Windows machine. When you install VDS, you install the following components: Administration components. Includes the Administrator Daemon, Administrator tool, and Apache ZooKeeper, an optional component. VDS Node. The installation process installs a VDS Node and an Agent that you can use to monitor VDS entities. The VDS installation process includes typical and custom type installations. Note: This guide outlines the typical installation steps to install VDS components. For custom installation steps, see the Vibe Data Stream for Machine Installation and Configuration Guide. VDS-QSG-21000-0000 1
Pre-Installation Tasks Perform the following pre-installation tasks for the VDS Node, Administrator Daemon, and Administrator tool: 1. Get the Vibe Data Stream license key. Informatica sends you the license by email when you download the Vibe Data Stream from Informatica Marketplace. 2. Verify the minimum system requirements and port availability for the VDS components. 3. Extract the installer files. Verify Minimum System Requirements Verify that the machine where you install the administration components and the VDS Node meets the system requirements. The following table describes the minimum system requirements for the VDS components: Component Processor RAM Disk Space Operating System Administration components 4 CPU Cores 2.5 GB 2.5 GB Red Hat Linux 64-bit, Windows 64-bit VDS Node 2 CPU Cores 128 MB 128 MB Red Hat Linux 64-bit, Windows 64-bit Verify Port Availability Verify that the port numbers are available on the machines where you install the administration components and the VDS Node. The following list describes the ports used by the administration components and the VDS Node: Administrator Daemon HTTP port Port on which the Administrator Daemon runs an HTTP server from which the Agent and VDS Node fetch the configurations. the default port is 15381. Topic Resolution Daemon (LBMRD) port Port for the Topic Resolution Daemon (LBMRD). The default port is 15380. Administrator tool port Port for the Administrator tool. Default port in Windows is 7009. The default port in Linux is 7008. Agent port Port the Agent uses to communicate with the Administrator Daemon. The default port is 15384. Apache ZooKeeper port Port of Apache ZooKepeer. The default port is 2181. 2 VDS-QSG-21000-0000
Installation Select typical installation to quickly install the Vibe Data Stream components. You can select typical installation in the following scenarios: To install all VDS components with minimum default configuration on a single machine. To install the ZooKeeper that is included with the VDS installation package. You can optionally set up secure communication between the VDS components. If you choose to set up secure communication, the installer displays additional screens where you can specify the security configuration. Installing Vibe Data Stream in Typical Mode You can install VDS in graphical mode on Windows and in console mode on Linux. 1. Log in to the machine with a system user account. 2. Run install.bat or install.sh from the directory where you extracted the installation files. 3. Accept the terms of the license agreement. 4. Select the typical installation option and optionally set up secure communication, storage, and configuration between the VDS components. 5. Enter the path and file name of the VDS license key and the absolute path for the installation directory. By default, the installer places VDS in the following location: <User Home Directory>\Informatica\<version folder>\vds\ 6. Enter the Informatica domain password. 7. If you select secure communication, specify the following properties: Set up an HTTPS connection for the Administrator tool. Enter the keystore file and port number to use to secure the connection. The default port for secure communication is 8443. Specify whether to use the default Informatica SSL certificates or your SSL certificates to enable secure communication. Specify the keyword and directory for the encryption key for the Informatica domain. Installing Vibe Data Stream Nodes on Remote Linux Systems You can install VDS Nodes on remote Linux systems in silent mode. After you install Vibe Data Stream, the installation process creates the remote VDS Node installation directory remote_node_utils, in the VDS installation directory. Place the vds-node-installer-linuxx86_64.zip file in this directory before you perform remote installation. Before you run the remote installation, enable passwordless connection between the machines where you install the administration components and the machines where you install the VDS Nodes. VDS-QSG-21000-0000 3
Post-Installation Tasks After you install the VDS components, start the components and create the Vibe Data Stream service. 1. Start the Administrator Daemon. To start the Administrator Daemon on Linux, run the following command from the <VDS installation directory>/<version>/admind/bin directory:./admind.sh start The admind.sh script starts the Administrator Daemon, LBMRD, and Apache ZooKeeper. 2. Start the Agent and VDS Node. To start the Agent on Linux, run the following command from the <VDS installation directory>/ <version>/agent/bin directory:./agent.sh start To start the VDS Node on Linux, the following command from the <VDS installation directory>/ <version>/node/bin directory:./node.sh start <node name> To start a VDS Node installed on a remote machine, run the following command:./remote-node.sh start <node name> 3. Start the Informatica Domain. To start the Informatica domain on Linux, run the following command from the <VDS installation directory>/<version>/tomcat/bin directory:./infaservice.sh startup 4. Log in to the Administrator tool and create a Vibe Data Stream service. 5. On the Domain tab, click Actions > New > Vibe Data Stream Service. 6. Enter the following properties for the service: Name Name of the VDS Service. The name is not case sensitive and must be unique within the Informatica domain. The characters must be compatible with the code page of the associated repository. The name cannot exceed 128 characters or begin with @. It also cannot contain spaces or the following special characters: ` ~ % ^ * + = { } \ ; : ' " /?., < >! ( ) ] [ Description Location License Description of the service. The description cannot exceed 765 characters. Name of the Informatica domain and folder where you want to create the service. Optionally, click Browse to select another folder in the Informatica domain. License assigned to the service. You do not need to select a license as it is associated during installation. 4 VDS-QSG-21000-0000
Assign Node on which the service runs. Select Single Node to assign the service to a node. Node The host name or node in the Informatica domain where the service runs. The following image shows the service properties: 7. Click Finish. 8. Click Apply Licenses in the Contents panel to register the service with the license. 9. To view the Data Flows pane, select the created service and click the Vibe Data Stream tab in the Contents panel. 10. To create a data flow, right-click All Data Flows and select New Data Flow. For more information about creating and managing data flows, see the Vibe Data Stream for Machine User Guide. VDS-QSG-21000-0000 5