Installing SQLstream s-Studio

<< Click to Display Table of Contents >>

Navigation:  Installing SQLstream Blaze > Installing s-Studio and Client Tools as Standalone Packages >

Installing SQLstream s-Studio

Previous pageReturn to chapter overviewNext page

By default, s-Studio installs as part of the s-Server package. These instructions are for installing s-Studio in a standalone context.

s-Studio is a client for s-Server which lets you view, query, and create streams, tables, views, pumps, and other objects. It installs on either Windows or Linux and communicates with s-Server via JDBC. While you can install SQLstream s-Studio as part of the s-Server installation, you can also install it on a separate machine, as long as that machine can reach s-Server via JDBC. SQLstream s-Studio can be installed on either Windows or Linux.

S-Studio Requirements

All SQLstream Studio system memory and disk requirements are above and  beyond SQLstream Server system requirements when running on the same physical or virtual machine.

Component

Details

Windows

Windows 8/8.1, Windows 7, or Windows Vista.  Both 32-bit or 64-bit versions are supported, although SQLstream Studio runs as a 32-bit application. Home, Home Premium, Professional, Enterprise, and Ultimate editions of Windows 7 and Windows Vista are supported.

Linux

A 2.6 or later Linux kernel distribution with Libc version 2.4 or later. Other Linux kernel versions are not supported.

Versions known to work include  CentOS 5.x, Centos 6.x, Mageia 3, Redhat Enterprise Linux 5.x, Redhat Enterprise Linux 6.x, Ubuntu 10.04 LTS (Lucid Lynx), Ubuntu 11.04 (Natty Narwhal), Ubuntu 11.10 (Oneiric Ocelot), Ubuntu 12.04 (Precise Pangolin), Ubuntu 13.04 (Raring Ringtail)

Disk space

Installed software requires 1GB. Log files, repository, and so on require an additional 1 GB.

The amount actually used will depend on how you configure logging, how many objects you create, and so on.

2GB is probably a safe minimum for an initial install.

See SQLstream s-Server Installation Directories for more information on installation directories.

Memory

2G RAM, 1G available disk space. When running under VMWare, 2G physical RAM required on guest system.

Java

A 32-bit or 64-bit JRE (Java Runtime Environment) version 7 Update 25 or later.  Earlier versions of Java are not supported.  Use the 32-bit JRE for 32-bit Windows s-Studio installations. Use the 64-bit JRE for 64-bit Windows or Linux installations

 s-Studio installations.

Installation Steps

The following instructions apply to Linux. Windows installation proceeds similarly.

1.From a terminal prompt enter ./SQLstream-sStudio-X.Y.Z-x64.run, where X.Y.Z represent the release and version numbers, as in SQLstream-3.0.0, and x64 or x32 represents running on a 64-bit or 32-bit operating system.

When the installer begins, the following splash page appears:

splash

 

oIf it does not work, make sure the file is executable (by running chmod +x SQLstream-sStudio-X.Y.Z-x64.run), and try double-clicking the SQLstream icon again.
oIf the installer still does not launch, it generally means JAVA_HOME is not in the default PATH, so the installer fails to find/run Java to execute the installer. Ensure that JAVA_HOME is in the default PATH and try double-clicking the icon again;

A Welcome page appears, introducing the Setup Wizard.

2.Click Forward. The SQLstream license text appears in a new dialog box.

inst_installer_studio_license

3.Click the radio button next to I accept and then click Forward.

The Installation Directories page appears. This page lets you select directories for s-Studio. Note: the installation user must have permission for these directories.To change directories, click the browse button to the right of the directory field.

inst_installer_studio_directory

4.Click Forward.

The Default Server Host Name page appears. Enter the name of the server on which your installation of s-Server runs. If you do not know this location, please consult your system administrator.

inst_studio_default_host_name

5.Click Forward to begin the installation process, which then displays a progress bar to show you how far along installation has progressed.

inst_studio_installer_installing

Installation is complete when the progress bar reaches 100%. You will see a confirmation dialog box.

inst_installer_completed

6.Click Finish to exit the installer and/or view the Readme file.

When you launch s-Studio for the first time, you will need to enter connection information for your installation of s-Server.

Configuring s-Studio to Connect to s-Server

To configure s-Server to connect to s-Server:

1.Determine connection information for the s-Server instance. For example, if s-Server is installed locally, your system administrator will have this. If it is installed as an Amazon Machine Image, this will appear on the home page for the AMI.
2.Right click on First SQLstream Server and choose Properties.

inst_connect_s-server_not_default

3.Enter the JDBC URL for the s-Server instance.

inst_s-studio_connection_properties_not_default

4.Click OK. The left pane of SQLstream s-Studio should populate with objects from the s-Server instance.