Difference between revisions of "Ajaxterm"

From SME Server
Jump to navigation Jump to search
m
 
(11 intermediate revisions by 4 users not shown)
Line 1: Line 1:
=== Maintainer ===
+
{{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 of an alternative try [[Shellinabox]] }}
 +
===Maintainer===
 
Michael Weinberger
 
Michael Weinberger
  
=== Introduction ===
+
===Version===
Ajaxterm is a web based terminal. See http://antony.lesuisse.org/qweb/trac/wiki/AjaxTerm
+
 
 +
{{#smeversion: smeserver-ajaxterm }}
 +
 
 +
 
 +
===Introduction===
 +
Ajaxterm is a web based terminal. See https://github.com/antonylesuisse/qweb and http://antony.lesuisse.org/software/ajaxterm/HEADER.html
 +
 
 +
===Installation===
  
=== Download and Installation ===
 
 
  /usr/bin/yum install --enablerepo=smecontribs smeserver-ajaxterm
 
  /usr/bin/yum install --enablerepo=smecontribs smeserver-ajaxterm
  
 
  expand-template /etc/httpd/conf/httpd.conf
 
  expand-template /etc/httpd/conf/httpd.conf
 +
service ajaxterm restart
 
  service httpd-e-smith restart
 
  service httpd-e-smith restart
service ajaxterm restart
 
 
  
 +
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.
  
=== Usage ===
+
===Usage===
 
Point your browser to <nowiki>https://yourdomain.com/ajaxterm/index.html</nowiki>
 
Point your browser to <nowiki>https://yourdomain.com/ajaxterm/index.html</nowiki>
  
* Login in to browser prompt as admin.
+
*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.
+
*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 ===
+
===Screenshot===
 
[[Image:Ajaxterm-login.gif]]
 
[[Image:Ajaxterm-login.gif]]
  
  
=== Configuration ===
+
===Configuration===
 
The Ajaxterm service is configurable by properties of the ''ajaxterm'' record in the SME server ''configuration'' database.
 
The Ajaxterm service is configurable by properties of the ''ajaxterm'' record in the SME server ''configuration'' database.
==== Restrict to login on localhost ====
+
====Restrict to login on localhost====
 
  config setprop Ajaxterm allowOnlyLocalhost yes
 
  config setprop Ajaxterm allowOnlyLocalhost yes
 
  service ajaxterm restart
 
  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
 
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 ====
+
====Allow ssh login on all hosts====
 
  config setprop Ajaxterm allowOnlyLocalhost no
 
  config setprop Ajaxterm allowOnlyLocalhost no
 
  service ajaxterm restart
 
  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.
 
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) ====
+
====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.
 
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] ..."
 
  config setprop Ajaxterm basicAuthUsers "user [user] ..."
Line 44: Line 52:
 
  service httpd-e-smith restart  
 
  service httpd-e-smith restart  
  
==== Terminal size ====
+
====Terminal size====
 
By default the size of the terminal is 80 x 25 characters. Use the following commands to set a new 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 width NEWWIDTH
Line 51: Line 59:
 
Note: Increasing the size may decrease the speed.
 
Note: Increasing the size may decrease the speed.
  
==== Web alias ====
+
====Web alias====
 
The default web alias is ''ajaxterm''. You can change it to any other name:
 
The default web alias is ''ajaxterm''. You can change it to any other name:
 
  config setprop Ajaxterm webAlias NEWALIAS
 
  config setprop Ajaxterm webAlias NEWALIAS
Line 58: Line 66:
 
Then point your browser to the new URL: <nowiki>https://yourdomain.com/NEWALIAS/index.html</nowiki>
 
Then point your browser to the new URL: <nowiki>https://yourdomain.com/NEWALIAS/index.html</nowiki>
  
==== Ajaxterm service port ====
+
====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:
 
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
 
  config setprop Ajaxterm servicePort NEWPORT
Line 65: Line 73:
 
  service ajaxterm restart
 
  service ajaxterm restart
  
=== Uninstall ===
+
===Uninstall===
 
This removes the installed Ajaxterm package.
 
This removes the installed Ajaxterm package.
 
  service ajaxterm stop
 
  service ajaxterm stop
Line 72: Line 80:
 
  service httpd-e-smith restart
 
  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}}
 +
 +
 +
{{#bugzilla:columns=id,product,version,status,summary |sort=id |order=desc |component=smeserver-ajaxterm|noresultsmessage="No open bugs found."}}
 
   
 
   
 
[[Category: Webapps]]
 
[[Category: Webapps]]
[[Category: Contrib]]
+
[[Category: Deprecated Contrib]]
[[Category: Administration]]
+
[[Category: Administration:Remote Access]]
 
----
 
----

Latest revision as of 23:27, 17 April 2021


Warning.png Warning:
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 of an alternative try Shellinabox


Maintainer

Michael Weinberger

Version

Contrib 9:
smeserver-ajaxterm
The latest version of smeserver-ajaxterm is available in the SME repository, click on the version number(s) for more information.



Introduction

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
expand-template /etc/httpd/conf/httpd.conf
service ajaxterm restart
service httpd-e-smith restart

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.

Usage

Point your browser to https://yourdomain.com/ajaxterm/index.html

  • 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

 


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: https://yourdomain.com/NEWALIAS/index.html

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 bugzilla and select the smeserver-ajaxplorer component or use this link


"No open bugs found."