Troubleshooting
If you encounter problems with installation, make sure that your system meets all prerequisites. Next, check the installer log file for potential problems.
Non-Administrator Users Encounter TCT File Lock Error Message
CONFIGURE_FAILED Message in Single Machine Setup
Installing ActiveMatrix Using a Non-default Administrator Account
Administrator
, which was created at the operation system setup, and
tibco
, which was created afterwards and added to Administrator group. As a result,
tibco
is considered as a non-default Administrator. With a non-default Administrator, there are some issues you might encounter:
Problem | Resolution |
---|---|
The file,
machine.xmi , is locked when you create TIBCO ActiveMatrix Administrator Server using TIBCO Configuration Tool.
|
Start TIBCO ConfigurationTool.exe with the Run As Administrator option. |
Access is denied while starting or stopping TIBCO Host from the command-prompt. | Start the command prompt using the Run as Administrator option. |
Edit ActiveMatrix Administrator Server Configuration using TCT to make ActiveMatrix Administrator SSL enabled. Configuring ActiveMatrix Policy Director Governance on this setup fails.
Problem
ActiveMatrix Administrator with SSL disabled is installed in <CONFIG_HOME>. ActiveMatrix Administrator Server Configuration is edited using TCT to make ActiveMatrix Administrator SSL enabled. Configuring ActiveMatrix Policy Director Governance on this setup fails because of SSL keystore location is not detected.
Workaround
When editing configuration of ActiveMatrix Administrator Server using TCT, change the location of Session Scripts and Log Folder from <CONFIG_HOME>/tct/admin.editor/<date-time> to <CONFIG_HOME>/tct/admin/<date-time> in Administration Server Configuration: Summary screen.
ActiveMatrix Administrator Not Starting Due to Database Connection Failure
- Procedure
- Start the SystemNode and
tibcohost
, if stopped, even if the ActiveMatrix Administrator is not working. - In your database server, unlock the user account. When several failed attempts are made at entering a password, ActiveMatrix locks an account. This is often encountered while using ActiveMatrix Administrator with Oracle, especially if an expired password has been changed.
Note: For Oracle, you can unlock a user account by executing the following command in
sqlplus
as a DBA:SQL> alter user <username> account unlock;
- Launch TIBCO Configuration Tool, update the database configuration for the core ActiveMatrix Administrator as follows:
- Select Edit TIBCO ActiveMatrix Administrator Server Configuration .
- From the Select Server Configuration drop-down list, select the enterprise name and server name.
- Check Edit Database Settings.
- If the users or groups are defined in the Administrator database and not in an LDAP server, select Edit Authentication Realm Settings .
- Click Test Connection to verify the settings.
- Click Configure to apply the changes. When the update is complete, TIBCO Configuration Tool restarts the system node.
- Wait for a few minutes for the system node to become available.
- Login to ActiveMatrix Administrator UI, and perform the following steps:
- Navigate to
TIBCO ActiveMatrix Governance JDBC Resource.
Note: Select GovernanceJDBCSharedResource if you upgraded from a prior version. If you do not see this resource template, it means monitoring services were not deployed, and hence you can skip this step. , and select
- In the details section of this resource template, make corrective changes to the configuration, if needed and save the changes.
- Reinstall resource instances and restart applications.
- From the Resource Instances tab of the details section, verify that the resource instance is successfully installed and is in the Running state. There are multiple resource instances if you have a replicated Administrator.
- Navigate to
TIBCO ActiveMatrix Governance JDBC Resource.
- Repeat step 4 for the Resource Templates -
TIBCO ActiveMatrix LogService JDBC Resource and
TIBCO ActiveMatrix PayloadService JDBC Resource.
Note: If you upgraded from prior releases, the names are cl_logservice_jdbc and payloadJdbcSharedResource. If you do not see these resource templates, it means common logging services were not deployed, and hence you can skip this step.
- Restart the SystemNode one more time using the following
tibcohost
commands:- To stop
tibcohost
(.exe):stopNodes -nodeName SystemNode
. Wait for a few minutes for a graceful shutdown. - To start
tibcohost
(.exe):startNodes -nodeName SystemNode
. Wait for a few minutes for the SystemNode to come up.
- To stop
JRE Updater
-
The
TIBCO_HOME
is corrupted and I am unable to invoke the JRE Updater tool again.Replace
TIBCO_HOME/amx/3.x/bin/amx_jre_updater.tra
with the backup of the .tra file created during the last update operation. Invoke the tool and update the JRE_HOME again. -
I do not want to upgrade a selected set of
.tra
or.ini
files. What should I do?By default, all the .tra files inside TIBCO_HOME are updated in any "update" operation irrespective of the TIBCO ActiveMatrix platform version. If you do not want to upgrade any specific .tra or.ini file, exclude that file using the
-excludeFile
argument.
Upgrade or Downgrade
-
After downgrading from 3.4.2, HTTP Connector resource instances are in the "Installed (Start Failed)" and Applications using them are in “Start Failed” State.
If an HTTP Connector is created in 3.4.2 and you downgrade to a release prior to 3.4.2, the HTTP Connector properties introduced in 3.4.1 are not applied to the downgraded version of the HTTP Connector Resource Instance. The HTTP Connector Resource Instance goes to the
Installed (Start Failed)
state and the application referring to the HTTP Connector Resource Instance goes toStart Failed
state. Uninstalling the HTTP connector Resource Instance is not enough in this case. You must recreate the HTTP Connector Resource Template and map the Application to the newly created the HTTP Connector Resource instance corresponding to the HTTP Connector Resource Template. -
The Node Tab in the ActiveMatrix Administrator UI does not show version.
After upgrading or downgrading the Enterprise, clear the browser cache before loading ActiveMatrix Administrator UI. This is required to load some of the new enhancements made in the UI.
-
Runtime is upgraded but Administrator is not updated with the changes in runtime.
If a Host or Node is upgraded or downgraded successfully in runtime, but ActiveMatrix Administrator is still showing the version before upgrade or downgrade, the task
syncupWithRuntime
inHost_build.xml
andNode_build.xml
, which are available inTIBCO_HOME/administrator/<version>/samples
, can be used to update Host and Node in Administrator. Samples of build and data file for Host and Node are shown below.
Host_build.xml
<targetname="syncupWithRuntime"> <ActiveMatrixAdminTask remote="true" propsFile="${instanceProperties}" action="syncupWithRuntime" dataFile="${dataFile}" objectSelector="Host" overwrite="true" merge="true" createIfNotExists="true" force="true" failOnError="false" /> </target>
Host_data.xml
<Host xsi:type="amxdata:Host" name="SecondHost" managementUrl="service:jmx:jmxmp://localHost:36923"> <Version old="3.4.1" new="3.4.2"/> </Host>
Node_build.xml
<targetname="syncupWithRuntime"> <ActiveMatrixAdminTask remote="true" propsFile="${instanceProperties}" action="syncupWithRuntime" dataFile="${dataFile}" objectSelector="Environment/Node" force="true" failOnError="false" /> </target>
Node_data.xml
<Environment xsi:type="amxdata:Environment" name="DevEnvironment" contact="TIBCO"> <Node xsi:type="amxdata:Node" name="DevNode" HostName="SystemHost" > <Version old="3.4.1" new="3.4.2"/> </Node> </Environment>
System Host Downgrade Fails
During downgrade of ActiveMatrix Administrator, ensure that all the Hosts and Nodes in an Enterprise are downgraded or are in the process of downgrading along with the System Host. If any Host is not yet downgraded, the ActiveMatrix Administrator (System Host) downgrade is aborted. If there are other Hosts in the same CONFIG_HOME, they also go through the downgrade process. In such a scenario, you must fix the cause of the System Host failure first and then try to downgrade again.
After upgrading to 3.4.x, if the ActiveMatrix Administrator is SSL enabled, it does not load in the latest browser and the connection cipher suite does not display the correct details.
After upgrading to 3.4.x, if the ActiveMatrix Administrator is SSL-enabled, it does not load in the latest browser and the connection cipher suite does not display the following details:
- Signature Algorithm:
SHA256WithRSA
- Connection Cipher Suite:
TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA
All latest browsers support RSA certificates. Prior to upgrading to ActiveMatrix Service Grid 3.4.x, if the SSL certificate was using DSA then after upgrade, you must update the certificate created using RSA. Update the keystore file used for ActiveMatrix Administrator's HTTP Connector by using the following steps:
Workaround
- Procedure
- Select the Edit TIBCO ActiveMatrix Administrator Server Configuration - V3.4 wizard in the TIBCO Configuration Tool.
- Select Edit Http Connection Settings. The wizard displays the values of the current HTTP connector and its keystores.
- Update the keystore with new one.
- Enter the key alias and password.
- Click Configure. The keystore used by the HTTP connector is updated.
TIBCO Host does not start after downgrading from 3.4.x to 3.3.1
Make sure the TIBCO JRE is updated after uninstalling ActiveMatrix Service Grid 3.4.1 and points to a version JRE 8 Update 162 or lower.
In TIBCO ActiveMatrix setup when secure SystemHost and RemoteHosts (Host for which JMX port is secured) are successfully upgraded to TIBCO ActiveMatrix Service Grid 3.4.2, the Administrator UI does not show the updated version of Hosts correctly.
When you encounter this issue, run the following command after upgrading to TIBCO ActiveMatrix 3.4.2 to update Administrator (SystemNode) to support TLSv1.2.
Go to <TIBCO_HOME>/amx/3.4/bin folder and execute the following command:
tibamx_hostmanager updateAdminToTLSv12 -configHomeLocation <TIBCO_CONFIG_HOME>
In TIBCO ActiveMatrix setup when secure SystemHost and RemoteHosts (Host for which JMX port is secured) are successfully downgraded from TIBCO ActiveMatrix Service Grid 3.4.2 to version earlier than 3.4.0, the Administrator UI does not show the updated version of Hosts correctly.
TIBCO ActiveMatrix Administrator Server by default uses TLSv 1.2 for SSL connection.
Starting with the TIBCO ActiveMatrix® Service Grid 3.4.2, TLSv 1.3 is supported. However, TIBCO ActiveMatrix Administrator Server by default uses TLSv 1.2 for SSL connection.
To update protocol TLSv, follow the steps mentioned below
-
Secure any host from UI.
-
Go to <TIBCO_HOME>/amx/3.4/bin folder and run the following command:
"tibamx_hostmanager updateAdminToTLSv13 -configHomeLocation <TIBCO_CONFIG_HOME>"
-
Go to <CONFIG_HOME>\tibcohost\Admin-amxadmin-instanceOne\data_3.2.x\host\plugins and edit ri_tibco.admin.default.ssl.server_SystemNode_1.0_1686560749194.jar with changing ssl protocol TLSv from 1.2 to 1.3
-
Save the file and restart the admin.
After upgrading to TIBCO ActiveMatrix 3.4.0 Hotfix, Administrator version is displayed as 3.4.0 instead of 3.4.0.<Hotfix version>
- TIBCO ActiveMatrix 3.4.0 is installed (without selecting TIBCO ActiveMatrix PD Governance installation profile) to an earlier version of TIBCO ActiveMatrix setup with TIBCO ActiveMatrix Policy Director Governance configured.
- TIBCO ActiveMatrix 3.4.0 Hotfix is installed in the same <TIBCO_HOME>.
- Upgrade to TIBCO ActiveMatrix 3.4.0 Hotfix fails with the following error:
product feature com.tibco.governance.gws.product.feature:1.2.0 not found in any local machine model
- TIBCO ActiveMatrix 3.4.0 is installed again by selecting only TIBCO ActiveMatrix PD Governance installation profile.
-
If you have installed TIBCO ActiveMatrix Policy Director Governance and already upgraded to TIBCO ActiveMatrix 3.4.0, use the following workaround to apply TIBCO ActiveMatrix 3.4.0 Hotfix:
Run applyPatch command to apply TIBCO ActiveMatrix 3.4.0 Hotfix in this case. After running applyPatch command Administrator version is displayed as 3.4.0.<Hotfix version>.
- If you have installed TIBCO ActiveMatrix Policy Director Governance and not upgraded to TIBCO ActiveMatrix 3.4.0 Hotfix then use Workaround A or Workaround B to upgrade to TIBCO ActiveMatrix 3.4.0 Hotfix:
Workaround A
- Install TIBCO ActiveMatrix 3.4.0 Hotfix again.
- Upgrade using TIBCO Configuration Tool (TCT).
Workaround B
- Procedure
- Navigate to TIBCO_HOME\amx\<version>\scripts\upgrade and edit tct-upgrade.properties file.
- Change the property values as follows:
amx.platform.patch.version=3.4.0.<Hotfix version> amx.node.upgrade.version=3.4.1
- Upgrade using TIBCO Configuration Tool (TCT).