Line 1: |
Line 1: |
| + | {{Languages|Ajaxterm}} |
| + | {{Warning box|Ajaxterm is no longer maintained since 2010 by its original author. You should consider to avoid this software as it may not be secure! as an example [[Shellinabox]] }} |
| === Maintainer === | | === Maintainer === |
| Michael Weinberger | | Michael Weinberger |
| + | |
| + | === Version === |
| + | |
| + | {{ #smeversion: smeserver-ajaxterm }} |
| + | |
| | | |
| === Introduction === | | === Introduction === |
− | Ajaxterm is a web based terminal. See http://antony.lesuisse.org/qweb/trac/wiki/AjaxTerm | + | Ajaxterm is a web based terminal. See https://github.com/antonylesuisse/qweb and http://antony.lesuisse.org/software/ajaxterm/HEADER.html |
| + | |
| + | === Installation === |
| + | |
| + | /usr/bin/yum install --enablerepo=smecontribs smeserver-ajaxterm |
| | | |
− | === Download ===
| + | expand-template /etc/httpd/conf/httpd.conf |
− | [http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/ajaxterm smeserver-ajaxterm]
| + | service ajaxterm restart |
| + | service httpd-e-smith restart |
| | | |
− | === Installation ===
| + | after every ajaxterm restart you should issue a httpd-e-smith restart otherwise you will obtain a proxy error and httpd will disable the redirector. |
− | yum localinstall smeserver-ajaxterm-*.noarch.rpm
| |
| | | |
| === Usage === | | === Usage === |
− | Point your browser to https://yourdomain.com/ajaxterm/index.html | + | Point your browser to <nowiki>https://yourdomain.com/ajaxterm/index.html</nowiki> |
| + | |
| + | * Login in to browser prompt as admin. |
| + | |
| + | * Login to shell access as any user, NB, you may need to enter the servername at ''Host'' and port and ''SSH Port'' depending on your configuration. |
| + | |
| + | |
| + | === Screenshot === |
| + | [[Image:Ajaxterm-login.gif]] |
| + | |
| + | |
| + | === Configuration === |
| + | The Ajaxterm service is configurable by properties of the ''ajaxterm'' record in the SME server ''configuration'' database. |
| + | ==== Restrict to login on localhost ==== |
| + | config setprop Ajaxterm allowOnlyLocalhost yes |
| + | service ajaxterm restart |
| + | Only a login to local host is possible (default setting). Ajaxterm runs the 'su --login USER' command to login. You are asked for a username and password |
| + | |
| + | ==== Allow ssh login on all hosts ==== |
| + | config setprop Ajaxterm allowOnlyLocalhost no |
| + | service ajaxterm restart |
| + | Ajaxterm runs the 'ssh' command to login to a host. You are asked for hostname or IP, ssh port, username and password. If localhost or 127.0.0.1 is given as the host Ajaxterm falls back to the 'su --login USER' login command. |
| + | |
| + | ==== Browser login (Basic Auth) ==== |
| + | By default login with user ''admin'' is required on browser login. You can change this to any other user or a list of users separated by blanks. |
| + | config setprop Ajaxterm basicAuthUsers "user [user] ..." |
| + | expand-template /etc/httpd/conf/httpd.conf |
| + | service httpd-e-smith restart |
| + | |
| + | ==== Terminal size ==== |
| + | By default the size of the terminal is 80 x 25 characters. Use the following commands to set a new size. |
| + | config setprop Ajaxterm width NEWWIDTH |
| + | config setprop Ajaxterm height NEWHEIGHT |
| + | service ajaxterm restart |
| + | Note: Increasing the size may decrease the speed. |
| + | |
| + | ==== Web alias ==== |
| + | The default web alias is ''ajaxterm''. You can change it to any other name: |
| + | config setprop Ajaxterm webAlias NEWALIAS |
| + | expand-template /etc/httpd/conf/httpd.conf |
| + | service httpd-e-smith restart |
| + | Then point your browser to the new URL: <nowiki>https://yourdomain.com/NEWALIAS/index.html</nowiki> |
| + | |
| + | ==== Ajaxterm service port ==== |
| + | By default Ajaxterm runs as a service (a python script) listening on port 8022. You can change the port using the following commands: |
| + | config setprop Ajaxterm servicePort NEWPORT |
| + | expand-template /etc/httpd/conf/httpd.conf |
| + | service httpd-e-smith restart |
| + | service ajaxterm restart |
| + | |
| + | === Uninstall === |
| + | This removes the installed Ajaxterm package. |
| + | service ajaxterm stop |
| + | /usr/bin/yum erase smeserver-ajaxterm |
| + | expand-template /etc/httpd/conf/httpd.conf |
| + | service httpd-e-smith restart |
| + | |
| + | === Bugs === |
| + | Please raise bugs under the SME-Contribs section in [http://bugs.contribs.org/enter_bug.cgi bugzilla] |
| + | and select the smeserver-ajaxplorer component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-ajaxplorer|title=this link}} |
| | | |
− | Basic login in as admin.
| |
| | | |
− | [[Image:Ajaxterm-screenshot.gif]]
| |
| | | |
− | === Additional information === | + | {{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ajaxterm|noresultsmessage="No open bugs found."}} |
− | Ajaxterm runs as a service listening on port 8022. You can control the service using the service command:<br>
| + | |
− | <code>service ajaxterm {start|stop|restart|status}</code>
| |
| [[Category: Webapps]] | | [[Category: Webapps]] |
| [[Category: Contrib]] | | [[Category: Contrib]] |
− | [[Category: Administration]] | + | [[Category: Administration:Remote Access]] |
| ---- | | ---- |