4 Star 2 Fork 2

NeatLogic / neatlogic-tagent-client

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.en.md 6.89 KB
一键复制 编辑 原始数据 按行查看 历史
luoy 提交于 2023-06-08 10:29 . change readme

中文 / English


About

Neatlogic-Agent is an optional method for deploying on managed target operating systems, which smoothly replaces host connection protocols. Tagent has the following characteristics:

  1. Developed using Perl language, with extremely low runtime dependency requirements
  2. Support common operating systems such as Windows, Linux, SUSE, Aix, etc
  3. There are very few operating system resources, with a resource range of CPU<=2% and memory<=200MB
  4. The same managed machine supports multi user installation
  5. Establish a heartbeat connection with Neatlogic runner, regularly detect the target environment and service availability
  6. Support registration, management, and automatic matching management of network segments for execution from Neatlogic runner
  7. Support operations such as viewing logs, restarting, modifying configurations, and upgrading on Neatlogic web

Applicable scenarios

There are several common application scenarios for Neatlogic Agent:

  1. Windows class machines
  2. Machine account passwords often change
  3. Multiple accounts on the machine, do not want to maintain different user passwords on the platform
  4. Deep use of automated operation and maintenance, such as resource installation and delivery

How to obtain installation packages

Neatlogic-Tagent There are two ways to obtain installation packages:

Explanation: The Windows installation package contains the Perl runtime dependency environment and 7z tools, as shown in the differences in the installation package below.
#####Installation Package Description############
#Neatlogic runner comes with 3 installation packages
#Unix class: tagent.tar
#Windows 32 Class: agent_ Windows_ X32. zip
#Windows 64 class: agent_ Windows_ X64.zip
##########################

#Eg: Obtain Unix installation package
#Format: http://Neatlogic-runner Machine IP: 8084/autoexecutor/agent/download/agent.tar

#Example
curl tagent.tar http://192.168.0.10:8084/autoexecrunner/tagent/download/tagent.tar

#Eg: Obtain Windows 64 bit installation package
#Example
curl tagent_windows_x64.zip http://192.168.0.10:8084/autoexecrunner/tagent/download/tagent_windows_x64.zip

How to install

  • Unix operating systems are recommended to be installed as root users, and the agent installed by root will register the service.

  • The Windows operating system needs to be installed by opening the cmd window in administrative mode.

Manual install

  • Linux | SUSE | Aix |Unix installation
# Login to the target managed machine and download the installation package. It is recommended to store it in the /opt directory uniformly

cd /opt
curl tagent.tar http://192.168.0.10:8084/autoexecrunner/tagent/download/tagent.tar

# decompression
tar -xvf tagent.tar

# View shell kind
echo $0 #The AIX operating system should be noted that most default is ksh

# Perform installation
# Parameter Description:--serveraddr neatlogic-runner http access address  --tenant tenant name
# shell kind is bash,eg
sh tagent/bin/setup.sh --action install --serveraddr http://192.168.0.10:8084  --tenant demo

# shell kind is ksh,eg
sh tagent/bin/setup.ksh --action install --serveraddr http://192.168.0.10:8084  --tenant demo

# Installation completion check (3 processes)
ps -ef |grep tagent 

# view log
less tagent/run/root/logs/tagent.log 

# view config
less tagent/run/root/conf/tagent.conf

#start / stop command
service tagent start/stop 
  • Windows Installation
  1. Check how many bits of OS the Windows operation is and select the corresponding installation package.
  2. Login to the target managed machine, download the installation package, and copy it to the C drive. It is recommended to store it uniformly in the root directory of the C drive.
  3. Open the cmd window with administrator privileges and switch to the c drive directory.
  4. cd tagent_windows_x64 directory, execute:service-install.bat

Example:

cd c:\tagent_windows_x64
service-install.bat

Automatic installation

  • Linux | SUSE | Aix |Unix installation
# Define neatlogic-runner variable
RUNNER_ADDR=http://192.168.0.10:8084 #Neatlogic runner's IP and port
cd /opt
# Download installation script
curl -o install.sh $RUNNER_ADDR/autoexecrunner/tagent/download/install.sh

# Perform installation
bash install.sh --tenant demo --pkgurl $RUNNER_ADDR/autoexecrunner/tagent/download/tagent.tar --serveraddr $RUNNER_ADDR
  • Windows installation
#Open the browser and enter the neatlogic-runner address to download install.vbs, as shown in: http://192.168.0.10:8080/autoexecrunner/tagent/download/install.vbs

#Open cmd window as administrator

#Switch the directory where install.vbs is located, or copy install.vbs to the '% Temp%' directory

#Perform installation
set RUNNER_ADDR=http://192.168.0.10:8084
cscript install.vbs /tenant:demo /pkgurl:%RUNNER_ADDR%/autoexecrunner/tagent/download/tagent_windows_x64.tar /serveraddr:%RUNNER_ADDR% 

How to uninstall

  • Linux | SUSE | Aix |Unix uninstall
cd /opt 

# View shell kind
echo $0

# Shell kind is bash
sh tagent/bin/setup.sh --action uninstall

# Shell kind is ksh
sh tagent/bin/setup.ksh --action uninstall

# Remove installation directory
rm -rf tagent
  • Windows uninstall

Open the cmd window with administrator privileges and switch to agent_ Windows_ X64 installation directory, execute: service uninstall.bat, and delete the installation directory. Example:

cd c:\tagent_windows_x64
service-uninstall.bat
rd /s /q c:\tagent_windows_x64

Network Policy

Source IP Destination IP Port Protocol Description
neatlogic-tagent-client host neatlogic-runner host 8084/8888 TCP 8084 registration port/ 8888 Heartbeat Port
neatlogic-runner host neatlogic-tagent-client host 3939 TCP Command issue execution port
Perl
1
https://gitee.com/neat-logic/neatlogic-tagent-client.git
git@gitee.com:neat-logic/neatlogic-tagent-client.git
neat-logic
neatlogic-tagent-client
neatlogic-tagent-client
master

搜索帮助

53164aa7 5694891 3bd8fe86 5694891