Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Load Guacamole Data
{{MessageBox|backgroundcolor = #faa|image =Warning.png|heading =WARNING|message =This is recommended only for advanced users, proceed with caution.}}= What is Guacamole? == [https://guacamole.incubator.apache.org/ Guacamole ] is an HTML5 remote desktop gatewaythat can be installed on Amahi 9 (Fedora 23). This guidance may work with other Amahi versions with some modification.
Guacamole provides access to desktop environments using remote desktop protocols like VNC and RDP. A centralized server acts as a tunnel and proxy, allowing access to multiple desktops through a web browser.
No browser plugins are needed, and no client software needs to be installed. The client requires nothing more than a web browser supporting HTML5 and AJAX.
We have created a bash script to make installation simple or you can manually install using the guidance below. You '''MUST''' complete the [[Guacamole#Create Amahi Web App|Create Amahi Web App]] step prior to executing the following: wget <nowiki>https://www.dropbox.com/s/4hadafih8ahuj2n/install-guacamole.sh</nowiki> chmod 755 install-guacamole.sh ./install-guacamole.sh Do NOT use this script on anything less than Amahi 9 / Fedora 23 unless you edit it first to match your systems' requirements. (See [[Guacamole#Install Dependencies|Install Dependencies]] to learn what changes are necessary.) === Preparing Create Amahi =Web App ==Login to your Amahi Dashboard and choose "Set Up" install the Amahi [https://www.amahi.org/apps/web-apps Web Apps] plug-in the upper right.Ensure you '''enable''' [[Advanced Settings]].
Now select the "Apps" tab.
Click on "Webapps" and on the page that comes up choose the "New Web App" button at the bottom.
Fill in the name (guacamole) and leave everything else as it is.
=== Configure Database Settings ===
Create a directory for the configuration file.
mkdir -p /etc/guacamole/
::'''WARNING:''' Please see [[Database Root Password]] for the appropriate login password.
==Install Guacamole Client == Running the SQL scripts ====Create a new directory and move to it. mkdir -p /var/lib/guacamole && cd /var/lib/guacamole/
==Update Amahi Web App Files == Configuring Guacamole to Use MySQL Authentication ====You will need to edit Create Symbolic links between guacamole in Tomcat and Amahi's web app directory ln -s /var/lib/tomcat/etcwebapps/guacamole/* /var/hda/web-apps/guacamole.properties/html
== Start Guacamole Server ==Restart Tomcat. guacd-hostname: localhostsystemctl restart tomcat Start Guacamole Server. /etc/init.d/guacd-port: 4822start Configure Guacamole Server to start at boot. systemctl enable tomcat # Auth provider class chkconfig guacd on = Log In to Guacamole =You can access the web login screen for Guacamole from computers in the network via '''<nowiki>http://****:8080/guacamole</nowiki>''' (authenticates Where the ''****'' is the IP address of your Amahi server). The default username/pass combination, needed if using password is ''guacadmin''/''guacadmin''. You can change your password by editing your own user in the provided login administration screen. = Access Outside the Network =If you want Guacamole's web interface to be accessible outside of your LAN you will have to forward a random, unused port (1111, for example)to port 8080 in your router. auth-providerThen when you access Guacamole from outside your LAN you will need to add ''/guacamole'' to the end of your url. (<nowiki>http: net//servername.sourceforgeyourhda.com:1111/guacamole</nowiki>).net If you do not add ''/guacamole'' to your url, you will see a blank page since you did not specify which application in Tomcat you wanted to access.auth.mysql.MySQLAuthenticationProvider basic-user-mappingThe safest and most secure method to access Guacamole is using [https: /etc/guacamolewww.amahi.org/apps/openvpn OpenVPN] and an [[OpenVPN_clients|OpenVPN client]] from a smart phone, tablet, or computer. = Making Preset Connections in Guacamole = In Guacamole, an administrative User can create Connections that will be available to Guacamole users. == Enabling RDP in Windows Home and Basic Editions =="Remote Desktop Protocol (RDP) is a proprietary protocol developed by Microsoft, which provides a user-mappingwith a graphical interface to connect to another computer over a network connection." ''1'' If you do not have Windows pro or ultimate versions you have to run a patch that activates RDP.xml RDP Wrapper Library is an option for enabling RDP features. (Use this at your own risk. Please read RDP Wrapper Library literature and follow directions to install. # Location Any problems are to read extra be addressed with RDP Wrapper Library support.jar's from) lib-directoryhttps: /var/libgithub.com/stascorp/guacamolerdpwrap/classpathreleases If you have Windows Professional or Ultimate, you will need to "Allow Remote Access to Your Computer." (A simple Internet search of this phrase with your Windows version offers many tutorials on this.) == Guacamole RDP Connections to Windows Computers ==After you have login to Guacamole click on your login name in the upper right . In the drop-down menu choose "Settings." Click on the Connections tab on the settings page. Click the "New Connection" button. Below are some VERY basic settings for an RDP connection in Guacamole: # MySQL propertiesName: whatever you want to call it (One can put "RDP" within the name so as to differentiate between connections types in the list) mysql-hostnameLocation: localhostROOT mysql-portProtocol: 3306RDP mysql-databaseMaximum number of connections: guacamole2 mysql-usernameMaximum number of connections per user: guacamole2 mysql-passwordHost Name: some_passwordThe fixed IP address of the computer to which you wished to connect. (For example ''192.168.1.10'') All the other settings are left either blank or as they were.
