Changes

Jump to navigation Jump to search
2,977 bytes added ,  19:20, 3 August 2014
Created page with "{{Languages}} == Smeserver-shellinabox for SME Server 8 and 9== This contrib is made to help the managing of the command line with a terminal in your web browser. This contri..."
{{Languages}}
== Smeserver-shellinabox for SME Server 8 and 9==

This contrib is made to help the managing of the command line with a terminal in your web browser. This contribs is tested with chrome and IE, it seems that with Firefox you can have issues with certain characters, especially if your keyboard is not in English. This is the official website to report issues on [https://code.google.com/p/shellinabox/ shellinabox]
=== Maintainer ===
[mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />

=== Description ===
The purpose is to have in the server-manager an ajax web based emulator instead to use putty or a terminal. The RPM comes from epel...This contribs is done either for sme8 or sme9

=== Requirements ===
You need to enable the [[stephdl]] and [[epel]] repositories

=== Installation ===

Remember to first configure the required [[stephdl]] and [[epel]] repositories, then issue the following command on the SME Server shell:

yum install smeserver-shellinabox --enablerepo=stephdl,epel

The 'official' way is to perform

signal-event post-upgrade; signal-event reboot

but if you don't want to reboot your server, do

signal-event console-save
or
signal-event shellinaboxd

now you can use the contrib in the server-manager or with the url https://sme-host_or_ip/shell.Go to the panel of shellinabox on Server Manager (ssh via a web browser) and use the credentials of root to login, think to test the right clic, you will find other options.

this is the default DB value

# config show shellinaboxd
shellinaboxd=service
FixedIP= #You can precise which IP can connect (You have to set PublicAccess to IP)
Name=shell #You can change this folder if you want
PublicAccess=local #local=localnetwork,global=internet,IP=one IP allowed,none=no access
ShellUsers= #SME users allowed to use shellinabox, use coma to separate users : user1,user2,user3
TcpPort=1870 #You can change the port if you want
WebAuth=disabled #Force or not the apache authentication : enabled/disabled
status=enabled #enabled or disabled

* Admin or ShellUsers are real users of server-manager with their credentials (used only for the http authentication).
* HTTPS is always forced.
* The Apache authentication is only forced if the PublicAccess is not set to local, you have to authenticate throught apache with admin or using ShellUsers.
* If you want you can force the apache authentication with the DB WebAuth (set it to enabled to enforce).

for example :
config setprop shellinaboxd PublicAccess global
signal-event shellinaboxd

=== Uninstall ===
yum remove smeserver-shellinabox; signal-event console-save

=== Bugs ===
For now there is no entry on bugzilla, please direct your issue to [mailto:stephdl@de-labrusse.fr stephdl] Stéphane de Labrusse AKA [[User:stephdl|Stephdl]]<br />

[[Category: Contrib]]

Navigation menu