# NetopsLinux

**Repository Path**: netconf_cloud/netops-linux

## Basic Information

- **Project Name**: NetopsLinux
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-26
- **Last Updated**: 2025-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Network Device Manager Application - Linux Version
==============================================

Network Device Management System - Linux Nuitka Version

SYSTEM REQUIREMENTS:
- Linux distribution (Ubuntu 18.04+, CentOS 7+, RHEL 7+, or equivalent)
- MySQL 5.7+ or MariaDB 10.3+
- Network connectivity to target devices
- Root or sudo privileges (recommended for network operations)

INSTALLATION INSTRUCTIONS:
1. Ensure MySQL/MariaDB is installed and running
   Ubuntu/Debian: sudo apt install mysql-server
   CentOS/RHEL: sudo yum install mysql-server

2. Create a database named 'netconfig'
   SQL: CREATE DATABASE netconfig CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. Update database credentials in .env file if needed

4. Make sure the executable has proper permissions:
   chmod +x NetOps start.sh

5. Run the startup script:
   ./start.sh

6. Wait for "Application startup complete" message

ACCESS URLS:
- Local access: http://localhost:5888
- LAN access: http://[Your-IP-Address]:5888
- Access from other machines on your network using your server's IP

FEATURES:
- Network device discovery and management
- Multi-vendor support (Cisco, Huawei, H3C, etc.)
- Web-based SSH terminal
- Configuration backup and management
- Network topology visualization
- Automated network inspection and reporting
- IP conflict detection
- Nuitka packaged for optimal performance

TROUBLESHOOTING:
- Check if MySQL/MariaDB service is running:
  sudo systemctl status mysql (or mariadb)

- Start MySQL/MariaDB if not running:
  sudo systemctl start mysql (or mariadb)

- Confirm 'netconfig' database exists:
  mysql -u root -p -e "SHOW DATABASES;"

- Check if port 5888 is available:
  sudo netstat -tlnp | grep 5888

- Verify firewall allows port 5888:
  sudo ufw allow 5888 (Ubuntu)
  sudo firewall-cmd --add-port=5888/tcp --permanent (CentOS/RHEL)

- Check application logs in the same directory

- Ensure executable permissions:
  ls -la NetOps start.sh

NETWORK ACCESS:
The application listens on all network interfaces (0.0.0.0:5888)
Other devices on your LAN can access the system using your server's IP address
Configure your firewall to allow incoming connections on port 5888

SECURITY NOTES:
- Change default database credentials in production
- Use HTTPS in production environments (configure reverse proxy)
- Restrict network access as needed using firewall rules
- Run with appropriate user privileges (avoid running as root in production)

SUPPORT:
For technical support and updates, contact your system administrator

COMMON LINUX DISTRIBUTIONS SETUP:

Ubuntu/Debian:
sudo apt update
sudo apt install mysql-server
sudo mysql_secure_installation
sudo systemctl enable mysql

CentOS/RHEL 8:
sudo dnf install mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld
sudo mysql_secure_installation

CentOS/RHEL 7:
sudo yum install mysql-server
sudo systemctl start mysqld
sudo systemctl enable mysqld
sudo mysql_secure_installation