Frequently Asked Questions
Installation and Configuration
Note: Differences between the Developer and Enterprise Editions are listed here.
What's the maximum size for jvm-arg?
You should not set jvm-args in the sbconfig file to a size larger than 1024; if you do the StreamBase server doesn't start. This is a limitation of the Windows 32-bit OS. 32-bit processes can only use a maximum 4 GB of memory address space. Windows further splits that space in half by allocating 2 GB to the kernel and 2 GB to the application. The reason you cannot reach the 2 GB limit within the Java VM is that the VM and OS use memory overhead for the process, so you end up with a bit less than the actual 2 GB limit (1.5 to 1.8 GB, depending on the OS version).
What's the maximum per-process virtual address space?
The Supported system configurations and limits for Red Hat Enterprise Linux releases page gives the value of Maximum x86 per-process virtual address space for Red Hat Enterprise Linux Version 3 as approximately 4 GB. However, StreamBase shared libraries start at about 3 GB up in the address space, so virtual address space will probably not exceed this limit when using StreamBase.
What causes the Path too long installation error?
Installation error 1320 (path is too long):This error can occcur when someone is using a mapped drive, or when the Microsoft subst (Substitute ) command is used to mount drives. This is a known problem with subst, the Microsoft installer, and other software. subst does not resolve path names properly when used with an MSI install.
What algorithm does StreamBase use to encrypt the username and password?
We store a hash of the password in our authentication file, based on MD5. The username is stored in plain text.
When a client connects to the server user authentication, is the username and password that is passed encrypted or in the clear?
Passwords are not encrypted; they are passed to the server encoded in base64 (to handle unusual characters).
Does StreamBase encrypt communication between a client and the server?
StreamBase version 3.x does not provide encryption system for network communication. Beginning in StreamBase 5.0, SSL-encryption of network data is now a configurable setting.
Why do I get incorrect java output from the sb-config command?
If the --java or --javac output from the sb-config command do not generate correct information, check that your JAVA-HOME and PATH environment variables are both set, and verify that the PATH variable contains the correct javac directory path.
What causes protocol version mismatch errors?
An error about a protocol version mismatch can be caused by having either different versions of an adapter and StreamBase (sbd), or different versions of StreamBase installed on the same machine.
Should I allow a connection by StreamBase Studio if my firewall asks?
StreamBase includes StreamBase Studio, which lets you define and test StreamBase applications. When you open an application in StreamBase Studio (for example, launching one of the demos in the Demo perspective), StreamBase Studio makes a local network connection to a StreamBase Server. The purpose of this local server connection is to allow StreamBase Studio to typecheck the application's properties. When this connection is attempted, you may notice two things:
- Your firewall or Internet security software issues a warning message. Click the option that allows StreamBase to make the connection. The option may be worded as Allow, Unblock, or a similar term.
- In StreamBase Studio, the connection progress bar cannot proceed until you allow the firewall or Internet security software to let StreamBase make the connection.
The message from the firewall or security software may refer to sbd.exe (StreamBase Server), or sbstudio-bin.exe (StreamBase Studio), or javaw.exe (Java). Allow StreamBase Studio to make the connection. Note that StreamBase is not performing an outgoing "phone home" connection.
You may see similar messages if you select options on the StreamBase Studio Welcome page that accesses an external website (streambase.com) or opens a topic in the local StreamBase Help (which uses a Java viewer).
What is the Java heap size limit on Windows?
The -Xmx argument in the Streambase configuration file sets the amount of memory that the JVM uses. This limit is 1024m, and anything larger will cause the server to fail to start. This is a Windows restriction, not a StreamBase restriction.
What are the supported platforms?
For detailed information about the software and platform that can be used with StreamBase, please refer to the StreamBase Help topic, Supported Platforms.
How do I troubleshoot the connection to a remote machine?
Here are some things to check if you have trouble connecting to a StreamBase server on a remote machine.
- Ensure that the login is valid on the remote machine.
- Ensure that the remote login has privileges to write files.
- Check for firewalls that block traffic (including hardware firewalls, and software firewalls on Linux and Windows)
- Check that StreamBase is installed on the remote machine, and that all configuration parameters are correct (including PATH and JAVA_HOME).
- Check that the version of StreamBase on the remote machine is the same as the version of Studio (or the client) on the local machine.
- Try using telnet to connect into the machine.
- Check to ensure that the target port is not being used by another program.
How do I run under cron?
Ensure that your runtime environment variables are set correctly, including PATH, LD_LIBRARY_PATH, and JAVA_HOME.
What are the JDK requirements?
On Windows beginning in StreamBase 3.1, the product installation includes its own JDK; while you can choose to have multiple JDKs on your machine, there is no need to install an external JDK separately to run StreamBase.
For detailed information about the software and platform that can be used with StreamBase, please refer to the StreamBase Help topic, Supported Platforms. Note that StreamBase requires the JDK, not simply the JRE.
Are there special requirements for using Streambase on 64-bit Linux?
Here are some tips for using StreamBase on 64-bit Linux machines.
- Do not use the 32-bit Java with 64-bit Linux.
- 32-bit StreamBase is not qualified with 64-bit Linux. We recommend using 64-bit StreamBase with 64-bit Linux.