Generating Practitioner Report


Overview

1. Steps to view report using List View
2. Information in the Practitioners Report
   • Executive Summary and Customer Workshop Notes
   • Host Distribution
   • Complexity Distribution
   • Application Components By Technology Stack
   • Topology
   • Application Information
   • Host Information
3. Once you reviewed/edited your report, you can also download it

Steps to view report

• Open the Project for which the discovery process was completed earlier. There are multiple ways to view the Practitioner Report

• Click on Rationalize. In the Rationalize view, click on the Hosts tab and click on the View Practitioner Report as shown in the image below :
  
  

• Click on Rationalize. In the Rationalize view, if Applications have been defined, you will see the defined applications. You can view the Practitioner Report for the application by clicking on the View Practitioner Report as shown in the image below :
  
  

• In the Project landing page, scroll down to the Applications section. If any applications have been defined, they will be listed there. Click on the View Practitioner Report as shown in the image below :
  
  

• In the Project landing page, scroll down to the Applications section. If any applications have been defined, they will be listed there. Click on the application and in the window that opens up, click on the View Practitioner Report as shown in the image below :
  
  

• In the Project landing page, scroll down to the Components section. In the Host Alias column of the table, the hosts are displayed. To view the Host Practitioner Report, click on the View Practitioner Report as shown in the image below :
  
  

• In the Project landing page, scroll down to the Hosts section. In the Host Alias column of the table, the hosts are displayed. To view the Host Practitioner Report, click on the View Practitioner Report as shown in the image below :
  
  

• In the Project landing page, scroll down to the Hosts section. In the Host Alias column of the table, click on any Host displayed. in the window that opens up, click on the View Practitioner Report as shown in the image below :
  
  

• Clicking on the View Practitioner Report will open the Practitioner Report as shown below:

• Host Practitioner Report
  
  
• Application Practitioner Report
  
  

Edit Executive Summary and Customer Workshop Notes

• You can edit the details of the 'Executive Summary' and 'Customer Workshop Notes' by modifying the existing information and changing the font styles of the text.
• To edit the information click on the edit icon next to each description box. Editor will be open as shown in the image below :
  
  
• Information is saved once you navigate outside the editor.

Host Distribution

• This graph represents Distribution of hosts by OS i.e. total number of Linux, Windows hosts present in the Project.

Complexity Distribution

• Complexity is a metric used to measure the effort required to transform an application.
• Complexity Distribution is an aggregated view of all the applications inside a selected Project with their calculated complexity. This given information can be used to determine how easy or difficult it is to transform certain processes in each application. Such information is crucial in giving estimates.

How Complexity is calculated

• Every process in an application is passed through a set of criteria. Based on analysis of the discovered information in each criteria, modernization effort complexity , Recommendation and Efforts Level is calculated.
• Criteria used in Linux x-ray completed processes complexity calculations:

  Complexity Criteria	Criteria Information
  Is the 32 bit process or library detected?	32 bit process or library has dependencies to run in a 64 bit container.
  Any network dependency hard coded?	If any of external endpoint ( IP address ) the process connects to is not detected in any config file, it is concluded that to be hard-coded in the code. This needs the code change for the container to work. Instead of IP address, if it is FQDN then it can be managed via Kubernetes cluster config.
  Are Additional Packages required?	Most of Kubernetes platform recommend to run the container as non-root user. If the process is started as root, application changes may be required to run it as non-root in a container environment.
  What is the process user?	Most of Kubernetes platform recommend to run the container as non-root user. If the process is started as root, application changes may be required to run it as non-root in a container environment.
  Is any special file permission detected?	Special file permissions like sticky bit needs special handling in a container environment.
  Any special files detected?	Applications like “Jenkins” create a start-up file in user’s home directory which it refers to while every restart. This is not part of application binaries or configs and needs the specific handling.
  Any hard coding is detected in /etc/hosts?	If any IP-FQDN mapping from /etc/hosts is used as an outgoing network connection, it requires to be supplied to container at run time via cluster config.
  Any External DNS servers detected?	If the process queries the DNS server for FQDN resolution, then all the relevant entries it queried are required to be accessible from containers via the cluster config.
  Any external services consumed?	All the external network connections are required to be accessible from containers via the cluster config.
  Any file system writes detected?	If the process writes to a file, in order to make the data persistent the file write should be made persistent volume in the cluster environment.
  Effort Complexity without OmniDeq Transform	The overall containerization effort complexity is calculated as the weighted average of the above 10 criteria plus the base container complexity. The base complexity includes choosing the appropriate base container, adding process files and dependencies, setting env variables, exposing ports, adding user and startup command.

  
  
  
• Criteria used in Windows websites complexity calculations:

  Complexity Criteria	Criteria Information
  Are any windows features needed?	Add .Net Framework and ASP.NET features to the container for ASP.NET application to run.
  Are any modules required?	Any other administration modules required to run and manage the container.
  Is WebAppPool creation required?	ASP.NET application runs inside the WebApp Pool.
  Are any SSL certificates required?	Is the Web application accessible over secure channel ?
  Is gMSAs Required?	Does the ASP.NET application depend on Windows Active Directory authentication ?
  Any file system writes detected?	If the process writes to a file, in order to make the data persistent the file write should be made persistent volume in the cluster environment.
  Any external services consumed?	All the external network connections are required to be accessible from containers via the cluster config.
  Effort Complexity without OmniDeq Transform	The overall containerization effort complexity is calculated as the weighted average of the above 7 criteria .

  
  
  
• Criteria used in Processes ready to Transform without x-ray (Websphere Server) complexity calculations:
  

  Complexity Criteria	Criteria Information
  Integration with external AD	Is the web application getting authenticated against Active Directory ?
  Integration with DB2	Is the web application connecting to IBM DB2 ?
  Integration with Message Queue	Is the web application connecting to any messaging queue (for example IBM Queue, Active MQ ) ?
  Are any SSL Certificates required?	Is the web application secured with SSL Certificate ?
  Effort Complexity without OmniDeq Transform	The overall containerization effort complexity is calculated as the weighted average of the above 4 criteria .

- The overall containerization effort complexity is calculated as the weighted average of the applicable criteria per process and is used to categorize the application complexity into Low, Medium and High.

Score	Complexity
0 - 25	Low
26 - 35	Medium
36 and above	High

Application Components By Technology Stack

• Technology stack is the underlying technology upon which an application is running on. For instance, an application like a website will have HTML,CSS, Javascript, and Nginx as their technology stack.
• This section displays an aggregated count of Application Components, and their technology stack identified by the tool, which are running on the hosts.

Topology

• Topology shows the connections between the nodes and their processes.
• Please click here to know more about Topology.

Application Information

• Please click here to know more about How to create Applications.

Overall Migration Recommendation

• Each application contains set of processes. The scrollable process list is displayed as shown in image below :
  
  

• Every component under the selected application is clickable and individual process information such as attributes for Modernization, Criteria used for Effort Complexity calculation without OmniDeq Transform is available as shown in image below :

• Linux Process : Attributes for Modernization
  
  Recommendation for Modernization Criteria. Each criteria definition is available here How Complexity is calculated
  
  

• Windows websites :
  
  Attributes for Modernization in case of IIS server is as shown in below image
  
  Recommendation for Modernization Criteria in case of IIS server:
  
  

• In case of Linux Websphere Application Server information also available as shown in image below :
  
  Attributes for containerization in case of websphere server is as shown in below image
  
  Recommendation for Containerization Criteria in case of websphere server:
  
  

Host Information

• If you are viewing an application's Practitioner Report, you can toggle to host view as shown in the image below :

• Scroll down to view the Host information, as shown in the image below :
  
  

• Host information contains: Operating System, Discovered On, IP Address, CPU Cores, Memory, CPU Family in Host Information table, DNS Servers, Static Host Entries and Storage Information for all hosts in separate tables.

• You can also view information for a different host by selecting the host from the dropdown as shown in the image below :

Download Report

• After all the edits are done and you have reviewed all the sections in the Practitioner Report, you can click on PDF button as shown in the image below :

• 

• It will open the report in print window as shown in the image below :
  
  

• Click on Save to download the PDF copy of the report.