Changes

From SME Server
Jump to navigationJump to search
1,935 bytes added ,  13:53, 2 July 2016
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
 +
 
 +
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.
   −
=== Download ===
+
=== Usage ===
[http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/ajaxterm smeserver-ajaxterm-1.0.3-0.noarch.rpm]
+
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]]
   −
=== Installation ===
  −
yum localinstall ajaxterm/smeserver-ajaxterm-1.0.3-0.noarch.rpm
  −
This installs and starts the Ajaxterm service. There is no need for the signal-event post-upgrade/reboot
      
=== 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 local login on localhost ====
+
==== Restrict to login on localhost ====
 
  config setprop Ajaxterm allowOnlyLocalhost yes
 
  config setprop Ajaxterm allowOnlyLocalhost yes
 
  service ajaxterm restart
 
  service ajaxterm restart
Line 23: Line 45:  
  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) ====
 +
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 ====
 
==== 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
 +
expand-template /etc/httpd/conf/httpd.conf
 +
service httpd-e-smith restart
 
  service ajaxterm 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
 
  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}}
   −
=== 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 ===
  −
[[Image:Ajaxterm-login.gif]]
         +
{{#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: Contrib]]
[[Category: Administration]]
+
[[Category: Administration:Remote Access]]
 
----
 
----
Super Admin, Wiki & Docs Team, Bureaucrats, Interface administrators, Administrators
3,249

edits

Navigation menu