Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Load Guacamole Data
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:
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.)
== Create Amahi Web App ==
== Install Dependencies ==
Due to the Fedora 23 ''freerdp'' packages being unstable, we must use the CentOS stable version. (Do not do this if you are installing on Fedora 21 or below) To install, execute the following:
<pre>wget https://www.dropbox.com/s/p2uc1rcpckky75v/libxkbfile-1.0.8-5.el7.x86_64.rpm
wget https://www.dropbox.com/s/0tjm7q93z9pw0hj/freerdp-libs-1.0.2-6.el7_2.1.x86_64.rpm
Now install the Fedora dependencies:
For Fedora 23 or newer (Fedora 21, substitute <code>yum</code> for <code>dnf</code>and add <code>freerdp-devel</code> to the list of dependencies):
dnf install tomcat gcc cairo-devel libjpeg-devel libpng-devel uuid-devel pango-devel \
libssh2-devel libtelnet-devel libvncserver-devel pulseaudio-libs-devel openssl-devel \
cd /var/hda/web-apps/guacamole/sqlauth/guacamole-auth-jdbc-0.9.9/mysql/schema/
and run the following command:
cat ./*.sql | mysql -uroot -phda p guacdb ::'''WARNING:''' Please see [[Database Root Password]] for the appropriate login password.
== Install Guacamole Server ==
The safest and most secure method to access Guacamole is using [https://www.amahi.org/apps/openvpn OpenVPN] and an [[OpenVPN_clients|OpenVPN client]] from a smart phone, tablet, or computer.
= Windows RDP Making Preset Connections in Guacamole =[https://enIn Guacamole, an administrative User can create Connections that will be available to Guacamole users.wikipedia.org/wiki/Remote_Desktop_Protocol == Enabling RDP in Windows Home and Basic Editions =="Remote Desktop Protocol (RDP)] is a proprietary protocol developed by Microsoft, which provides a user with 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. 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. Any problems are to be addressed with RDP Wrapper Library support.) https://github.com/stascorp/rdpwrap/releases 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: Name: whatever you want to call it (One can put "RDP" within the name so as to differentiate between connections types in the list) Location: ROOT Protocol: RDP Maximum number of connections: 2 Maximum number of connections per user:2 Host Name: The 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. Note: Using RDP, only one device at a time can be logged in under a specific user. If you are logging into a Windows computer by the user "Fred" by RDP using Guacamole, any other device signed in as "Fred" will be logged out. The side effect is that, when using RDP, a technician (using Guacamole) and client (on their Window computer) cannot see the same active desktop simultaneously. As a workaround, one can set up a VNC and an RDP connection for each Windows computer. RDP can be quicker and more fluid so use RDP when working alone and VNC when one needs to see what is currently happening on a Users computer under their account. Special Note: Once settings are in place, users can click on their User Name in the upper right corner and choose "Home" from the drop-down menu to return to the home screen and use pre-configured connections. == Guacamole VNC Connections to Computers =="In computing, Virtual Network Computing (VNC) is a graphical desktop sharing system that uses the Remote Frame Buffer protocol (RFB) to remotely control another computer. It transmits the keyboard and mouse events from one computer to another, relaying the graphical screen updates back in the other direction, over a network."''2'' In order to connect through Guacamole to a client device by VNC, one needs to install VNC client software on the device and configure it to the user's desired specifications. In this publication, we will use a Windows based client and UltraVNC software, though this is by no means prescriptive for everyone. ===Guacamole VNC Connections to Windows Computers =======UltraVNC Settings for Windows====Be sure to install UltraVNC to run as a service on the client system. Once UltraVNC is installed on the Windows computer, right-click on the system tray icon and choose "Admin Properties" from the menu that comes up. Set the following values: Display Number or Ports to use: Select Ports and set Main and Http so something specific (e.g. 5904, 5804) Authentication: Set both the VNC Password and the View-Only Password. (Write them down. You will need it later.) Click "OK" and then give permission for the program to make changes to your system. ====Guacamole Settings to Connect to the Windows client====After logging in 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 a VNC connection in Guacamole: Name: whatever you want to call it (One can put "VNC" within the name so as to differentiate between connections types in the list) Location: ROOT Protocol: VNC Maximum number of connections: 2 Maximum number of connections per user:2 Host Name: The fixed IP address of the computer to which you wished to connect. (For example ''192.168.1.10'') Port: The Main port number which was set in the Windows UltraVNC client software (e.g. 5904). Password: The VNC Password set earlier in the Windows UltraVNC client software. All the other settings are left either blank or as they were. Special Note: Once settings are in place, users can click on their User Name in the upper right corner and choose "Home" from the drop-down menu to return to the home screen and use pre-configured connections. == References ==''1'' https://en.wikipedia.org/wiki/Remote_Desktop_Protocol
