Start the lightweight configuration center

Before you start

The light-weight configuration center has been updated to the lightweight configuration center. The lightweight configuration center is compatible with the light-weight configuration center and provides additional support for Nacos.

Prerequisites

Step 1: Download the lightweight configuration center package

• Windows:
  1. Download the lightweight configuration center package.
  2. Decompress the package to an on-premises directory.
• UNIX or macOS:
  1. Run the wget http://edas.oss-cn-hangzhou.aliyuncs.com/edas-res/edas-lightweight-server-1.0.0.tar.gz command to download the lightweight configuration center package.
  2. Run the tar -zvxf edas-lightweight-server-1.0.0.tar.gz command to decompress the package.
  Notice The lightweight configuration center can be used only for development and testing in an on-premises environment. Do not use the lightweight configuration center in the production environment. If you expose the lightweight configuration center to the Internet, use an IP address-based access policy for access control.

Step 2: Start the lightweight configuration center

1. Go to the edas-lightweight\bin directory.
2. Start the lightweight configuration center and view the startup result.
   • For a Windows operating system, double-click startup.bat.
   • For a UNIX or macOS operating system, run the sh startup.sh command.

     1. /usr/java/jdk1.8.0/bin/java -server -Xms1g -Xmx1g -Xmn512m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m -XX:-OmitStackTraceInFastThrow -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/root/service/edas-lightweight/logs/java_heapdump.hprof -XX:-UseLargePages -Djava.ext.dirs=/usr/java/jdk1.8.0/jre/lib/ext:/usr/java/jdk1.8.0/lib/ext:/root/service/edas-lightweight/plugins/cmdb:/root/service/edas-lightweight/plugins/mysql -Xloggc:/root/service/edas-lightweight/logs/nacos_gc.log -verbose:gc -XX:+PrintGCDetails -XX:+PrintGCDateStamps -XX:+PrintGCTimeStamps -XX:+UseGCLogFileRotation -XX:NumberOfGCLogFiles=10 -XX:GCLogFileSize=100M -Dnacos.home=/root/service/edas-lightweight -Dnacos.standalone=true -jar /root/service/edas-lightweight/target/edas-lightweight.jar --spring.config.location=classpath:/,classpath :/config/,file:./,file:./config/,file:/root/service/edas-lightweight/conf/ --logging.config=/root/service/edas-lightweight/conf/nacos-logback.xml --server.max-http-header-size=524288
     2. edas lightweight is starting with standalone
     3. edas lightweight is starting, you can check the /root/edas-lightweight/logs/start.out

     Note To adjust the values of Java virtual machine (JVM) startup parameters, specify the appropriate JVM parameters in the startup script based on your on-premises environment.
3. Optional: Check the started listening ports of the lightweight configuration center.

   After startup, the lightweight configuration center listens on the following ports:

   • Port 8848: listens to the configuration management and service registration of Nacos applications.
   • Port 9600: listens to HSF or Apache Dubbo service registration and subscription.
   • Port 8080: listens to service registration by using ANS and configuration management by using ACM.

   For a Linux or macOS operating system, you can run the netstat -an grep -E "808088489600" grep -i listen command to check whether the three ports are in the listening state. For a Linux operating system, you can also run the netstat -nltp grep -E "808088489600" command to check whether the three ports are enabled by the process of the lightweight configuration center.

Step 3: Configure hosts in the on-premises development environment

Configure the hosts of the lightweight configuration center on the machine where you want to develop and test applications by using the lightweight configuration center. To be specific, in the Domain Name System (DNS) or the hosts file, configure the jmenv.tbsite.net domain name to point to the IP address of the machine on which the lightweight configuration center is started.

1. Open the hosts file.
   • Windows operating system: C:\Windows\System32\drivers\etc\hosts
   • UNIX or macOS operating system: /etc/hosts
2. Add the configuration of the lightweight configuration center.
   • If you start the lightweight configuration center on a machine whose IP address is 192.168.1.100, add 192.168.1.100 jmenv.tbsite.net to the hosts file.
   • If you start the lightweight configuration center on an on-premises machine, change the preceding IP address and add 127.0.0.1 jmenv.tbsite.net to the hosts file.

Verify the result

The following figure shows the homepage of the lightweight configuration center.

If the homepage cannot appear, view the boot log logs/start.log in the installation directory to identify the cause of failed startup and fix the bug.

The lightweight configuration center provides features such as service registration, discovery, configuration management, and namespaces. Namespaces are available only if you previously used Nacos.