sipwise
/
ngcp-klish-config
mirror of https://github.com/sipwise/ngcp-klish-config.git
1
0
Fork 0
Code Issues Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
168 Commits
221 Branches
170 Tags
2.1 MiB
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'mr11.1.1'
${ noResults }
Go to file
Sipwise Jenkins Builder 4cda3523d6
Release new version 11.1.1.1+0~mr11.1.1.1 		3 years ago
bin MT#10425 Add ngcp-clish wrapper, pssh dependency and templates 11 years ago
debian Release new version 11.1.1.1+0~mr11.1.1.1 3 years ago
etc TT#71950 Fix typos 6 years ago
ngcp-klish TT#64357 switch to lua5.2 6 years ago
spec TT#64357 switch to lua5.2 6 years ago
t TT#118659 Switch Dockerfile from Debian buster to bullseye 5 years ago
.busted TT#64357 switch to lua5.2 6 years ago
.gitignore TT#64357 switch to lua5.2 6 years ago
.gitreview MT#7505 Add .gitreview file for ngcp-klish-config 11 years ago
README TT#71950 Fix typos 6 years ago

README 

ngcp-klish-config 
=================

Sipwise NGCP/SPCE CLI shell based on klish/clish


                    #######
               #################
             ######         ######
            ####                ####
           ###                    ###
          ##                     EEEEEEEE
          ##                   EEEEE  EEEEE
          ##                  EEE        EEE
          ##                  EE          EED
           ###               EEE           EE
            ###              EEE           EE
             ## ####        ##EE          EEE
             ##################EE        EEE
            #####    #####     EEEEEE  EEEE
            ####                 EEEEEEEE
            ###                    EEEEEE
            ##                        EEE
     ####  ##  #####       E    E   E  EE    EEE   EEEEEE
   ###### ### #######  ##  EE  EE  EEE EEE EEEEEE EEEEEEE
   ######  ## ######## ##  EE  EE  EEE EEE EEEEED EEEEEEE
   ####    ## ###   ## ##  EE  EE  EEE EEE EEE    EEE
   ######  ## ###   ##     EE  EE  EEE EEE EEEEEE EEEEEE
     ####  ## ###   ##     EE  EE  EEE EEE    EEE EEE
    #####  ## ######## ##  EEEEEEEEEEE EEE   EEEE EEEEEEE
   ######  ## #######  ##  EEEEEEEEEEE EEE EEEEEE  EEEEEE
    ###     # ###            EEEEEEEE   E   EEE     DEEEE
              ###



WARNING:
=======

The status is work-in-progress. Do not expect a full blown shell just yet!
This package & its components are meant for a SIP:Provider CE 3.x Server *ONLY*


BASIC HOW-TO:
============

1) Clone & Install the system & software requirements:

    - NGCP-CLISH (https://github.com/sipwise/klish)
    - LUA-URI (https://github.com/sipwise/lua-uri.git)

2) Clone & Deploy NGCP-KLISH-CONFIG to your /etc:

        # git clone https://github.com/sipwise/ngcp-clish-config
        # cd ngcp-clish-config; cp -r etc/* /etc/

3) Add execution permissions to the launcher if needed, ie:

    # chmod +x /etc/cli.sh

4) Create a limited user (ie: cliuser) with default clish shell:

    # useradd -s /etc/cli.sh -r -M cliuser
    # passwd cliuser

5) Modify /etc/sudoers to allow 'cliuser'' to execute enable clish. For example:

    Defaults:cliuser targetpw
    cliuser ALL=(ALL) /usr/bin/clish, /usr/local/bin/clish



BASIC USAGE:
===========

1) SSH to the system as 'cliuser' using the new account or manually launch /etc/cli.sh

2) Use tab/autocompletion and ? to explore the menus, commands and parameters

3) Use 'enable' to enter privileged mode (use the system's root password when asked)


EXAMPLE COMMANDS:
================

- coming soon! -