Content Server debug options (draft)

Some of debug options are described incorrectly in Administration and Configuration Guide under “Running administration method” chapter (SET_OPTIONS paragraph), some not described at all, below is the complete list:

option

description

acs_connector_trace
apply_lock
assert_fatal
audit_purge_policy_cache_trace
ca_store_trace
change_check_leak
change_check_turbo
change_check_turbo_crunch
checkpoint_leak
clean
crypto_trace
debug
debug_fork_child
debug_fork_error
debugger
development
docbroker_trace Logs projection RPCs to docbroker
dqltrace Trace DQL statements
dql_update_trace Show how many objects were updated by content server and how many updates were delegated to DFC
ecpool_trace
enable_assume_user Enables executing docbase methods having run_as_server=F (insecure!)
file_store_trace Trace write operations to content resided on filesystem
fscheck Allow to create dm_filestore object pointing to existing directory
group_cache_trace Trace operations with group cache
heap_global
heap_ignore_validation
heap_tag_exception
heap_tags_off
heap_validation
i18n_trace
last_sql_trace Disable (default is enabled) dumb error message about last executed sql-statement in case of server session crash
lazy
linkstore_acl_warning
lock_trace
log_authentication_errors Log non-existing user authentication attempts
netaddr_by_name
net_ip_addr
nettrace
nettrace_all
netwise_addressing
no_change_check Disable deferred updates
no_exception
print_trace
report_dctm_exceptions
retention_trace
rpctrace Trace execution of RPCs (very similar to DFC RPC trace)
small_partitions
sql_perf_trace
sqltrace Trace SQL statements passed to database
stack_walk_off Disables printing stack information to server log when server session crashes
sync_change_check Launch one single thread for deferred updates
sync_checkpoint
table_copy
thread_debug
ticket_trace Traces creation and validation of tickets application tokens
topic_synchlaunch
trace_authentication Trace authentication process
trace_complete_launch Trace launching of processes and java methods
trace_http_post Trace information sent through HTTP_POST and DO_METHOD RPCs
trace_method_server
trace_undertaker
trace_workflow_agent Trace workflow agent activity
translate_always
upgrade_trace

Examples:

rpc_trace

[RPC]   dmadmin at docu70dev01(192.168.2.56) called GET_ERRORS(0000000000000000)
[RPC]   Exiting GET_ERRORS      TIME    0,0000020000    SQLTIME 0,0000000000
[RPC]   dmadmin at docu70dev01(192.168.2.56) called END_PUSH_V2(0000000000000000)
[RPC]   Exiting END_PUSH_V2     TIME    0,0000800000    SQLTIME 0,0000000000
[RPC]   dmadmin at docu70dev01(192.168.2.56) called KILL_PUSHER(0000000000000000)
[RPC]   Exiting KILL_PUSHER     TIME    0,0000050000    SQLTIME 0,0000000000

group_cache_trace

[GRP]   User : dmadmin, Building Group Caches
[GRP]   User : dmadmin, Group : admingroup inserted into IN member cache
[GRP]   User : dmadmin, Group : dm_fulltext_admin inserted into IN member cache
[GRP]   User : dmadmin, Group : dm_workflow_task_supervisor inserted into IN member cache
[GRP]   User : dmadmin, Group : dm_xcp_deployer inserted into IN member cache
[GRP]   User : dmadmin, Group : docu inserted into IN member cache
[GRP]   User : dmadmin, Group : process_report_admin inserted into IN member cache
[GRP]   User : dmadmin, Group : queue_admin inserted into IN member cache
[GRP]   User : dmadmin, Group : queue_manager inserted into IN member cache
[GRP]   User : dmadmin, Group : queue_processor inserted into IN member cache
[GRP]   User : dmadmin, Group found in cache
[GRP]   User : dmadmin, Group : dm_world inserted into IN member cache

trace_authentication

[AUTH]  Entering RPC AUTHENTICATE_USER
[AUTH]  Start Authentication : LOGON_NAME=dmadmin, DOMAIN_NAME=, OS_LOGON_NAME=dmadmin,
[AUTH]  Start Authenticate Client Instance
[AUTH]  Client stance dfc_KRNTULXNzUmST9dnor2VUDiDcika is found in cache
[AUTH]  End Authenticate Client Instance
[AUTH]  Start-AuthenticateUser: ClientHost(docu70dev01), LogonName(dmadmin),
[AUTH]  Start-AuthenticateUserName:
[AUTH]  dmResolveNamesForCredentials: auth_protocol()
[AUTH]  End-AuthenticateUserName: dm_user.user_login_domain(), Result: 1
[AUTH]  Found dm_user.user_login_name(dmadmin), dm_user.user_login_domain()
[AUTH]  Start-AuthenticateDomain:LogonName(dmadmin), UserExtraDomain(), auth_protocol()
[AUTH]  AuthenticateDomain - no domain required:domainOverride(False),...
[AUTH]  End-AuthenticateDomain: 1
[AUTH]  Start-AuthenticateUserState:UserLoginName(dmadmin), UserExtraDomain()
[AUTH]  Start-AuthenticateUserState:
[AUTH]  dmStateForUser: auth_protocol()
[AUTH]  End-AuthenticateUserState: 1
[AUTH]  Start-AuthenticateByTrust:OSLogonName(dmadmin), UserLoginName(dmadmin), ...
[AUTH]  End-AuthenticateByTrust: 1
[AUTH]  Create Session Log for user : dmadmin, FILE NAME : 0101ffd78003909e
[AUTH]  Done creating Session Log File for user : dmadmin
[AUTH]  Final Auth Result=T, LOGON_NAME=dmadmin, AUTHENTICATION_LEVEL=9, ...
[AUTH]  Exiting RPC AUTHENTICATE_USER

log_authentication_errors

[DM_USER_E_NOT_DOCUMENTUM_USER]error:  "User test does not exist in the docbase"

dqltrace

[DQL]   User:dmadmin Args:50,0,0,1,0 select count(*) from dm_user

sqltrace

[SQL]   101     select all count(*) from dm_user_sp  dm_user
[SQL]   101     EXEC    0.0013790000
[SQL]   101     FETCH(1)        0.0000300000

file_store_trace

[FST]   Opened content file /u01/documentum/cs/data/...
[DM_STORAGE_T_FILESTORE_TRACE]info:  "Opened content file...
[FST]   Writing 60280 bytes to /u01/documentum/cs/data/s...
[DM_STORAGE_T_FILESTORE_TRACE]info:  "Writing 60280 bytes ...
[FST]   File /u01/documentum/cs/data/ssc_dev/content_s...
[DM_STORAGE_T_FILESTORE_TRACE]info:  "File /u01/documentum/cs/data/...

ticket_trace

TICKET TRACE: GenerateTicket: Logged in user (dmadmin, dmadmin) to generate ticket for...
TICKET TRACE: GenerateTicket: password = **********, strlen(password) = 10
TICKET TRACE: GenerateTicket : Ticket version to be generated = 3
TICKET TRACE: GenerateTicket : Encrypted Password Info : strlen(encrypted_password) = 108
TICKET TRACE: GenerateTicket : Generate Signature Step1: ticketBufferLength = 486
TICKET TRACE: GenerateTicket : Generate Signature Step2: Successfully signed version 3 ...
TICKET TRACE: GenerateTicket : Ticket Signed : Successfully copied signature into ....
TICKET TRACE: GenerateTicket : Ticket Signed: Encode Ticket: encodedBufferLength=822, 
TICKET TRACE: GenerateTicket : Final result=success

TICKET TRACE: VerifyTicket : length of ASCII-encoded buffer = 686 ASCII-encoded ticket ...
TICKET TRACE: VerifyTicket : Decode status: 1, decodedTicketBufferLength = 507
TICKET TRACE: ASCII-decoded ticket buffer successfully loaded in dmLoginTicket.
TICKET TRACE: VerifyTicket: ASCII-decoded ticket length=507
TICKET TRACE: VerifyTicket : Signature saved: signatureLength = 112
TICKET TRACE: VerifyTicket : Verify Signature: After signature is removed from ..
TICKET TRACE: VerifyTicket : Verify ticket signature: status = 0, signature_match = 1
TICKET TRACE: VerifyTicket : Successfully verified v3 ticket signature!
TICKET TRACE: Verify ticket: This ticket is not for single-use.
TICKET TRACE: Verify ticket: This ticket is not for global use.
TICKET TRACE: VerifyTicket : Final result=success

stack_walk_off

off:

documentum: dmconn.cxx:287: unsigned int dmSessionThreadStart(dmExecutionContext*, void*): 
    Assertion `0' failed.
 Last SQL statement executed by DB was:


#0  0xf7733430 in __kernel_vsyscall ()
#1  0x008a733b in waitpid () from /lib/libpthread.so.0
#2  0x0859786f in dmExceptionManager::WalkStack(dmException*, int, siginfo*, void*) ()
#3  0x08597bcb in dmExceptionHandlerProc ()
#4  <signal handler called>
#5  0xf7733430 in __kernel_vsyscall ()
#6  0x005c0b11 in raise () from /lib/libc.so.6
#7  0x005c23ea in abort () from /lib/libc.so.6
#8  0x005b9deb in __assert_fail_base () from /lib/libc.so.6
#9  0x005b9ea6 in __assert_fail () from /lib/libc.so.6
#10 0x080874dc in dmSessionThreadStart(dmExecutionContext*, void*) ()
#11 0x0857c624 in dmFork::Launch() ()
#12 0x08087e25 in dmServerExecutionContextPool::ProcessRequests() ()
#13 0x080885b8 in rpc_main(char const*, dmServiceFailoverList&, dmSession*) ()
#14 0x0805c534 in dmRPCInit(char const*, char const*, long, char const*, 
    dmServiceFailoverList&, dmObject&) ()
#15 0x08060c09 in dmRPCMain(int, char const**, dmBool, dmBool) ()
#16 0x08061231 in main ()

on:

documentum: dmconn.cxx:287: unsigned int dmSessionThreadStart(dmExecutionContext*, void*): 
     Assertion `0' failed.
 Last SQL statement executed by DB was:

enable_assume_user

off:

API> apply,c,,DO_METHOD,METHOD,S,echo
...
q0
API> getmessage,c,
...
[DM_METHOD_E_ASSUME_USER_UV]error:  
   "Your method named (echo) failed to execute because the assume user 
    process could not validation your user credentials.  
    Assume User Process returned (245=DM_CHKPASS_BAD_LOGIN)."

on:

API> apply,c,,DO_METHOD,METHOD,S,echo
...
[DM_METHOD_E_ASSUME_USER_OS]error:  
   "Your method named (echo) could not be executed because the assume 
    user feature is not supported in the current OS platform."

but:

API> apply,c,,DO_METHOD,METHOD,S,mail
...
q0
API> next,c,q0
...
OK
API> dump,c,q0
...
USER ATTRIBUTES

  result                          : 1
  process_id                      : 7054
  launch_failed                   : F
  method_return_val               : 1
  os_system_error                 : No Error Message Available
  timed_out                       : F
  time_out_length                 : 60
  app_server_host_name            :
  app_server_port                 : 0
  app_server_uri                  :
  error_message                   :

SYSTEM ATTRIBUTES


APPLICATION ATTRIBUTES


INTERNAL ATTRIBUTES

2 thoughts on “Content Server debug options (draft)

  1. Pingback: RPC Commands (draft) | Documentum in a (nuts)HELL
  2. Pingback: Why do EMC coders like static variables? | Documentum in a (nuts)HELL

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s