Home New York Now Platform Capabilities Service Mapping commands requiring a privileged user

Service Mapping commands requiring a privileged user

Service Mapping uses commands requiring elevated rights to discover and map Unix-based hosts in your organization. In addition to configuring necessary credentials, configure servers in your organization to allow Service Mapping to run these commands with elevated rights.

You do not run these commands directly. Service Mapping uses commands requiring elevated rights as part of the following processes:

host detection
process identification on port
discovering CIs using patterns

Some commands are mandatory. The discovery process fails if Service Mapping cannot run these commands with elevated rights.

Warning: If you do not configure credentials for a mandatory command, a process or a pattern using it fails leading to discovery failure or error.

Some of these commands do not require elevated rights, unless directories that Service Mapping must access are protected.

Operating system commands requiring elevated rights

Table 1. AIX commands requiring elevated rights
Command	Parameter	Mandatory/Optional	Description
cat	file-name	Mandatory	Shows the file content.
ls	-F-1 -1HF -w 1 -1	Mandatory	Lists the directory content.
procwdx	Process_id	Mandatory	Gets working directory of a process.
rmsock	Socketname tcpcp	It is mandatory to use either rmsock or lsof.	Finds process listening on a specific port.
lsof	-Pnl +M -i	It is mandatory to use either rmsock or lsof.	Shows files or connections associated with the process.
lstat	Various options	Optional	Fetches information about a link.
ps	eww	Mandatory	Fetches environment variables for the process on AIX.

Table 2. HP-UX commands requiring elevated rights
Command	Parameter	Mandatory/Optional	Description
cat	file-name	Mandatory	Shows the file content.
ls	-F-1 -1HF -w 1 -1	Mandatory	Lists the directory content.
pfiles	Process_id	It is mandatory to use either pfiles or lsof.	Shows files or connections associated with the process.
lsof	-Pnl +M -i	It is mandatory to use either pfiles or lsof.	Shows files or connections associated with the process.

Table 3. Solaris commands requiring elevated rights
Command	Parameter	Mandatory/optional	Description
cat	File_name	Mandatory	Shows the file content.
ls	ls -F-1 ls -1HF ls -w 1 ls -1	Mandatory	Lists the directory content.
ls	e-l	Optional	Fetches file attributes used for file caching decision.
dtrace	-C -s script_name	For Solaris 11.1 and earlier, it is mandatory to use either the dtrace or lsof command.	Shows process listening on the given port. Required for Solaris 11.1 or earlier.
lsof	-Pnl +M -i	For Solaris 11.1 and earlier, it is mandatory to use either the dtrace or lsof command. For Solaris 11.2 and later, it is mandatory to use either the lsof or netstat command.	Shows files and connections associated with the process.
netstat	-anu	For Solaris 11.2 and later, it is mandatory to use either the lsof or netstat command.	Lists the open ports. Required for Solaris version 11.2 or later.
Ifconfig	Ifconfig -a	Mandatory	Shows interface information (need sudo to get the MAC addresses).
pwdx	Process_id	Mandatory	Gets the process information.
pargs	-e process_id	Mandatory	Gets the process information.
ps	-eo user, pid, ppid, comm, args	Mandatory	Gets the process list.
inetadm	-l or without params	Optional	Handles the case of application using the inet daemon.

Table 4. Linux commands requiring elevated rights
Commands	Parameter	Mandatory/Optional	Description
cat	File_name	Mandatory	Shows the file content.
ls	ls -F-1 ls -1HF ls -w 1 ls -1	Mandatory	Lists directory content.
netstat	-ltnup -ltnp -ntup -an	Mandatory	Shows the open network connections.
stat	--format="%Y" -L file_name	Optional	Shows the modification time of the file.

Application commands requiring elevated rights

Service Mapping uses some of these commands in patterns.

Table 5. Apache Web Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory only for the OC4J Connectivity - netstat - linux connection section of the pattern. If elevated rights are not configured for this command, Service Mapping does not discover Apache Web Server connections to Oracle Application Server Containers for J2EE.	Lists open ports.
ls	Various options	Mandatory only for the Create Weblogic Connections connection section of the pattern. If elevated rights are not configured for this command, Service Mapping does not discover Apache Web Server connections to Oracle WebLogic Module.	Lists files and folders in the specified folder.

Table 6. Apache Tomcat (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists the open ports.
find	-name	Optional	This command is used only for creating the web services connections. Finds specific strings in files and folders.

Table 7. Apache Tomcat WAR (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
version.sh/version.bat	-	Optional	Gets the Tomcat version.
netstat	Various options	Mandatory	Lists the open ports.
find	-name	Optional	This command is used in connection sections of the pattern for discovering Apache Tomcat WAR connections. Finds specific strings in files and folders.

Table 8. App TNS Service (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
netstat	Various options	Mandatory	Lists open ports.
grep	Various options	Mandatory	Extracts strings from the output.

Table 9. BIG-IP Global Traffic Manager (GTM) F5 (on F5 BIG-IP)
Command	Parameter	Mandatory/Optional	Description
ping	-a -c 1 [url[1].host]	Mandatory	Gets the host IP.

Table 10. BMC CTRL-M Enterprise Manager (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 11. BMC CTRL-M Gateway (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
find	Various options	Optional	This command is used only to create connections to Control M Server. Finds file and folder paths.

Table 12. Citrix Netscaler (on Citrix Netscaler)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
show	Various options	Mandatory	Retrieves Netscaler IP address.

Table 13. EMC Documentum Broker (on Unix)
Command	Parameter	Mandatory/Optional	Description
find	Various options	Optional	Finds connections to Docbase.

Table 14. FormEngine (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(On Unix only) Extracts strings from the output.
ls	Various options	Mandatory	(On Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(On Unix only) Shows the file content.

Table 15. IBM Customer Information Control System (CICS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
grep	Various options	Mandatory	Extracts strings from the output.

Table 16. IBM CTRL-M Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(For Unix only) Extracts strings from the output.
find	Various options	Mandatory	(For Unix only) Finds file and folder paths.

Table 17. IBM CICS Transaction Gateway CTG (on Unix or Windows)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Optional	(For Unix only) This command is used only to create CICS connections. Extracts strings from the output.
cat	-	Optional	(For Unix only) This command is used only to create CICS connections. Displays the file content in the output.
find	Various options	Optional	(For Unix only) This command is used only to create CICS connections. Finds specific strings in files and folders.

Table 18. IBM DB2 (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Displays the file content in the output.

Table 19. IBM J2EE EAR (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
find	-name	Mandatory	Finds files and folders in the specified folder.

Table 20. IBM Websphere Application Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
find	-name -type	Optional	This command is used only for creating the Web Services connections. Finds files and folders for the specific name.

Table 21. IBM Websphere Portal (on Linux)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists the open ports.

Table 22. IBM WebSphere Message Broker Flow (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists the open ports.

Table 23. IBM WebSphere Message Broker (on Unix)
Command	Parameter	Mandatory/Optional	Description
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists the open ports.
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 24. IBM WebSphere MQ (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.

Table 25. IBM WebSphere MQ Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.

Table 26. Jboss Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 27. Jboss (on Unix and Windows)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	(On Unix only) Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
dir	Various options	Mandatory	(On Windows only) Lists files and folders in the specified folder.
find	Various options	Mandatory	(For Windows only) Finds specific strings in files and folders.
netstat	Various options	Mandatory	Lists open ports.

Table 28. JRun (on Unix)
Command	Parameter	Mandatory/Optional	Description
dir	Various options	Mandatory	Lists files and folders in the specified folder.

Table 29. JRun WAR Inc (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 30. Microsoft Exchange Client Access Server (CAS), Microsoft Exchange Hub Transport Server, Microsoft Exchange Mailbox (on Windows)
Command	Parameter	Mandatory/Optional	Description
Get-ExchangeServer	-status -Identity "+$hostname+"\| export-clixml $env:TEMP\exchange_pwrshell_output.xml	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange hosts and role
Get-ExchangeServer	format-table -autosize -HideTableHeaders Name,Fqdn,IsMailboxServer	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange hosts and role in table format
Get-MailboxServer	format-list	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange Mailbox servers.
Get-ClusteredMailBoxServerStatus	format-table -Property OperationalMachines	Mandatory for using PowerShell commands.	Extracts information about Microsoft Exchange Mailbox clusters.
Get-ExchangeServer	format-table -autosize -HideTableHeaders Name,Fqdn,IsHubTransportServer	Mandatory for using PowerShell commands.	Extracts information on Microsoft Exchange Hub Transport servers
Get-StorageGroup	-server "+$hname+" \| select SystemFolderPath \| Export-Csv out.csv -notype;cat out.csv	Mandatory for discovering storage.	Extracts information about storage and exports it into a file.
Get-MailboxDatabase	\| select LogFolderPath \| format-table -autosize -hideTableHeaders; Get-MailboxDatabase \| select EdbFilePath\| format-table -autosize -hideTableHeaders;Get-MailboxDatabase \| select TemporaryDataFolderPath\| format-table -autosize -hideTableHeaders	Mandatory for using PowerShell commands.	Extracts information about the Microsoft Exchange Mailbox database.

Table 31. MySQL Server (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(On Unix only) Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	Gets the userid parameter value.

Table 32. MySQL Cluster MGM Node (on Linux)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	(On Unix only) Gets the userid parameter value.

Table 33. Nginx (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	Gets the userid parameter value.
ls	[IncludeTabletmp[].files]	Optional	This command is used if necessary to create HTTP connections. Lists files and folders in the specified folder.
cat	[IncludeTabletmp[].files]	Optional	This command is used if necessary to create HTTP connections. Shows the file content.

Table 34. Oracle E-Business Suite (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
export	-	Mandatory	Sets variables.
echo	Various options	Mandatory	Prints strings in the output.
sqlplus	Various options	Mandatory	Creates the connection to the Oracle instance.
awk	Various options	Mandatory	Manipulates the output.
netstat	Various options	Mandatory	Gets open ports.

Table 35. Oracle Advanced Queue Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.

Table 36. Oracle Concurrent Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(For Unix only) Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
awk	Various options	Mandatory	(For Unix only) Manipulates the output.
ls	Various options	Mandatory	(For Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(For Unix only) Displays the file content in the output.
find	Various options	Mandatory	Finds specific strings in files and folders.

Table 37. Oracle Discoverer Engine (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.

Table 38. Oracle Discoverer UI (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.

Table 39. Oracle Form UI (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 40. Oracle Fulfillment Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 41. Oracle HTTP Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 42. Oracle Metric Client (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 43. Oracle OACORE Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 44. Oracle OAFM Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 45. Oracle Database (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists open ports.

Table 46. Oracle iAS Web Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	(For Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(For Unix only) Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 47. Oracle Process Manager (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 48. Oracle Report Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 49. Oracle Tnslsnr Engine (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 50. Oracle WebLogic Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
find	-name -type	Optional	This command is used only for creating the Web Services connections. Finds files and folders for the specific name.

Table 51. Oracle WebLogic Server (version 10.3) (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 52. Oracle WebLogic On-demand Router Load Balancer (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 53. Oracle Tuxedo (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various	Mandatory	Extracts strings from the output
ls	Various	Mandatory	Lists files and folders on the given folder.
cat	-	Mandatory	Displays the file content in the output.
find	-name	Optional	This command is used only to create web service connections. Finds files and folders for specific name.
netstat	Various	Mandatory	Gets open ports.
ps	-ef		(For Unix only) Gets process attributes.

Table 54. Oracle Tuxedo Portal (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various	Mandatory	Extracts strings from the output
ls	Various	Mandatory	Lists files and folders on the given folder.
cat	-	Mandatory	Displays the file content in the output.

Table 55. PostgreSQL Database (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	[IncludeTabletmp[].files]	Optional	This command is used only to create the HTTP connections. Lists files and folders in the specified folder.

Table 56. Rabbit MQ (on Unix)
Command	Parameter	Mandatory/Optional	Description
ps - ef	ps -ef \| grep "+$process.parentProcessId+" \|egrep -v -e grep -e beam	Mandatory	Gets the parent process.

Table 57. Red Hat Cluster Suite (on Linux)
Command	Parameter	Mandatory/Optional	Description
clustat	-x	Mandatory	Displays the cluster configuration and the status in XML format.

Table 58. SAP components including ABAP SAP Central Services (ASCS), SAP Control Instance, SAP Netweaver Dialog Instance, SAP Evaluated Receipt Settlement (ERS), SAP Java Cluster (SJC), SAP Central Services (SCS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
ping	-c 1	Mandatory	Verifies that the host is answering.
netstat	Various options	Mandatory	Lists open ports.
CVERS	-	Optional	Retrieves the version of installed SAP modules.
DBCONS	-	Optional	Retrieves the connection strings to SAP DB.
RFCDES	-	Optional	Retrieves the connection string to systems integrated with SAP.

Table 59. Sun Directory (on Solaris)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists the open ports.

Table 60. Sun iPlanet Web Server (on Solaris)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
netstat	Various options	Mandatory	Lists the open ports.

Table 61. Sun JES (on Solaris)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.

Table 62. Sybase (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

Table 63. TIBCO ActiveMatrix Adapter (on Unix)
Command	Parameter	Mandatory/Optional	Description
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 64. TIBCO ActiveMatrix BusinessWorks (on Unix)
Command	Parameter	Mandatory/Optional	Description
hostname	-	Mandatory	Gets the hostname.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 65. TIBCO ActiveMatrix BusinessWorks Process (on Unix)
Command	Parameter	Mandatory/Optional	Description
hostname	-	Mandatory	Gets the hostname.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.
findstr	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
cut	Various options	Mandatory	Splits the output line.

Table 66. TIBCO EMS Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

Table 67. Tibco Enterprise Message Service (EMS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

Previous topic

Next topic

Release version

Service Mapping commands requiring a privileged user

You do not run these commands directly. Service Mapping uses commands requiring elevated rights as part of the following processes:

host detection
process identification on port
discovering CIs using patterns

Some commands are mandatory. The discovery process fails if Service Mapping cannot run these commands with elevated rights.

Warning: If you do not configure credentials for a mandatory command, a process or a pattern using it fails leading to discovery failure or error.

Some of these commands do not require elevated rights, unless directories that Service Mapping must access are protected.

Operating system commands requiring elevated rights

Table 1. AIX commands requiring elevated rights
Command	Parameter	Mandatory/Optional	Description
cat	file-name	Mandatory	Shows the file content.
ls	-F-1 -1HF -w 1 -1	Mandatory	Lists the directory content.
procwdx	Process_id	Mandatory	Gets working directory of a process.
rmsock	Socketname tcpcp	It is mandatory to use either rmsock or lsof.	Finds process listening on a specific port.
lsof	-Pnl +M -i	It is mandatory to use either rmsock or lsof.	Shows files or connections associated with the process.
lstat	Various options	Optional	Fetches information about a link.
ps	eww	Mandatory	Fetches environment variables for the process on AIX.

Table 2. HP-UX commands requiring elevated rights
Command	Parameter	Mandatory/Optional	Description
cat	file-name	Mandatory	Shows the file content.
ls	-F-1 -1HF -w 1 -1	Mandatory	Lists the directory content.
pfiles	Process_id	It is mandatory to use either pfiles or lsof.	Shows files or connections associated with the process.
lsof	-Pnl +M -i	It is mandatory to use either pfiles or lsof.	Shows files or connections associated with the process.

Table 3. Solaris commands requiring elevated rights
Command	Parameter	Mandatory/optional	Description
cat	File_name	Mandatory	Shows the file content.
ls	ls -F-1 ls -1HF ls -w 1 ls -1	Mandatory	Lists the directory content.
ls	e-l	Optional	Fetches file attributes used for file caching decision.
dtrace	-C -s script_name	For Solaris 11.1 and earlier, it is mandatory to use either the dtrace or lsof command.	Shows process listening on the given port. Required for Solaris 11.1 or earlier.
lsof	-Pnl +M -i	For Solaris 11.1 and earlier, it is mandatory to use either the dtrace or lsof command. For Solaris 11.2 and later, it is mandatory to use either the lsof or netstat command.	Shows files and connections associated with the process.
netstat	-anu	For Solaris 11.2 and later, it is mandatory to use either the lsof or netstat command.	Lists the open ports. Required for Solaris version 11.2 or later.
Ifconfig	Ifconfig -a	Mandatory	Shows interface information (need sudo to get the MAC addresses).
pwdx	Process_id	Mandatory	Gets the process information.
pargs	-e process_id	Mandatory	Gets the process information.
ps	-eo user, pid, ppid, comm, args	Mandatory	Gets the process list.
inetadm	-l or without params	Optional	Handles the case of application using the inet daemon.

Table 4. Linux commands requiring elevated rights
Commands	Parameter	Mandatory/Optional	Description
cat	File_name	Mandatory	Shows the file content.
ls	ls -F-1 ls -1HF ls -w 1 ls -1	Mandatory	Lists directory content.
netstat	-ltnup -ltnp -ntup -an	Mandatory	Shows the open network connections.
stat	--format="%Y" -L file_name	Optional	Shows the modification time of the file.

Application commands requiring elevated rights

Service Mapping uses some of these commands in patterns.

Table 5. Apache Web Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory only for the OC4J Connectivity - netstat - linux connection section of the pattern. If elevated rights are not configured for this command, Service Mapping does not discover Apache Web Server connections to Oracle Application Server Containers for J2EE.	Lists open ports.
ls	Various options	Mandatory only for the Create Weblogic Connections connection section of the pattern. If elevated rights are not configured for this command, Service Mapping does not discover Apache Web Server connections to Oracle WebLogic Module.	Lists files and folders in the specified folder.

Table 6. Apache Tomcat (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists the open ports.
find	-name	Optional	This command is used only for creating the web services connections. Finds specific strings in files and folders.

Table 7. Apache Tomcat WAR (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
version.sh/version.bat	-	Optional	Gets the Tomcat version.
netstat	Various options	Mandatory	Lists the open ports.
find	-name	Optional	This command is used in connection sections of the pattern for discovering Apache Tomcat WAR connections. Finds specific strings in files and folders.

Table 8. App TNS Service (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
netstat	Various options	Mandatory	Lists open ports.
grep	Various options	Mandatory	Extracts strings from the output.

Table 9. BIG-IP Global Traffic Manager (GTM) F5 (on F5 BIG-IP)
Command	Parameter	Mandatory/Optional	Description
ping	-a -c 1 [url[1].host]	Mandatory	Gets the host IP.

Table 10. BMC CTRL-M Enterprise Manager (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 11. BMC CTRL-M Gateway (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
find	Various options	Optional	This command is used only to create connections to Control M Server. Finds file and folder paths.

Table 12. Citrix Netscaler (on Citrix Netscaler)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
show	Various options	Mandatory	Retrieves Netscaler IP address.

Table 13. EMC Documentum Broker (on Unix)
Command	Parameter	Mandatory/Optional	Description
find	Various options	Optional	Finds connections to Docbase.

Table 14. FormEngine (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(On Unix only) Extracts strings from the output.
ls	Various options	Mandatory	(On Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(On Unix only) Shows the file content.

Table 15. IBM Customer Information Control System (CICS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
grep	Various options	Mandatory	Extracts strings from the output.

Table 16. IBM CTRL-M Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(For Unix only) Extracts strings from the output.
find	Various options	Mandatory	(For Unix only) Finds file and folder paths.

Table 17. IBM CICS Transaction Gateway CTG (on Unix or Windows)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Optional	(For Unix only) This command is used only to create CICS connections. Extracts strings from the output.
cat	-	Optional	(For Unix only) This command is used only to create CICS connections. Displays the file content in the output.
find	Various options	Optional	(For Unix only) This command is used only to create CICS connections. Finds specific strings in files and folders.

Table 18. IBM DB2 (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Displays the file content in the output.

Table 19. IBM J2EE EAR (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
find	-name	Mandatory	Finds files and folders in the specified folder.

Table 20. IBM Websphere Application Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
find	-name -type	Optional	This command is used only for creating the Web Services connections. Finds files and folders for the specific name.

Table 21. IBM Websphere Portal (on Linux)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists the open ports.

Table 22. IBM WebSphere Message Broker Flow (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists the open ports.

Table 23. IBM WebSphere Message Broker (on Unix)
Command	Parameter	Mandatory/Optional	Description
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists the open ports.
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 24. IBM WebSphere MQ (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.

Table 25. IBM WebSphere MQ Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.

Table 26. Jboss Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 27. Jboss (on Unix and Windows)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	(On Unix only) Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
dir	Various options	Mandatory	(On Windows only) Lists files and folders in the specified folder.
find	Various options	Mandatory	(For Windows only) Finds specific strings in files and folders.
netstat	Various options	Mandatory	Lists open ports.

Table 28. JRun (on Unix)
Command	Parameter	Mandatory/Optional	Description
dir	Various options	Mandatory	Lists files and folders in the specified folder.

Table 29. JRun WAR Inc (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.

Table 30. Microsoft Exchange Client Access Server (CAS), Microsoft Exchange Hub Transport Server, Microsoft Exchange Mailbox (on Windows)
Command	Parameter	Mandatory/Optional	Description
Get-ExchangeServer	-status -Identity "+$hostname+"\| export-clixml $env:TEMP\exchange_pwrshell_output.xml	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange hosts and role
Get-ExchangeServer	format-table -autosize -HideTableHeaders Name,Fqdn,IsMailboxServer	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange hosts and role in table format
Get-MailboxServer	format-list	Mandatory for using PowerShell commands.	Extracts the list of Microsoft Exchange Mailbox servers.
Get-ClusteredMailBoxServerStatus	format-table -Property OperationalMachines	Mandatory for using PowerShell commands.	Extracts information about Microsoft Exchange Mailbox clusters.
Get-ExchangeServer	format-table -autosize -HideTableHeaders Name,Fqdn,IsHubTransportServer	Mandatory for using PowerShell commands.	Extracts information on Microsoft Exchange Hub Transport servers
Get-StorageGroup	-server "+$hname+" \| select SystemFolderPath \| Export-Csv out.csv -notype;cat out.csv	Mandatory for discovering storage.	Extracts information about storage and exports it into a file.
Get-MailboxDatabase	\| select LogFolderPath \| format-table -autosize -hideTableHeaders; Get-MailboxDatabase \| select EdbFilePath\| format-table -autosize -hideTableHeaders;Get-MailboxDatabase \| select TemporaryDataFolderPath\| format-table -autosize -hideTableHeaders	Mandatory for using PowerShell commands.	Extracts information about the Microsoft Exchange Mailbox database.

Table 31. MySQL Server (on Linux)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(On Unix only) Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	Gets the userid parameter value.

Table 32. MySQL Cluster MGM Node (on Linux)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	(On Unix only) Gets the userid parameter value.

Table 33. Nginx (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.
ps	--pid=[process.pid] --no-headers -o " %U : %p : %a”	Optional	Gets the userid parameter value.
ls	[IncludeTabletmp[].files]	Optional	This command is used if necessary to create HTTP connections. Lists files and folders in the specified folder.
cat	[IncludeTabletmp[].files]	Optional	This command is used if necessary to create HTTP connections. Shows the file content.

Table 34. Oracle E-Business Suite (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
export	-	Mandatory	Sets variables.
echo	Various options	Mandatory	Prints strings in the output.
sqlplus	Various options	Mandatory	Creates the connection to the Oracle instance.
awk	Various options	Mandatory	Manipulates the output.
netstat	Various options	Mandatory	Gets open ports.

Table 35. Oracle Advanced Queue Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists open ports.

Table 36. Oracle Concurrent Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	(For Unix only) Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
awk	Various options	Mandatory	(For Unix only) Manipulates the output.
ls	Various options	Mandatory	(For Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(For Unix only) Displays the file content in the output.
find	Various options	Mandatory	Finds specific strings in files and folders.

Table 37. Oracle Discoverer Engine (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.

Table 38. Oracle Discoverer UI (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.

Table 39. Oracle Form UI (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 40. Oracle Fulfillment Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 41. Oracle HTTP Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 42. Oracle Metric Client (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 43. Oracle OACORE Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 44. Oracle OAFM Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 45. Oracle Database (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
ps	-ef	Mandatory	Gets the process information.
netstat	Various options	Mandatory	Lists open ports.

Table 46. Oracle iAS Web Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	(For Unix only) Lists files and folders in the specified folder.
cat	-	Mandatory	(For Unix only) Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 47. Oracle Process Manager (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 48. Oracle Report Server (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 49. Oracle Tnslsnr Engine (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 50. Oracle WebLogic Module (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.
find	-name -type	Optional	This command is used only for creating the Web Services connections. Finds files and folders for the specific name.

Table 51. Oracle WebLogic Server (version 10.3) (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 52. Oracle WebLogic On-demand Router Load Balancer (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various options	Mandatory	Extracts strings from the output.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
cat	-	Mandatory	Shows the file content.

Table 53. Oracle Tuxedo (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various	Mandatory	Extracts strings from the output
ls	Various	Mandatory	Lists files and folders on the given folder.
cat	-	Mandatory	Displays the file content in the output.
find	-name	Optional	This command is used only to create web service connections. Finds files and folders for specific name.
netstat	Various	Mandatory	Gets open ports.
ps	-ef		(For Unix only) Gets process attributes.

Table 54. Oracle Tuxedo Portal (on Unix)
Command	Parameter	Mandatory/Optional	Description
grep	Various	Mandatory	Extracts strings from the output
ls	Various	Mandatory	Lists files and folders on the given folder.
cat	-	Mandatory	Displays the file content in the output.

Table 55. PostgreSQL Database (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	[IncludeTabletmp[].files]	Optional	This command is used only to create the HTTP connections. Lists files and folders in the specified folder.

Table 56. Rabbit MQ (on Unix)
Command	Parameter	Mandatory/Optional	Description
ps - ef	ps -ef \| grep "+$process.parentProcessId+" \|egrep -v -e grep -e beam	Mandatory	Gets the parent process.

Table 57. Red Hat Cluster Suite (on Linux)
Command	Parameter	Mandatory/Optional	Description
clustat	-x	Mandatory	Displays the cluster configuration and the status in XML format.

Table 58. SAP components including ABAP SAP Central Services (ASCS), SAP Control Instance, SAP Netweaver Dialog Instance, SAP Evaluated Receipt Settlement (ERS), SAP Java Cluster (SJC), SAP Central Services (SCS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
ping	-c 1	Mandatory	Verifies that the host is answering.
netstat	Various options	Mandatory	Lists open ports.
CVERS	-	Optional	Retrieves the version of installed SAP modules.
DBCONS	-	Optional	Retrieves the connection strings to SAP DB.
RFCDES	-	Optional	Retrieves the connection string to systems integrated with SAP.

Table 59. Sun Directory (on Solaris)
Command	Parameter	Mandatory/Optional	Description
netstat	Various options	Mandatory	Lists the open ports.

Table 60. Sun iPlanet Web Server (on Solaris)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
netstat	Various options	Mandatory	Lists the open ports.

Table 61. Sun JES (on Solaris)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.

Table 62. Sybase (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

Table 63. TIBCO ActiveMatrix Adapter (on Unix)
Command	Parameter	Mandatory/Optional	Description
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 64. TIBCO ActiveMatrix BusinessWorks (on Unix)
Command	Parameter	Mandatory/Optional	Description
hostname	-	Mandatory	Gets the hostname.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.
netstat	Various options	Mandatory	Lists open ports.

Table 65. TIBCO ActiveMatrix BusinessWorks Process (on Unix)
Command	Parameter	Mandatory/Optional	Description
hostname	-	Mandatory	Gets the hostname.
ls	Various options	Mandatory	Lists files and folders in the specified folder.
grep	Various options	Mandatory	Extracts strings from the output.
cat	-	Mandatory	Shows the file content.
findstr	Various options	Mandatory	Extracts strings from the output.
netstat	Various options	Mandatory	Lists open ports.
cut	Various options	Mandatory	Splits the output line.

Table 66. TIBCO EMS Queue (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

Table 67. Tibco Enterprise Message Service (EMS) (on Unix)
Command	Parameter	Mandatory/Optional	Description
ls	Various options	Mandatory	Lists files and folders in the specified folder.

How search works:

Topics are ranked in search results by how closely they match your search terms

Service Mapping commands requiring a privileged user

Service Mapping commands requiring a privileged user

Operating system commands requiring elevated rights

Application commands requiring elevated rights

On this page

Service Mapping commands requiring a privileged user

Service Mapping commands requiring a privileged user

Operating system commands requiring elevated rights

Application commands requiring elevated rights

Log in to personalize your search results and subscribe to topics