tib activespaces 2.1.2 hf-012 readme

8/10/2019 TIB Activespaces 2.1.2 HF-012 Readme

1/18

================================================================================Product Name: TIBCO ActiveSpaces(R)Release Version: 2.1.2_HF-012Release Date: April 2014

================================================================================Legal Notice

This Hotfix is provided pursuant to the terms and conditions of thewritten maintenance and support agreement between you (or your company)and TIBCO and use of the Hotfix is controlled by the terms of suchwritten 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 specificexploitation that can lead to compromised credentials. The bug in the opensource code was disclosed this week and can also affect ActiveSpaces' integritywhen secured metaspaces are in use.

Hotfix 012 upgrades the SSL library used with ActiveSpaces to to 1.0.1g. Users areadvised 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 Windowsservices:- 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) thatallows client applications to create queries that return large result sets usingless resources.

The SNAPSHOT time scope provides a "true snapshot" and guarantees that the


2/18

result set will contain the exact set of matching tuples stored in the space atthe time the browser is created, even if those resulting records are deleted ormodified while the application iterates over the browser.

However, this means that the seeders and the application creating the query mustuse some memory and do some additional processing work at browser creation timeto provide this functionality.

When the query returns a very large result set, the amount of memory required bythe seeders and the querying application to provide the true snapshotfunctionality may become a problem source; in that case, the CURRENT timescope can be used instead.

The CURRENT time scope is a lightweight, best effort, version of the SNAPSHOTtime scope that requires almost no extra memory, and very little initialprocessing, but where changes in the space done after a browser was createdwith 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 typeTREE. 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 hashindex used with a seeder. If duplicate values are an issue, it is advisable toswitch to the TREE index type.

If there is a seeder join/leave/drop on the space while the browser is beingcreated or used the CURRENT time scope will throw an exception, because theiterated data would not be correct. Losing a seeder or having a new seedercauses redistribution of entries, and this violates the time scope requirementsof 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 be 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.


3/18

5. Restart your TIBCO applications.

Solaris SPARC Platform:

The installation instructions are the same as for All Platforms; however, youmust include the following in the command to run the TIBCOUniversalInstallerexecutable:

-V disableLockChecks="true"

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

Uninstallation

IMPORTANT NOTE: To uninstall ActiveSpaces 2.1.2 hotfixes, you must first uninstall ActiveSpaces 2.1.2 Hotfix 12, then Hotfix 11, then Hotfix 10, then Hotfix 9, then Hotfix 8, then Hotfix 7, then Hotfix 6, then Hotfix 5 then Hotfix 4, then Hotfix 3, then Hotfix 2, than Hotfix 1. Do not

select more than one hotfix for uninstallation at the same time.

Follow these instructions to roll back changes made in all hotfixes since thelast General Availability release.

All Platforms:

1. Shut down all running TIBCO applications.

2. Go to the {TIBCO_HOME}/tools/universal_installer directory and run theTIBCOUniversalInstaller 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 Next.

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.


4/18

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, Hotfix2 and then Hotfix 1.

When you have uninstalled all of the hotfixes, your pre Hotfix 1 installation is restored.

11. Restart your TIBCO applications and TIBCO ActiveSpaces.

Solaris SPARC Platform:

The uninstallation instructions are the same as for All Platforms; however, youmust include the following in the command to run the TIBCOUniversalInstallerexecutable:

-V disableLockChecks="true"

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

Affected Files for ActiveSpaces 2.1.2 Hotfix 012

AS 2.1.2 hotfix 012 installs the following files. Note that somefiles 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/binas-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


5/18

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\binAgent.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 longerthan (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 replicationis usedand exception thrown from OnWrite operation.


6/18

AS-2920

Ability to set the shared-nothing file sync interval in the SpaceDef has been added.

AS-2923

When security is used with no token or a token with a dynamic ID, controllers nolongerreject requestor certificates if their local time is ahead of the requestors bya fewminutes

AS-2927

Seeder assertion failure errors no longer display when remote client leaves or is killedwhile 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 to Readmefor TIBCO Activespaces Hotfix 011 document.

AS-2958

Transactions are now reflected in the database when ASYNC shared-all persistence is used

AS-2964

The recovery time for shared nothing persistence was longer than it was previously

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 argument

AS-2996

Occasionally, remote client was not able to connect to proxy after network failure. Thisissue has beens fixed

AS-3002

Provide system-wide statistic information per member. For details on this feature, seethe 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 islarger


7/18

than 1028.

AS-3034

Killing the proxy while a remote client is operating no longer causes the systemto hang.

AS-3035

Intermittent space_member_def_mismatch exception no longer displays when a remote clientdefines and joins a space immediately.

AS-3039

The ConnectTimeout value is now exposed in the C and .NET API sets.

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


AS-2400

Browser count is now correct when a query limit is set and there is more than one seederwith replication.

AS-2515

When seeders are killed one by one the shared nothing persister no longer staysin theREADY 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 fromleech clients.

AS-2701

ActiveSpaces now supports a write-behind behind mechanism for the shared-all persistencetype.


8/18

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 stabilityissues 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 aremoteclient 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 beginsa transaction

AS-2803

Memory usage no longer increases on the manager node when when of the discoverynodesis 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 controlscript.

AS-2852


9/18

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 nodeis nolonger high.

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


AS-2286

If a node is killed before recovery completes, the remaining seeders continueloading data. Recovery is cancelled if a node is killed, and once that node isrestarted, 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 theready 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-discovery

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 clustercauses a


10/18

memory increase on a non-secure node.

AS-2629

Batch put takes a collection of PutOptions in case each put needs a differentconfiguration.

AS-2630

Entry ttl can be retrieved from RouterPutOp so same ttl can be applied on othersites

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 sametime

AS-2664

Space state goes to recover state even there is enough replica to recover the seeder loss

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


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


11/18

AS-2580

Space recovery is stuck if recover command is issued before all seeders join thespace

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


AS-2573

A member cannot connect to a metaspace if the process gets a high file descriptornumber on Linux.

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


AS-2551

Host-aware replication takes a long time to distribute data and uses

excessive memory.

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


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 startedfail to connect to the metaspace,

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


12/18


AS-1615

When there are a large number of as-agents, the members take a long time to convert fromleech 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 persistence,the space goes into the RECOVER state after loading, even though there are enoughseeders present.

AS-2484

When multiple discovery nodes are used, only one discovery node becomes manager

and theothers keep looping.

AS-2491

When performing recovery of a space from shared-nothing persistence files, a run-timecrash could be observed on one or more seeder nodes. This issue has been resolved.

AS-2492

After performing recovery of a space from shared-nothing persistence files, memo

ryusage 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 clientdid not release it.

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


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 space isrouted


13/18

AS-2426

Intermittent protocol timeout for put when it is done immediately after getSpaceas leechrole

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 checkedby using the Browser.isPartial() method. The method returns TRUE if a fullresult 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 supportedfor 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/EventBrowserDef tooverwrite it by calling setQueryLimit.

AS-2316

As-admin stats for query count does not increase when a timescope CURRENT browser is created

AS-2245

Need option not to delete old Shared-Nothing files after recovery completes

AS-2228ASMM not supporting secure metaspace connection.

The syntax for the startupMetaspaces server property now supports a secureconnection by using token values (where the tokens 3, 4, 5, 6 are new).

Example: {"ms","discovery", "listen", "security token file", "domain", "username", "password"}


14/18

- 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 + discoveryURL + listen URL. - Token 0, 1, 2, 3 : Includes the tokens in the classic case plus the securitytoken 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. Password

If the input is obfuscated (i.e.,Starts with "OBF:"), this makes thepasswordunobfuscated. The JAR file is located in the asmm/lib folder.

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


AS-2264

The API method Space.waitForReady does not work properly; the value does nottake effect.

AS-2279

Query performance of the BETWEEN filter. Query performance of a BETWEEN query varieseven 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


15/18


16/18

has been fixed. The BETWEEN Filter is now inclusive (includes the values specifiedfor the upper and lower ranges of the query), and the BETWEEN query includesthe 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.

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


AS-2241

The .NET API threw the following exception with a WIN32 installation:

Unhandled Exception: System.IO.FileNotFoundException: Could not loadfile 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 Persisteror Router, any further writes to that key might fail.

AS-2219

When a snapshot browser in ActiveSpaces operates on a query with a large resultset,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 socket


17/18

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 presentin the space but not in the shared-noting persistence file.

AS-2350Authentication improvements for as-agents

AS-2351Between query with composite index causing crash

AS-2355Space.size is not using key index, and taking long time to execute

AS-2319Busy socket can cause cluster-wide failure

AS-2337

Excessive memory used in ASMM space browser for query returning large number ofentries

AS-2323When RV/TIBPGM URL format is wrong there is a crash

AS-2137Added Metaspace connect timeout property in memberDef in the AS API.

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

TIBCO Product Support

- For an overview of TIBCO Support Services, and information aboutgetting 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 donot 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 siteor 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.


18/18

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

tib activespaces 2.1.2 hf-012 readme

Documents