Open-E Knowledgebase

[JDSS] Rootconsole Small Update - installation and first access

Article ID: 3561
Last updated: 18 Dec, 2024

Installation of rootconsole Small Update

The rootconsole Small Update for JovianDSS up31 can be downloaded under the following link:

https://software:UuPpDdAaTtEe@ftp.open-e.com/SMALL_UPDATES/xc-rootconsole-d12/up31/

This Small Update allows the administrator to deploy a container based on Debian 12 to manage and access Open-E JovianDSS using a Web-based console.

Small Update installation is a simple procedure:

  • go to System Settings > Update and click “Upload”
  • choose a required file and click “Install and reboot later”

  • reboot Open-E JovianDSS server

First access

The rootconsole is accessible under the following URL:  https://<joviandss_ip_address>:4200/rootconsole-d12/

It is also possible to access the root console without providing a URL. It is more convenient to use the Launch Pad menu.

Go to the Text User Interface (TUI) and go to Console tools (hotkey: ctrl-alt-T) -> Web services management -> Access settings -> Set launchpad as default GUI page. Make sure the option is marked as active:

Once the launch pad is enabled , got to you Open- E JovianDSS and you should see a launch Pad menu instead of the GUI view:

If the Launch Pad menu has not opened even though the option is active in the TUI, click the "Logout" button in the top-right corner of the Open-E JoivanDSS GUI.

  • Clicking the cogwheel icon will take you to the Open-E JovianDSS GUI.
  • Clicking the LXC icon will allow the administrator to manage your containers -  see system usage, change Memory usage limit and check README files of installed containers, including the rootconsole.  You can also use this menu to stop, restart or restore factory defaults settings of the container.
  • Choosing the console icon will take you to the rootconsole menu.

The rootconsole prompt will ask you to provide the the login and password to the container. By default the credentials are:

login: admin

password: <your_GUI_password>

The password is updated every time the GUI administrator password is changed.

Most commands are available as bash aliases only after logging in as a root user. First run the sudo su command and provide your administrator password:

admin@JovianDSS:/$ sudo su
[sudo] password for admin:                                                                                                                                     

Once logged in as the root user, run the alias command to see available bash aliases:

root@JovianDSS:/# alias                                                                                                                                                                                                                       
alias arc_summary='ssh -t xcadmin@host arc_summary'                                                                                                                                                                                            
alias arcstat='ssh -t xcadmin@host arcstat'                                                                                                                                                                                                    
alias cli='ssh xcadmin@host cli'                                                                                                                                                                                                               
alias gem_utils='ssh xcadmin@host gem_utils'                                                                                                                                                                                                   
alias htop='ssh -t xcadmin@host htop'                                                                                                                                                                                                          
alias inspect='ssh -t xcadmin@host sudo inspect'                                                                                                                                                                                               
alias iostat='ssh xcadmin@host iostat'                                                                                                                                                                                                         
alias ipmitool='ssh -t xcadmin@host sudo ipmitool'                                                                                                                                                                                             
alias lsmod='ssh xcadmin@host lsmod'                                                                                                                                                                                                           
alias lsscsi='ssh xcadmin@host lsscsi'                                                                                                                                                                                                         
alias modprobe='ssh xcadmin@host sudo modprobe'                                                                                                                                                                                                
alias service='ssh xcadmin@host sudo service'                                                                                                                                                                                                  
alias smbcontrol='ssh -t xcadmin@host sudo smbcontrol'                                                                                                                                                                                         
alias smbstatus='ssh xcadmin@host sudo smbstatus'                                                                                                                                                                                              
alias testparm='ssh -t xcadmin@host sudo testparm'                                                                                                                                                                                             
alias top='ssh -t xcadmin@host top'                                                                                                                                                                                                            
alias tracker='ssh -t xcadmin@host sudo tracker-xa'                                                                                                                                                                                            
alias zfs='ssh xcadmin@host sudo zfs'                                                                                                                                                                                                          
alias zpool='ssh xcadmin@host sudo zpool'                                                                                                                                                                                                      

To use on of the aliases or to get more information on it run one of the commands provided in the output.
Example for the cli alias:

root@JovianDSS:/home/admin# cli                                                                                                                                                                                                               
Usage: cli_adapter [options]                                                                                                                                                                                                                   
                                                                                                                                                                                                                                               
Options:                                                                                                                                                                                                                                       
  -h, --help  show this help message and exit                                                                                                                                                                                                  
  -c COMMAND  CLI API Command to execute.                                                                                                                                                                                                      
                                                                                                                                                                                                                                               
Available commands:                                                                                                                                                                                                                            
        attach_volume_to_iscsi_target                                                                                                                                                                                                          
        check_mk_agent                                                                                                                                                                                                                         
        create_clone_for_given_snapshot                                                                                                                                                                                                        
        create_iscsi_target                                                                                                                                                                                                                    
        create_pool                                                                                                                                                                                                                            
        create_snapshot                                                                                                                                                                                                                        
        create_volume                                                                                                                                                                                                                          
        delete_clone                                                                                                                                                                                                                           
        delete_iscsi_target                                                                                                                                                                                                                    
        delete_pool                                                                                                                                                                                                                            
        delete_snapshot                                                                                                                                                                                                                        
        delete_volume                                                                                                                                                                                                                          
        detach_volume_from_iscsi_target                                                                                                                                                                                                        
        get_clones_for_given_snapshot                                                                                                                                                                                                          
        get_iscsi_targets_for_given_pool                                                                                                                                                                                                       
        get_pools                                                                                                                                                                                                                              
        get_raid_info                                                                                                                                                                                                                          
        get_snapshots_for_given_volume                                                                                                                                                                                                         
        get_volumes_assigned_to_iscsi_target                                                                                                                                                                                                   
        get_volumes_for_given_pool                                                                                                                                                                                                             
        help                                                                                                                                                                                                                                   
        hpessad                                                                                                                                                                                                                                
        node_bind                                                                                                                                                                                                                              
        node_unbind                                                                                                                                                                                                                            
        odps                                                                                                                                                                                                                                   
        promote_clone                                                                                                                                                                                                                          
        reboot                                                                                                                                                                                                                                 
        rollback_snapshot                                                                                                                                                                                                                      
        shutdown                                                                                                                                                                                                                               
                                                                                                                                                                                                                                               
Run:                                                                                                                                                                                                                                           
command_name --help                                                                                                                                                                                                                            
to see help for selected command                                                                                                                                                                                                               

This article was:   Helpful | Not helpful Report an issue


Article ID: 3561
Last updated: 18 Dec, 2024
Revision: 8
Views: 0
Posted: 18 Dec, 2024 by Litwinowicz R.
Updated: 18 Dec, 2024 by Litwinowicz R.
print  Print email  Subscribe email  Email to friend share  Share pool  Add to pool
Prev     Next
rootconsole       DSS V7

The Knowledge base is managed by Open-E data storage software company.