Debugging related

Before version 1.0.3, linkis has not yet entered apache incubation. The organization still belongs to webank. The package name of the main class is `org.apache.linkis`. Pay attention to the distinction when debugging.

For the configuration file under incubator-linkis/assembly-combined-package/assembly-combined/conf/, you need to configure the database and hive meta and other necessary startup parameters.

In order to facilitate the printing of logs to the console during debugging, you need to modify the default log4j2.xml file and modify the appender to default to console. You need to remove the append of the default RollingFile and add the appender of the console, as shown below: log4j2.xml path incubator-linkis/assembly-combined-package/assembly-combined/conf/log4j2.xml

  2. <configuration status="error" monitorInterval="30">
  3. <appenders>
  4.     <RollingFile name="RollingFile" append="false" fileName="logs/${sys:serviceName}.log"
  5.                  filePattern="logs/$${date:yyyy-MM}/${sys:serviceName}/linkis-log-%d{yyyy-MM-dd}-%i.log">
  6.         <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%-5level] [%-40t] %c{1.} (%L) [%M]-%msg%xEx %n"/>
  7.         <SizeBasedTriggeringPolicy size="100MB"/>
  8.         <DefaultRolloverStrategy max="10"/>
  9.     </RollingFile>
  11.     <Console name="Console" target="SYSTEM_OUT">
  12.         <ThresholdFilter level="INFO" onMatch="ACCEPT" onMismatch="DENY"/>
  13.         <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level [%t] %logger{36} %L %M-%msg%xEx%n"/>
  14.     </Console>
  15. </appenders>
  16. <loggers>
  17.         <appender-ref ref="RollingFile"/>
  18.         <appender-ref ref="Console"/>
  19.     </root>
  20. </loggers>
  21. </configuration>

Both Linkis and DSS services rely on Eureka, so you need to start the Eureka service first, and the Eureka service can also use the Eureka you have started. After Eureka is started, other services can be started.

Because linkis internally uses the -DserviceName parameter to set the application name and the configuration file used, so -DserviceName is a necessary startup VM parameter

By checking Include dependencies with “Provided” scope, you can introduce provided-level dependency packages during debugging.

Microservice Governance Services component

  1. [main Class]
  2. org.apache.linkis.eureka.SpringCloudEurekaApplication
  5. [VM Opitons]
  6. -DserviceName=linkis-mg-eureka -Xbootclasspath/a:D:\yourDir\incubator-linkis\assembly-combined-package\assembly-combined\conf
  9. [Program arguments]
  10. --spring.profiles.active=eureka --eureka.instance.preferIpAddress=true
  13. [User classpath of module]
  14. linkis-eureka

If you don’t want the default port 20303, you can modify the port configuration:

The specific configuration is as follows Linkis Debug - 图2

Linkis-mg-gateway startup configuration

  1. [main Class]
  2. org.apache.linkis.gateway.springcloud.LinkisGatewayApplication
  5. [VM Opitons]
  6. -DserviceName=linkis-mg-gateway -Xbootclasspath/a:D:\yourDir\incubator-linkis\assembly-combined-package\assembly-combined\conf
  9. [User classpath of module]
  10. linkis-gateway-server-support

Note If there is a problem of’org.apache.logging.log4j.LoggingException: log4j-slf4j-impl cannot be present with log4j-to-slf4j’ Please exclude, the dependency on spring-boot-starter-logging

Public Enhancement Services component

  1. org.apache.linkis.jobhistory.LinkisPublicServiceApp
  5. -DserviceName=linkis-ps-publicservice -Xbootclasspath/a:D:\yourDir\incubator-linkis\assembly-combined-package\assembly-combined\conf
  8. [User classpath of module]
  9. linkis-jobhistory

Linkis-ps-cs startup configuration

Computation Governance Services component

  1. [main Class]
  2. org.apache.linkis.manager.am.LinkisManagerApplication
  5. [VM Opitons]
  6. -DserviceName=linkis-cg-linkismanager -Xbootclasspath/a:D:\yourDir\incubator-linkis\assembly-combined-package\assembly-combined\conf
  9. [User classpath of module]
  10. linkis-application-manager

linkis-cg-entrance start

  1. [main Class]
  2. org.apache.linkis.entrance.LinkisEntranceApplication
  5. [VM Opitons]
  6. -DserviceName=linkis-cg-entrance -Xbootclasspath/a:D:\yourDir\incubator-linkis\assembly-combined-package\assembly-combined\conf
  9. [User classpath of module]

Note: Windows local debugging service is not currently supported

linkis-cg-engineplugin(ecp): Need to read local ecp materials, local debugging needs to prepare the corresponding materials first, it is recommended to debug remotely

todo