iSystemAdministrator

Provision

Preview Slayer 0x2

Preview Slayer 0x1

Preview

Table of Contents

• 1 Introduction
  • 1.1 What is iSA?
  • 1.2 Why use iSA?
  • 1.3 How iSA better?
• 2 Installation
  • 2.1 System Requirements
  • 2.2 Optional Dependencies
  • 2.3 Auto Install
  • 2.4 Manual Install
• 3 Getting Started
  • 3.1 Features
    • 3.1.1 Environment Command
    • 3.1.2 Environment Command Configure Location
  • 3.2 Run Mode
    • 3.2.1 Run as selection menu
    • 3.2.2 Run as selection menu with graphic
    • 3.2.3 Run as direct-execute command
• 4 FAQs
  • 4.1 How to add self-defined shell script?
  • 4.2 How to change submenu name?
  • 4.3 How to create level 2 submenu
• 5 References
  • 5.1 Author
  • 5.2 License
  • 5.3 Web-based implementation

1 Introduction

What is iSA?            <iSA>! a MVC pattern selection-^MENU

1.1 What is iSA?

iSystemAdministrastor (iSA) made command-based system operation to be simple, quick and good organize.

1.2 Why use iSA?

What to do if you keep too many shell scripts and hard to find it out to execute or always forgot a complex command?

1.3 How iSA better?

iSA selection-menu available to organize/collect/execute in MVC pattern.
It stored your self-defined command or job and can be call it by selecting a numeric menu.
Then you will never need any command-based system knowledge to run any complex command.

2 Installation

Get latest source code and suggested install directory "~/bus.d"

2.1 System Requirements

Any Bash available system and version 4.0 or greater

2.2 Optional Dependencies

• awk
  
• dialog
  
• grep
  
• head
  
• sed
  
• sort
  
• sleep
  
• tail
  
• xargs
  

2.3 Auto Install

curl -s https://raw.githubusercontent.com/loweboard/iSystemAdministrator/master/app.iSA/com.loweboard.Configure.About.view.install.sh | bash

; then restart terminal

2.4 Manual Install

git clone https://github.com/loweboard/iSystemAdministrator.git ~/bus.d
echo "source ~/bus.d/app.iSA/com.loweboard.agw.sh" >> ~/.bash_profile
source ~/.bash_profile

3 Getting Started

3.1 Features
3.2 Run Mode

3.1 Features

• Organized by MVC pattern
  
• Text ui and Graphic ui menu
  
• Infinite level submenu
  
• Any shell script port to iSA without coding needed (require change filename to iSA format only)
  
• Any shell like Zsh, BASH, Python, PHP...etc
  
• Each submenu has own model for self-definded variable to inherited by sub-level of menu
  

3.1.1 Environment Command

Name	Type	Description
isa-set--debug-on	boolean	turn on debug mode.
isa-set--debug-off	boolean	turn off debug mode.
isa-set--verbose-on	boolean	show more information of command execution.
isa-set--verbose-off	boolean	show less information of command execution.

3.1.2 Environment Command Configure Location

Name	Description
com.loweboard.agw.sh	system-wide settings saved by iSA.
com.loweboard.Configure.About.view.bashrc.sh	per-user settings saved by the administrator.
*.Configure.About.view.bashrc.sh	per-user settings saved by the user.
** Interactive Shell Terminal **	per-session settings effective once .

3.2 Run Mode

3.2.1 Run as selection menu
3.2.2 Run as selection menu with graphic
3.2.3 Run as direct-execute command

3.2.1 Run as Selection Menu

$ isa

3.2.2 Run as Selection Menu with Graphic

$ isa.set-x-on
$ isa

3.2.3 Run as Direct-Execute Command

$ isa com.loweboard.AI.view.patrol

**parameter must be a view

4 FAQs

4.1 How to add self-defined shell script?
4.2 How to change submenu name?
4.3 How to create level 2 submenu?

4.1 How to add self-defined shell script?

question:
What to do if i got a new standalone script named "chatbot.sh" and i would like to organized by iSA
Would like to put in "AI submenu"
answer:
We look in "AI submenu" at ~/bus.d/app.iSA folder as below

com.loweboard.AI.controller.sh
com.loweboard.AI.model.sh
com.loweboard.AI.view.patrol.sh

It very simple just as below

• rename "chatbot.sh"
  

$ mv chatbot.sh com.loweboard.AI.view.chatbot.sh

• Result
  

com.loweboard.AI.controller.sh
com.loweboard.AI.model.sh
com.loweboard.AI.view.chatbot.sh
com.loweboard.AI.view.patrol.sh

Then will show in iSA menu and effective immediately
**also you can rename your script to under any level of submenu without any coding.

4.2 How to change submenu name?

question:
What to do if i want to change "AI submenu" name to "BI"?
anwser:
We look in "AI submenu" at ~/bus.d/app.iSA folder as below

com.loweboard.AI.controller.sh
com.loweboard.AI.model.sh
com.loweboard.AI.view.patrol.sh

It very simple just as below

• Rename domain "com.loweboard.AI"
  

$ mv com.loweboard.AI.controller.sh com.loweboard.BI.controller.sh
$ mv com.loweboard.AI.model.sh com.loweboard.BI.model.sh
$ mv com.loweboard.AI.view.patrol.sh com.loweboard.BI.view.patrol.sh

• Result
  

com.loweboard.BI.controller.sh
com.loweboard.BI.model.sh
com.loweboard.BI.view.patrol.sh

Then will show in iSA menu and effective immediately

4.3 How to create level 2 submenu?

question:
What to do if i want to add "chatbot.sh" to "Bot submenu" under "AI submenu"?
anwser:
We look in "AI submenu" at ~/bus.d/app.iSA folder as below

com.loweboard.AI.controller.sh
com.loweboard.AI.model.sh
com.loweboard.AI.view.patrol.sh

It very simple just as below

• Copy a set of controller and model from "AI submenu"
  

$ cp com.loweboard.AI.controller.sh com.loweboard.AI.Bot.controller.sh
$ cp com.loweboard.AI.model.sh com.loweboard.AI.Bot.model.sh

• Rename "chatbot.sh"
  

$ mv chatbot.sh com.loweboard.AI.Bot.view.chatbot.sh

• Result
  

com.loweboard.AI.controller.sh
com.loweboard.AI.model.sh
com.loweboard.AI.Bot.controller.sh
com.loweboard.AI.Bot.model.sh
com.loweboard.AI.Bot.view.chatbot.sh
com.loweboard.AI.view.patrol.sh

Then will show in iSA menu and effective immediately
**also same to level 3,4,5 etc.., it support infinite level submenu

5 References

5.1 Author
5.2 License
5.3 Web-based implementation

5.1 Author

LOWE/SAAU-LOON MR --theBoard{}+

• Twitter: @loweboard
• Github: @loweboard

5.2 License

Copyright © 2012-2015, 2024 loweboard.
This project is GNU General Public License v3.0 licensed.

5.3 Web-based Implementation

Visit Web-based implementation which embedded in iSA.