Install the Quick Start Edition

You have different options about what to install, but it’s recommended that you install the Quick Start Edition virtual machine. The following software is already installed on the Quick Start VMware image:

  • Red Hat Enterprise Linux 6.8 (64-bit)
  • IBM Streams Quick Start Edition 4.2.0.0, including Streams Studio

The Quick Start VMware Image has the following configuration:

Parameter Value
Host name streamsqse (streamsqse.localdomain)
User and administrator ID streamsadmin (logged in automatically)
User home directory /home/streamsadmin
User password passw0rd (password with a zero for the O)
root password passw0rd
Streams domain StreamsDomain (started automatically)
Streams instance StreamsInstance (started automatically)

 

In the Quick Start VMware Image, a domain (StreamsDomain) and instance (StreamsInstance) are already created and automatically started. This means that everything you need to run and test your applications is already prepared for you.

domain is a logical grouping of resources in a network for the purpose of common management and administration. The domain is managed by a small number of Linux services (daemons) for tasks such as authentication and authorization, auditing, and supporting the Streams Console.

A domain can contain one or more Streams instances that share the domain’s security model. An instance provides the runtime environment where you can submit applications to. It consists of a small number of additional services, for example, a resource manager, an application manager, and a scheduler.

The labs in this course do not explore the creation and administration of domains and instances.

System requirements

Components Minimum requirements Comments
Operating system 64-bit operating system that supports VMware VMware is supported on the following operating systems:

  • Apple Mac OS X
  • Linux
  • Microsoft Windows
Memory 8GB The amount of memory that is required by IBM Streams depends on the applications that are developed and deployed. This minimum requirement is based on the memory requirements of the Commodity Purchasing sample application and other samples that are provided with the product.
Disk space 20GB
VMware product VMware product that runs on a 64-bit operating system To run the Quick Start Edition VMware image, one of the following VMware products must be installed on your system:

  • For Apple Mac OS X, VMware Fusion 4, or later
  • For Microsoft Windows or Linux, one of the following products: VMware Player 5, or later; VMware Workstation 8, or later; VMware Server

Before you begin

Your Streams ID for the Quick Start Edition is streamsadmin, and your password is passw0rd. The root ID password is also passw0rd.

Performance notes

  • By default, the Quick Start Edition virtual machine is configured to have two processor cores and 4GB of memory. Depending on your system resources and the applications that you develop and deploy, you might be able to improve performance by allocating more processor cores and memory to the virtual machine. You can adjust the processor and memory configuration by updating your virtual machine settings. For example, to update these settings for the VMware Player, click Player > Manage > Virtual Machine Settings.
  • If you import the VMware image into a non-VMware virtualization product and have performance problems with the image, enable any available options that can reduce guest disk input/output latency. For example, in the VirtualBox program from Oracle, select the Use Host I/O Cache option in the Storage Controller settings for the virtual machine.

Procedure

VMware Player/Workstation

  1. Download the vmware-streamsVxxx.zip file (where Vxxx is the version number of the Quick Start Edition).
  2. Extract the contents of the vmware-streamsVxxx.zip file.
    This .zip file contains the following files:
    vmware-streamsVxxx-qse-v1.vmx, which is in the vmware-streamsVxxx-qse-v1.vmwarevm directory
    Several Virtual Disk-snumber.vmdk files, which are in the vmware-streamsVxxx-qse-v1.vmwarevm directory
  3. Start the Quick Start Edition VMware image by double-clicking the vmware-streamsVxxx-qse-v1.vmx file.
  4. The first time that you start the image, respond to the following prompts:
    • Select I copied it to indicate that the virtual machine was copied. CentOS splash screen is displayed, and then followed by several screens of status messages.
    • Accept all of the following license agreements:
      • CentOS
      • VMware tools
      • IBM Streams

      To navigate in the license agreement screens, use the Tab and Arrow keys. Press the Enter key to continue.
      After you accept the license agreements, status messages are displayed and the Quick Start Edition VMware image desktop opens.

Oracle VirtualBox

  1. Download the ova-streams-Vxxx-qse-v1.ova file (where Vxxx is the version number of the Quick Start Edition).
  2. Open the ova-streams-Vxxx-qse-v1.ova file with VirtualBox Manager.
  3. Select Import when prompted to on the Import Virtual Appliance dialog.
  4. Open the settings for the imported VM. Go to Network and expand Advanced. Select Cable Connected, and click OK.
  5. Double-click the imported VM to start it.
  6. The first time that you start the image, accept all of the following license agreements:
    • CentOS
    • VMware tools
    • IBM Streams

    To navigate in the license agreement screens, use the Tab and Arrow keys. Press the Enter key to continue.
    After you accept the license agreements, status messages are displayed and the Quick Start Edition VMware image desktop opens.