Troubleshooting Content Manager OnDemand - Revision history

Jderrick: Updated links to ODWEK Tracing & CMOD tracing.

2024-02-27T02:28:56Z

Updated links to ODWEK Tracing & CMOD tracing.

← Older revision		Revision as of 02:28, 27 February 2024
Line 48:		Line 48:

	There are a lot of articles on the IBM CMOD support portal for enabling tracing:		There are a lot of articles on the IBM CMOD support portal for enabling tracing:
	[~~http~~://www~~-01~~.ibm.com/support/~~docview.wss?uid=swg21240220~~ Enabling ODWEK Tracing]   [~~http~~://www~~-01~~.ibm.com/support/~~docview.wss?uid=swg21330810~~ Enabling tracing in Content Manager OnDemand server]   [http://www.ibm.com/support/docview.wss?uid=swg21661918 Formatting trace files on Windows]   [https://www.ibm.com/support/knowledgecenter/SSEPCD_10.1.0/com.ibm.ondemand.ir.doc/dodig089.htm Trace Facility for PDF indexer]		[https://www.ibm.com/support/pages/how-do-i-enable-tracing-content-manager-ondemand-web-enablement-kit-odwek Enabling ODWEK Tracing]   [https://www.ibm.com/support/pages/how-enable-trace-ibm-content-manager-ondemand-server Enabling tracing in Content Manager OnDemand server]   [http://www.ibm.com/support/docview.wss?uid=swg21661918 Formatting trace files on Windows]   [https://www.ibm.com/support/knowledgecenter/SSEPCD_10.1.0/com.ibm.ondemand.ir.doc/dodig089.htm Trace Facility for PDF indexer]

	If arssockd doesn't produce a trace file, on platforms that include the strace utility, prefixing your command with: <code> strace -s 256 -f </code> will produce diagnostically valuable output. Search the output for the word 'arslog' in order to find error messages that are unable to be written to the System Log or trace file.		If arssockd doesn't produce a trace file, on platforms that include the strace utility, prefixing your command with: <code> strace -s 256 -f </code> will produce diagnostically valuable output. Search the output for the word 'arslog' in order to find error messages that are unable to be written to the System Log or trace file.

Jderrick: /* Return Codes */

2023-09-22T14:59:17Z

Return Codes

← Older revision		Revision as of 14:59, 22 September 2023
Line 155:		Line 155:
	ARS0429E TSM Error: ANS0266I (RC2302) The dsmEndTxn vote is ABORT, so check the reason field., Return Code=2302, Reason=41, File=arssmsms.cpp		ARS0429E TSM Error: ANS0266I (RC2302) The dsmEndTxn vote is ABORT, so check the reason field., Return Code=2302, Reason=41, File=arssmsms.cpp

	In addition to getting the TSM activity log data, you can look up the return code in the [https://www.ibm.com/~~support~~/~~knowledgecenter~~/en/~~SSGSG7_7~~.1.0~~/com.ibm.itsm.msgs.client.doc/msgs_api_list_intro.html~~ TSM v7.1 API Return Codes] page, to give you a better understanding of where the error might be.		In addition to getting the TSM activity log data, you can look up the return code in the [https://www.ibm.com/docs/en/tsm/7.1.0?topic=api-return-codes-source-file-dsmrch TSM v7.1 API Return Codes] page, to give you a better understanding of where the error might be.

Jderrick: Updated CMOD Troubleshooting Popular articles

2021-01-28T20:43:54Z

Updated CMOD Troubleshooting Popular articles

← Older revision		Revision as of 20:43, 28 January 2021
Line 8:		Line 8:

	Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:		Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:

			[[CMOD server failed while retrieving a resource group]]

	[[ARS1133I\|ARS1133I The last row successfully loaded was X]]		[[ARS1133I\|ARS1133I The last row successfully loaded was X]]

Jderrick: Added new error messages to the troubleshooting page.

2020-03-10T00:26:04Z

Added new error messages to the troubleshooting page.

← Older revision		Revision as of 00:26, 10 March 2020
Line 8:		Line 8:

	Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:		Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:

			[[ARS1133I\|ARS1133I The last row successfully loaded was X]]

			[[ARS1196E\|ARS1196E Invalid generic index file format: >GROUP_FIELD_VALUE;1234567890<]]

			[[ARS1111E\|ARS1111E The application >< does not exist within the application group >AppGroup<]]

	[[ARS1109E\|ARS1109E - Unable to allocate enough memory]]		[[ARS1109E\|ARS1109E - Unable to allocate enough memory]]

Jderrick: Added link to IBM CMOD ARS1109E troubleshooting page.

2020-01-16T18:26:06Z

Added link to IBM CMOD ARS1109E troubleshooting page.

← Older revision		Revision as of 18:26, 16 January 2020
Line 8:		Line 8:

	Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:		Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:

			[[ARS1109E\|ARS1109E - Unable to allocate enough memory]]

	[[ARS0160E\|ARS0160E - <code> arssockd</code> - Unable to load module /opt/IBM/ondemand/V9.5/bin/exits/arssmtsm]]		[[ARS0160E\|ARS0160E - <code> arssockd</code> - Unable to load module /opt/IBM/ondemand/V9.5/bin/exits/arssmtsm]]

Jderrick: Added IBM CMOD arssockd does not start related articles.

2018-10-12T14:40:26Z

Added IBM CMOD arssockd does not start related articles.

← Older revision		Revision as of 14:40, 12 October 2018
Line 3:		Line 3:

	IBM Content Manager OnDemand (IBM "CMOD") is a complex product that integrates the features of many different software components to build a fast, efficient, massively scalable Enterprise Report Management ("ERM") tool. By choosing to integrate with leading-edge tools like IBM DB2, Oracle, and Tivoli Storage Manager, IBM OnDemand benefits from the massive amount of development, features, and performance of these enterprise-class tools. However, this reliance on other tools means that finding the source of problems can be frustrating, as issues with individual components can produce strange errors in CMOD.		IBM Content Manager OnDemand (IBM "CMOD") is a complex product that integrates the features of many different software components to build a fast, efficient, massively scalable Enterprise Report Management ("ERM") tool. By choosing to integrate with leading-edge tools like IBM DB2, Oracle, and Tivoli Storage Manager, IBM OnDemand benefits from the massive amount of development, features, and performance of these enterprise-class tools. However, this reliance on other tools means that finding the source of problems can be frustrating, as issues with individual components can produce strange errors in CMOD.

			= Popular Troubleshooting Articles =
			Some problems and error messages are so common that they have their own pages in the [[Main_Page#IBM_CMOD_Error_Messages_Reference\|IBM CMOD Error Messages Reference]].

			Specifically, the Content Manager OnDemand daemon, <code> arssockd</code> is known to be a regular source of problems, check these pages if the error message is familiar:

			[[ARS0160E\|ARS0160E - <code> arssockd</code> - Unable to load module /opt/IBM/ondemand/V9.5/bin/exits/arssmtsm]]

			[[ARS4014E\|ARS4014E - <code> arssockd</code> - Unable to load >DB2<]]

			[[ARS4012E\|ARS4012E - <code> arssockd</code> - Unable to initialize environment. rc=158]]

			[[LDAP Error: Invalid credentials\|ARS0384E - LDAP Error: Invalid credentials]]

			[[Unable to determine the database engine\|ARS4013E - <code> arssockd</code> - Unable to determine the database engine]]

			[[Unable to initialize server environment\|ARS0147E - <code> arssockd</code> - Unable to initialize server environment]]

			[[The command arssockd can only be run by the owner of the command\|ARS0152E - The command arssockd can only be run by the owner of the command]]

	= Components =		= Components =

Jderrick: Added IBM CMOD trace -ing on AIX with truss.

2018-10-10T18:53:36Z

Added IBM CMOD trace -ing on AIX with truss.

← Older revision		Revision as of 18:53, 10 October 2018
Line 47:		Line 47:

	errpt -a		errpt -a

			If you don't have strace on your AIX server, you can use <code> truss </code> instead.

			truss arssockd -I CMOD_DEV -S

			Search the output in reverse order, looking for errors, permissions issues, or missing files.

	=== Linux ===		=== Linux ===

Jderrick: Added section to IBM CMOD TSM return codes.

2018-08-14T10:35:32Z

Added section to IBM CMOD TSM return codes.

← Older revision		Revision as of 10:35, 14 August 2018
Line 113:		Line 113:

	... and after entering a valid User ID and password, you will see all messages in TSM, as they happen. To exit from Console Mode, simply press Control-C.		... and after entering a valid User ID and password, you will see all messages in TSM, as they happen. To exit from Console Mode, simply press Control-C.

			=== Return Codes ===

			As with DB2, a lot of the IBM CMOD error messages are 'passed through' from Tivoli Storage Manager.

			ARS0429E TSM Error: ANS0266I (RC2302) The dsmEndTxn vote is ABORT, so check the reason field., Return Code=2302, Reason=41, File=arssmsms.cpp

			In addition to getting the TSM activity log data, you can look up the return code in the [https://www.ibm.com/support/knowledgecenter/en/SSGSG7_7.1.0/com.ibm.itsm.msgs.client.doc/msgs_api_list_intro.html TSM v7.1 API Return Codes] page, to give you a better understanding of where the error might be.

Jderrick: Added more IBM CMOD ulimit issues.

2018-05-09T12:11:21Z

Added more IBM CMOD ulimit issues.

← Older revision		Revision as of 12:11, 9 May 2018
Line 30:		Line 30:

	== Operating Systems ==		== Operating Systems ==
	One of the common issues that manifests in [http://www.odusergroup.org/forums/index.php?topic=2496.0 strange] and [https://www-01.ibm.com/support/docview.wss?uid=swg21618982 puzzling] ways is a lack of resources (CPU / Memory). On the UNIX-style platforms, this is controlled by the 'ulimit' command ([https://www.ibm.com/support/knowledgecenter/en/ssw_aix_72/com.ibm.aix.cmds5/ulimit.htm AIX] and [https://access.redhat.com/solutions/61334 Linux]). Given that IBM CMOD is installed on servers, the ulimits should be set to 'unlimited' for all parameters. The only reason to establish limits on OnDemand's access to server resources is if it's installed on a shared system -- but this generally only happens in the smallest of Content Manager OnDemand installations.		One of the common issues that manifests in [http://www.odusergroup.org/forums/index.php?topic=2496.0 strange], [http://www.odusergroup.org/forums/index.php?topic=1187.0 odd], and [https://www-01.ibm.com/support/docview.wss?uid=swg21618982 puzzling] ways is a lack of resources (CPU / Memory). On the UNIX-style platforms, this is controlled by the 'ulimit' command ([https://www.ibm.com/support/knowledgecenter/en/ssw_aix_72/com.ibm.aix.cmds5/ulimit.htm AIX] and [https://access.redhat.com/solutions/61334 Linux]). Given that IBM CMOD is installed on servers, the ulimits should be set to 'unlimited' for all parameters. The only reason to establish limits on OnDemand's access to server resources is if it's installed on a shared system -- but this generally only happens in the smallest of Content Manager OnDemand installations.

	You can view your current ulimits with:		You can view your current ulimits with:

Jderrick: Added IBM CMOD Trace arstfmt

2018-05-09T12:03:44Z

Added IBM CMOD Trace arstfmt

← Older revision		Revision as of 12:03, 9 May 2018
Line 18:		Line 18:
	... specifies maximal tracing for arssockd. It's highly recommended that you only run in this mode while specifically doing debugging, as enabling tracing in Content Manager OnDemand reduces performance of the server.		... specifies maximal tracing for arssockd. It's highly recommended that you only run in this mode while specifically doing debugging, as enabling tracing in Content Manager OnDemand reduces performance of the server.

			There are a lot of articles on the IBM CMOD support portal for enabling tracing:
			[http://www-01.ibm.com/support/docview.wss?uid=swg21240220 Enabling ODWEK Tracing]   [http://www-01.ibm.com/support/docview.wss?uid=swg21330810 Enabling tracing in Content Manager OnDemand server]   [http://www.ibm.com/support/docview.wss?uid=swg21661918 Formatting trace files on Windows]   [https://www.ibm.com/support/knowledgecenter/SSEPCD_10.1.0/com.ibm.ondemand.ir.doc/dodig089.htm Trace Facility for PDF indexer]

	If arssockd doesn't produce a trace file, on platforms that include the strace utility, prefixing your command with: <code> strace -s 256 -f </code> will produce diagnostically valuable output. Search the output for the word 'arslog' in order to find error messages that are unable to be written to the System Log or trace file.		If arssockd doesn't produce a trace file, on platforms that include the strace utility, prefixing your command with: <code> strace -s 256 -f </code> will produce diagnostically valuable output. Search the output for the word 'arslog' in order to find error messages that are unable to be written to the System Log or trace file.