================================================================================

Product Name:
TIBCO ActiveSpaces(R)
Release Version: 2.1.2_HF-012
Release Date:
April 2014
================================================================================
Legal Notice
This Hotfix is provided pursuant to the terms and conditions of the
written maintenance and support agreement between you (or your company)
and TIBCO and use of the Hotfix is controlled by the terms of such
written maintenance and support agreement.
================================================================================
Introduction
Hotfixes are cumulative. This is the twelfth hotfix for TIBCO ActiveSpaces 2.1.2
.
NOTE: For a description of several new features added in this Hotfix, see the
TIB_activespaces_2.1.2_HF-012_addendum.pdf file.
================================================================================
Fix for OpenSSL TLS Heartbeat Read Overrun
Several versions of the OpenSSL library were reported to be vulnerable to an spe
cific
exploitation that can lead to compromised credentials. The bug in the open
source code was disclosed this week and can also affect ActiveSpaces' integrity
when secured metaspaces are in use.
Hotfix 012 upgrades the SSL library used with ActiveSpaces to to 1.0.1g. Users a
re
advised to regenerate the credentials used with in deployed policies and tokens
(for production environments).
================================================================================
New TIBCO Runtime Agent to Run as-agent, ASMM, AS Hawk Agent as Windows Services
A TIBCO runtime agent has been added to facilitate running the following as Wind
ows
services:
- Java as-agent
- ASMM
- AS Hawk agent
For details on this feature, see the Addendum to Readme
for TIBCO Activespaces Hotfix 012 document.
================================================================================
New Time Scope Feature for Browsers
The ActiveSpaces browser now supports a new time scope setting (CURRENT) that
allows client applications to create queries that return large result sets using
less resources.
The SNAPSHOT time scope provides a "true snapshot" and guarantees that the

result set will contain the exact set of matching tuples stored in the space at
the time the browser is created, even if those resulting records are deleted or
modified while the application iterates over the browser.
However, this means that the seeders and the application creating the query must
use some memory and do some additional processing work at browser creation time
to provide this functionality.
When the query returns a very large result set, the amount of memory required by
the seeders and the querying application to provide the true snapshot
functionality may become a problem source; in that case, the CURRENT time
scope can be used instead.
The CURRENT time scope is a lightweight, best effort, version of the SNAPSHOT
time scope that requires almost no extra memory, and very little initial
processing, but where changes in the space done after a browser was created
with a CURRENT time scope may or may not be visible.
It is advisable to use the CURRENT time scope with key indexes that are of type
TREE. However, the CURRENT time scope setting also works with HASH indexes.
The HASH index might return duplicate values if there is a need to grow the hash
index used with a seeder. If duplicate values are an issue, it is advisable to
switch to the TREE index type.
If there is a seeder join/leave/drop on the space while the browser is being
created or used the CURRENT time scope will throw an exception, because the
iterated data would not be correct. Losing a seeder or having a new seeder
causes redistribution of entries, and this violates the time scope requirements
of the CURRENT setting.
================================================================================
=
Installation
Install this hotfix in the {TIBCO_HOME} directory of all host computers that run
TIBCO ActiveSpaces version 2.1.2.
IMPORTANT NOTE: The 2.1.2 GA release or a subsequent 2.1.2 Hotfix release must b
e
installed before installing 2.1.2 Hotfix 012.
All Platforms:
1. Shut down all running TIBCO applications.
2. Copy and unzip the Hotfix archive for your platform to a temporary location.
3. Copy TIBCOUniversalInstaller.bin or TIBCOUniversalInstaller.exe from
TIBCO_HOME/tools/universal_installer to the temporary location where
you extracted the hotfix.
4. Run the TIBCOUniversalInstaller program.
- Follow the instructions displayed by the installer to complete the
installation
The installer installs the hotfix files for TIBCO ActiveSpaces.

5. Restart your TIBCO applications.

Solaris SPARC Platform:
The installation instructions are the same as for All Platforms; however, you
must include the following in the command to run the TIBCOUniversalInstaller
executable:
-V disableLockChecks="true"
================================================================================
=
Uninstallation
IMPORTANT NOTE: To uninstall ActiveSpaces 2.1.2 hotfixes, you must first uninsta
ll
ActiveSpaces 2.1.2 Hotfix 12, then Hotfix 11, then Hotfix 10, th
en
Hotfix 9, then Hotfix 8, then Hotfix 7, then Hotfix 6, then Hotf
ix 5
then Hotfix 4, then Hotfix 3, then Hotfix 2, than Hotfix 1. Do n
ot
select more than one hotfix for uninstallation at the same time.
Follow these instructions to roll back changes made in all hotfixes since the
last General Availability release.
All Platforms:
1. Shut down all running TIBCO applications.
2. Go to the {TIBCO_HOME}/tools/universal_installer directory and run the
TIBCOUniversalInstaller program.
The TIBCO Installation Manager dialog appears.
3. Click the radio button for Uninstall Products from a TIBCO Home location
and then click Next.
The Universal Uninstaller dialog appears.
4. Click Next.
5. On the Uninstallation Type dialog, make sure that the Custom Uninstall radio
button is selected and then click Next.
The Product Uninstall Selection dialog appears.
6. Check the check box for TIBCO ActiveSpaces 2.1.2 Hotfix 12 and then click Nex
t.
7. On the Pre-Uninstall Summary dialog, verify the product to uninstall
(TIBCO ActiveSpaces 2.1.2 Hotfix 12) and then click Uninstall.
8. Make sure that backup files were created successfully.
9. On the Post-Uninstall Summary dialog, click Finish.

This will restore your pre Hotfix 12 installation.

10. Repeat the uninstallation procedure described in steps 5-9 for each
additional hotfix: Select and uninstall ActiveSpaces Hotfix 11, Hotfix 10,
Hotfix 9, Hotfix 8, Hotfix 7, Hotfix 6, Hotfix 5, Hotfix 4, Hotfix 3, Hotfix
2
and then Hotfix 1.
When you have uninstalled all of the hotfixes, your pre Hotfix 1 installatio
n
is restored.
11. Restart your TIBCO applications and TIBCO ActiveSpaces.
Solaris SPARC Platform:
The uninstallation instructions are the same as for All Platforms; however, you
must include the following in the command to run the TIBCOUniversalInstaller
executable:
-V disableLockChecks="true"
================================================================================
=
Affected Files for ActiveSpaces 2.1.2 Hotfix 012
AS 2.1.2 hotfix 012 installs the following files. Note that some
files are platform-specific and are installed only on that platform.
All Platforms:
{TIBCO_HOME}/as/2.1/lib
as-common.jar
as-agent.jar
as-admin.jar
as-hawk-agent.jar
*as-common*
*as-core*
*as-tibpgm*
*as-tibrv*
{TIBCO_HOME}/as/2.1/bin
as-agent*
as-convert*
as-dump*
as-admin*
{TIBCO_HOME}/as/2.1/asmm/war/WEB-INF
lib/as-common.jar
lib/as-agent.jar
lib/as-admin.jar
classes/com/tibco/as/admin/**
{TIBCO_HOME}/as/2.1/asmm/**
{TIBCO_HOME}/as/2.1/include/c

action.h
admin.h
browser.h
datetime.h
event.h
error.h
eventbrowser.h
filter.h
listener.h
member.h
metaspace.h
persister.h
router.h
security.h
spacedef.h
options.h
space.h
spaceresult.h
tibas.h
tuple.h
types.h
For Windows:
{TIBCO_HOME}\as\2.1\lib
TIBCO.ActiveSpaces.Common.dll
{TIBCO_HOME}\as\2.1\bin
Agent.NET.exe
================================================================================
=
Closed Issues in 2.1.2_HF-012 (This Release)
AS-3506
Hotfix 012 addresses a major OpenSSL vulnerability by upgrading OpenSSL to v1.0.
1g.
AS-3050
Crashes no longer occur on MacOs and Solaris if command line arguments are longe
r
than (1K/2K).
================================================================================
=
Closed Issues in 2.1.2_HF-011
AS-2896
Use of transactions no longer causes memory leak on cluster members.
AS-2897
Protocol timeout no longer is observed when SYNC persistence with no replication
is used
and exception thrown from OnWrite operation.

AS-2920
Ability to set the shared-nothing file sync interval in the SpaceDef has been ad
ded.
AS-2923
When security is used with no token or a token with a dynamic ID, controllers no
longer
reject requestor certificates if their local time is ahead of the requestors by
a few
minutes
AS-2927
Seeder assertion failure errors no longer display when remote client leaves or i
s killed
while it has pending operations.
AS-2956
A TIBCO runtime agent has been added to facilitate running Java as-agent, ASMM,
and the AS
Hawk agent as a Windows service. For details on this feature, see the Addendum t
o Readme
for TIBCO Activespaces Hotfix 011 document.
AS-2958
Transactions are now reflected in the database when ASYNC shared-all persisten
ce is used
AS-2964
The recovery time for shared nothing persistence was longer than it was previous
ly
with AS 2.1.2-HF009. This issue has been fixed.
AS-2989
You can now use the term "connect" as part of admin script with the connect argu
ment
AS-2996
Occasionally, remote client was not able to connect to proxy after network failu
re. This
issue has beens fixed
AS-3002
Provide system-wide statistic information per member. For details on this featu
re, see
the Addendum to Readme for TIBCO Activespaces Hotfix 011 document.
AS-3017
as-admin no longer issues errors about the input if the length of the command is
larger

than 1028.
AS-3034
Killing the proxy while a remote client is operating no longer causes the system
to hang.
AS-3035
Intermittent space_member_def_mismatch exception no longer displays when a remo
te client
defines and joins a space immediately.
AS-3039
The ConnectTimeout value is now exposed in the C and .NET API sets.
================================================================================
=
Closed Issues in 2.1.2_HF-010
AS-2400
Browser count is now correct when a query limit is set and there is more than on
e seeder
with replication.
AS-2515
When seeders are killed one by one the shared nothing persister no longer stays
in the
READY state with resultant data loss.
AS-2541
ActiveSpaces now supports using authentication and identity parameters from admi
n scripts,
the agent command line, and APIs, with secure metaspaces.
AS-2690
The following Hawk methods have been added to the AS Hawk agent:
-

Space Status
Seeder Count
Recover Space
Min Seeder Count

AS-2698
Space size method with bad/wrong filter now throws an exception when issued from
leech clients.
AS-2701
ActiveSpaces now supports a write-behind behind mechanism for the shared-all per
sistence
type.

AS-2704
ActiveSpaces now supports new arguments for rolling logs in as-agent.
AS-2707
A default query limit of 10,000 queries is now implemented, to avoid cluster sta
bility
issues for snapshot queries.
AS-2713
Member names of remote clients are now checked to make sure they are unique.
AS-2730
Shared nothing recovery now occurs for all the spaces when recovery occurs.
AS-2733
Proxy nodes no longer generate a "space_member_def_mismatch" error right after a
remote
client joins a cluster.
AS-2742
Shared Nothing recovery now occurs when a space goes into a suspended state.
AS-2757
As-admin no longer crashes when the listen URL is improper.
AS-2758
The Space size operation now throws an exception if the space is not ready.
AS-2791
OPERATION_TIMEOUT (protocol_timeout) no longer occurs when a remote client begin
s
a transaction
AS-2803
Memory usage no longer increases on the manager node when when of the discovery
nodes
is not present.
AS-2807
A tibasMetaspace_CloseAll function has been added to the C API.
AS-2829
The as-admin session is now closed when quit/bye or exit has been added to a con
trol
script.
AS-2852

the export metaspace operation no longer ignores the secondary index type
(uses key index type in output).
AS-2832
BrowserDef.setRoute now provides and option to enable/disable routing.
AS-2822
On Windows, after first remote invocation is made, CPU usage on an invoked node
is no
longer high.
================================================================================
=
Closed Issues in 2.1.2_HF-009
AS-2286
If a node is killed before recovery completes, the remaining seeders continue
loading data. Recovery is cancelled if a node is killed, and once that node is
restarted, the user needs to issue recover again
AS-2453
Hawk
*
*
*
*

micro-agent for Activespaces for monitoring

members
spaces
space members
space operations (stats, throughput)

AS-2574
Changing index type at the time of recovery is making the space change to the
ready state immediately and invalidates the old shared nothing persistence file.
AS-2588
Query execution should abort if a client leaves the space.
AS-2593
An invalid datetime exception is thrown if user specifies a date part in a query
.
AS-2604
On Solaris Sparc, when discovery nodes are not available, memory usage on non-di
scovery
nodes keeps increasing.
AS-2609
Occasionally browser.stop() hangs when a remote client is used
AS-2624
Using a node of a non-secure cluster as the discovery node for a secure cluster
causes a

memory increase on a non-secure node.

AS-2629
Batch put takes a collection of PutOptions in case each put needs a different
configuration.
AS-2630
Entry ttl can be retrieved from RouterPutOp so same ttl can be applied on other
sites
AS-2642
Cluster stabilization improvements when underlying network is not reliable.
AS-2644
Rolling logs. File logging accepts arguments to set below.
FileLogOptions
--------------------File file;
// File name to be used
int limit;
// File size in bytes before rollover
int fileCount; // Max number of rolling files
boolean append; // Append logs or not
LogLevel level; // Log level to be used
AS-2646
As-admin functionality improvements
AS-2648
Tuple.containsValue method is not working properly for String and byte[] types
AS-2649
Protocol timeout observed when recovery is done for multiple spaces at the same
time
AS-2664
Space state goes to recover state even there is enough replica to recover the se
eder loss
================================================================================
=
Closed Issues in 2.1.2_HF-008
AS-2589
High CPU usage occurs when one or more discovery node is not available
AS-2584
Graceful leave causes a seeder node to crash while leaving space

AS-2580
Space recovery is stuck if recover command is issued before all seeders join the
space
================================================================================
=
Closed Issues in 2.1.2_HF-007
AS-2573
A member cannot connect to a metaspace if the process gets a high file descripto
r
number on Linux.
================================================================================
=
Closed Issues in 2.1.2_HF-006
AS-2551
Host-aware replication takes a long time to distribute data and uses
excessive memory.
================================================================================
=
Closed Issues in 2.1.2_HF-005
AS-2521
Queries with "OR" and "is null" do not return null matches.
AS-2524
BW designer runtime exception occurs when spaces are introspected.
AS-2533
Queries for "is null" / "is not null" do not verify the field names used.
AS-2534
Crash occurred with OpenSSL libraries.
AS-2545
.NET applications compiled using the version 2.0.2 ActiveSpaces DLL did not
run on AS 2.1.2.
AS-2549
When using unicast discovery, clients started before discovery nodes are started
fail to connect to the metaspace,
================================================================================
=

Closed Issues in 2.1.2_HF-004

AS-1615
When there are a large number of as-agents, the members take a long time to conv
ert from
leech state to seeder state.
AS-2480
Seeder crashes when doing a large number of puts on the Mac OS.
AS-2483
If a client joins as SEEDER and issues a recover command for shared nothing pers
istence,
the space goes into the RECOVER state after loading, even though there are eno
ugh
seeders present.
AS-2484
When multiple discovery nodes are used, only one discovery node becomes manager
and the
others keep looping.
AS-2491
When performing recovery of a space from shared-nothing persistence files, a run
-time
crash could be observed on one or more seeder nodes. This issue has been resolve
d.
AS-2492
After performing recovery of a space from shared-nothing persistence files, memo
ry
usage of the seeder nodes is more than what it was prior to failure.
AS-2499
When a lock timeout is used, a client was able to acquire a lock a second time;
therefore, when one lock was released, one lock remained in effect, and the clie
nt
did not release it.
==============================================================================
Closed Issues in 2.1.2_HF-003
AS-2448
Crash observed at non-discovery nodes when network is disabled
AS-2441
Help output of as-admin (create a space with is_routed true flag) should show sp
ace is
routed

AS-2426
Intermittent protocol timeout for put when it is done immediately after getSpace
as leech
role
AS-2425
ActiveSpaces crashes while handling arbitrarily long queries.
AS-2413
Remote client crashes if getSpace is called without defining the space.
AS-2407
Boolean indication of partial or full result for a query with limit can now be c
hecked
by using the Browser.isPartial() method. The method returns TRUE if a full
result was returned and returns FALSE if a partial result was returned.
AS-2405
Return the count for a query result set through the Browser.size() method. Not s
upported
for timescope CURRENT, returns -1. Best effort for timescope NEW, and ALL.
AS-2402
Socket leak when continuous joins/leaves occur.
AS-2375
Using C API when eviction happens event type is expire instead of evict
AS-2354
Add a QueryLimit for the SpaceDef, and allow BrowserDef/ListenerDef/EventBrowser
Def to
overwrite it by calling setQueryLimit.
AS-2316
As-admin stats for query count does not increase when a timescope CURRENT browse
r is created
AS-2245
Need option not to delete old Shared-Nothing files after recovery completes
AS-2228
ASMM not supporting secure metaspace connection.
The syntax for the startupMetaspaces server property now supports a secure
connection by using token values (where the tokens 3, 4, 5, 6 are new).
Example: {"ms","discovery", "listen", "security token file", "domain", "usern
ame",
"password"}

token 0 = metaspace name

token 1 = discovery url
token 2 = listen url
token 3 = security token file path
token 4 = domain
token 5 = user name
token 6 = password (if obfuscated: starts with OBF: enabled by the Jetty
password utility).

This can take the form of one of the three possible combinations:
- Token 0, 1, 2 : The classic case, which includes metaspace name + discovery
URL
+ listen URL.
- Token 0, 1, 2, 3 : Includes the tokens in the classic case plus the security
token
file path (where user authentication is not required).
- Token 0, 1, 2, 3, 4, 5, 6 : Every token is needed.
Token 6 has two forms:
- Clear text password, OR
- Obfuscated password enabled by the Jetty utilty and which starts with "OBF:"
To obfuscate the password, enter the following command:
java -cp jetty-6.1.26.jar:jetty-util-6.1.26.jar org.mortbay.jetty.security. Pass
word
<password>
If the input <password> is obfuscated (i.e.,Starts with "OBF:"), this makes the
password
unobfuscated. The JAR file is located in the asmm/lib folder.
================================================================================
=
Closed Issues in 2.1.2_HF-002
AS-2264
The API method Space.waitForReady does not work properly; the value does not
take effect.
AS-2279
Query performance of the BETWEEN filter. Query performance of a BETWEEN query va
ries
even if there is an index on the queried field.
AS-2300
Negative values cannot be queried using a range.
AS-2311
The CURRENT Timescope does not work with remote clients.
AS-2318

Drops take time even though there isn't any redistribution needed.
AS-2321
Operations that should time out due to a "space_not_ready" condition hang foreve
r.
AS-2327
Filter expressions and tokens were case sensitive (for example, like, between,
not,
abs, is, null, nor, nand, and, or). Users can now use different character
combinations, such as "LIKE" or "BetWeen" in queries.
AS-2328
Add support for using upper/lower methods to manage string input in queries, For
example, upper(name) = "TIBCO".
Note: Using this method, an index on the fields cannot be used, as indexes are
created case sensitive.
AS-2330
In ASMM, the startupMetaspaces property specified in the asmm/server.properties
file
was unable to parse the discovery URL properly when it specified multiple nodes
delimited by a semicolon.
AS-2332
Tuple expiration/eviction is affecting performance of other operations (puts,
gets, and so on).
AS-2333
In ASMM, metaspace connections that were established during startup using the
startupMetaspace property, are no longer reconnected when a different or empty
discovery or listen URL is specified with the same metaspace name. Reconnecting
an
established startup metaspace connection created operational impacts on existing
connected browser clients.
AS-2336
In ASMM, the statistics summary table of all spaces for a metaspace was
intermittently showing zero entry counts when there were large number of spaces
or joined members.
AS-2337
In ASMM, a space browser query with a large number of resulting entries was caus
ing
excessive memory usage. A new property "browserDefaultTimeScope" is introduced
defaulting to CURRENT to reduce the memory usage.
AS-2339
BETWEEN queries should be inclusive for the specified range values. This issue

has been fixed. The BETWEEN Filter is now inclusive (includes the values specifi
ed
for the upper and lower ranges of the query), and the BETWEEN query includes
the values specified for the upper and lower ranges of the query.
AS-2341
Browse methods do not throw invalid filter exception when given filter is wrong
.
================================================================================
=
Closed Issues in 2.1.2_HF-001
AS-2241
The .NET API threw the following exception with a WIN32 installation:
Unhandled Exception: System.IO.FileNotFoundException: Could not load
file or assembly 'TIBCO.ActiveSpaces.Common
AS-2229
Allow field deletion during recovery using a shared nothing persistence file.
AS-2226
Improve redistribution time after a drop.
AS-2223
Fixed crash when key field is not supplied for a tuple for field types String,
Datetime, or Blob (the key field is set to be nullable).
AS-2222
If ActionResult.setFailed() is called or an exception is thrown within a Persist
er
or Router, any further writes to that key might fail.
AS-2219
When a snapshot browser in ActiveSpaces operates on a query with a large result
set,
the ActiveSpaces client ran out of memory.
AS-2218
Cluster crash occurred when large queries were performed.
AS-2216
Loading from shared-nothing persistence files was too slow to be usable.
AS-2179
Queries with large results sometimes caused high memory use at clients and socke
t

problem.
AS-2178
Redistribution should not happen while the space is in the RECOVER state.
AS-1737
If a client was killed right after a commit was called, entries were present
in the space but not in the shared-noting persistence file.
AS-2350
Authentication improvements for as-agents
AS-2351
Between query with composite index causing crash
AS-2355
Space.size is not using key index, and taking long time to execute
AS-2319
Busy socket can cause cluster-wide failure
AS-2337
Excessive memory used in ASMM space browser for query returning large number of
entries
AS-2323
When RV/TIBPGM URL format is wrong there is a crash
AS-2137
Added Metaspace connect timeout property in memberDef in the AS API.
================================================================================
=
TIBCO Product Support
- For an overview of TIBCO Support Services, and information about
getting started with TIBCO Product Support, visit this site:
http://www.tibco.com/services/support/default.jsp
- If you already have a valid maintenance or support contract,
visit the TIBCO Product Support site: https://support.tibco.com
Entry to this site requires a username and password. If you do
not have a username, you can request one.
- Check the TIBCO Product Support site "Late Breaking News" page
for product information that was not available at release time.
================================================================================
Documentation
Product Manuals
* Before installation, access product documentation from the download site
or in the doc folder at the root level on the product media.
* After installation, if documentation has been installed with the product,
access product documentation in the folder TIBCO_HOME/as/2.1/doc.

NOTE: For a description of several new features added in this release

see the TIB_activespaces_2.1.2_HF-010_addendum.pdf file.
================================================================================
Copyright
Copyright (C) 2009-2014 TIBCO Software Inc. ALL RIGHTS RESERVED.
TIBCO Software Inc. Confidential Information