Skip to content
This repository was archived by the owner on Jan 11, 2025. It is now read-only.

Mackgame4/UM-NMS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

48 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌐 UM-NMS (Network Management System)

Welcome to the NMS (Network Management System)! This project provides tools for managing and monitoring networks with multiple configuration options. Below is a complete guide to get started. πŸš€


πŸ“œ Features

  • Cross-Platform: Works on Linux 🐧, macOS 🍎, and Windows πŸ–₯️.
  • Dynamic Configuration: Easily specify custom IPs, ports, and configuration files.
  • Flexible Modes:
    • Server Mode πŸ–§
    • Client Mode πŸ‘¨β€πŸ’»
    • Development & Production environments.
  • Live Documentation:
    • Compile and watch reports in real time πŸ“„.

πŸ› οΈ Requirements

  • Python 3.x 🐍
  • Make Utility πŸ› οΈ
  • Typst (for compiling reports) ✍️

πŸ”§ Setup

Make sure you have Make, Python and Typst installed.

πŸš€ Usage

Run the Server 🌟

Start the server with default settings:

make server

You can customize the server settings by overriding environment variables:

make server IP=127.0.0.1 PORT=9090

Or specify a custom configuration file:

make server CONFIG=data/configure-copy.json

Run the Client 🌐

Run the client with default or custom settings:

make client  
# or:  
make client IP=192.168.1.100 PORT=8888  

Development Mode πŸ› οΈ

For testing and debugging, you can start the server or client in development mode:

make dev-server  
make dev-client  

Compile Reports πŸ“„

Generate documentation or reports using Typst:

make relatorio  

Watch for changes and auto-update the report:

make relatorio_watch  

Clean up generated files:

make relatorio_clean  

πŸ“‚ Project Structure

β”œβ”€β”€ data/                # Configuration and data files
β”œβ”€β”€ relatorio/           # Reports and documentation   
β”œβ”€β”€ main.py              # Entry point of the application
β”œβ”€β”€ Makefile             # Automates build and run tasks 
└── README.md            # Project documentation

πŸ’‘ Tips

  • Customize the IP and PORT variables for different network setups.
  • Use the CONFIG variable to load specific settings for the server.
  • Run make relatorio_watch during editing for real-time updates.

About

πŸ—‚οΈ Course project for UM for CC in 2024/25

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors