Install the lab

After you start the Quick Start VM image, you need to install the lab projects, data files, and toolkits.

You must have Internet access from your virtual machine (VM).

To install the lab package on the Linux VM:

  1. From your VM, download the lab ZIP file (GitHub). Then, extract the files.
  2. Extract the files to streamsadmin home folder.
  3. Double-click the IntroLab_Install.sh shell script. Then, click Run in terminal.
    Detailed progress messages are written to the IntroLab_Install.log file (in the same folder).
    The installation will take about five minutes, depending on the speed of your Internet connection. The installation program builds a required toolkit, which involves downloading additional components.
  4. When the installation is complete, press any key to terminate the script and close the terminal.
    The script removes itself and the installation files archive, so after successful completion you have only the downloaded file, the installation log, and an uninstall script in your home folder (in addition to any files already there before you started).
    The uninstall script, IntroLab_4.1.1_Uninstall.sh, removes all installed files related to this lab, including toolkits, data, and desktop launchers. It does not remove any work you might have done in projects in your own Streams Studio workspace. Use this script if you want to clean up your environment later.

If the installation fails

If installation was not successful, check the installation log. After failure, the script cleans removes any files and directories it already installed.

If you are not using the Quick Start VM and do not have Apache Ant (1.8 or later) or Apache Maven (3.2 or later) installed in your environment, the installation will fail. These two utilities are required to build the Internet Toolkit, which is used in the final lab. Explaining exactly how to install these utilities is beyond the scope of this document. Other causes of failure might be that files cannot be written into subdirectories due to such as permission problems, pre-existing files, and insufficient disk space.

Troubleshooting other failures

If the progress messages and log file don’t help you to figure out the problem and you are an experienced Linux user, use a Terminal window to run the installation script from the command line. Before running the script, run this command:
export DEBUG=yes

Running this command increases the information recorded in the log file and can help you to identify problems.

Check your results

If you successfully installed the lab files, your VMware desktop should look like this:

Your domain and instance are ready to run your applications.