Apache Guacamole by Neodoo En » Histórico » Revisión 3
Revisión 2 (Francisco Javier Solans Benedí, 2024-03-13 06:13) → Revisión 3/4 (Francisco Javier Solans Benedí, 2024-04-10 06:43)
{{toc}} # Usage Instructions instructions ## Getting started 1. Launch the product via 1-Click 2. Use a web browser to access the console application at: http://[ec2-ip]:8080/guacamole where [ec2_ip] is the public ip provided by Amazon for your instance. 3. Log in using the following credentials: * Username: guacadmin * Password: the instance_id of the instance You can also access your instance via SSH using the username and your Amazon private key. The **username** username depends on the operative system: * - Centos 9 Stream: 'ec2-user' * - Other Centos: 'centos' * - Ubuntu: 'ubuntu' * - Rocky Linux: 'rocky' ## Installation details Apache Guacamole 1.3.0 is compiled natively and runnning on APache Tomcat 9, with OpenJDK 11 and MySQL 8. 8 The project location is /etc/guacamole ($GUACAMOLE_HOME) where configuration files are stored. The extensions are in $GUACAMOLE_HOME/extensions and the libraries in $GUACAMOLE_HOME/lib Tomcat server is installed in /usr/java/apache-tomcat-[version] directory, which is linked to /usr/java/apache-tomcat, defined in $CATALINA_HOME. The Apache Guacamole WAR is deployed at $CATALINA_HOME/webapps. Services are configured with systemd. (*) If the client wants to use other kind of authentication, project and libraries are provided at $HOME/software/guacamole directory ### Authentication methods **MySQL** MySQL It uses the authentication module through MySQL database thanks to the library guacamole-auth-jdbc-mysql-x.x.x.jar, in $GUACAMOLE_HOME/extensions directory, the JDBC driver of MySQL, mysql-connector-java-x.x.x.jar, in $GUACAMOLE_HOME/lib directory and the database configuration provided in the file: $GUACAMOLE_HOME/guacamole.properties **PostgreSQL** PostgreSQL It uses the authentication module through PostgreSQL database thanks to the library guacamole-auth-jdbc-postgresql-x.x.x.jar, in $GUACAMOLE_HOME/extensions directory, the JDBC driver of PostgreSQL, postgresql-x.x.x.jar, in $GUACAMOLE_HOME/lib directory and the database configuration provided in the file: $GUACAMOLE_HOME/guacamole.properties ### Tomcat View status of service: ``` shell $ sudo systemctl status tomcat ``` Stop service: ``` shell $ sudo systemctl stop tomcat ``` Start service: ``` shell $ sudo systemctl start tomcat ``` ### Guacamole View status of service: ``` shell $ sudo systemctl status guacd ``` Stop service: ``` shell $ sudo systemctl stop guacd ``` Start service: ``` shell $ sudo systemctl start guacd ``` ### MySQL View status of service: ``` shell $ sudo systemctl status mysqld ``` Stop service: ``` shell $ sudo systemctl stop mysqld ``` Start service: ``` shell $ sudo systemctl start mysqld ``` Access to MysQL console: ``` shell $ sudo mysql ``` ### PostgreSQL View status of service: ``` shell $ sudo systemctl status postgresql ``` Stop service: ``` shell $ sudo systemctl stop postgresql ``` Start service: ``` shell $ sudo systemctl start postgresql ``` Access to MysQL console: ``` shell sudo -u postgres psql ``` ## Other useful data **Location Location of sensitive information** information There is no sensitive data **Encryption configuration** Encryption configuration There is no encrypted data. **Changing Changing system credentials** credentials To change the Guacamole credentials you have to go to the right menu, click "Settings" button, users section, select user guacadmin and complete the form. **Instructions Instructions on how the user interacts with Guacamole to decrypt necessary data** data You can use the Guacamole management console to view all necessary data. **How How to assess and monitor the health and proper function of the application.** application. 1. Navigate to your Amazon EC2 console and verify that you're in the correct region. 2. Choose Instance and select your launched instance. 3. Select the server to display your metadata page and choose the Status checks tab at the bottom of the page to review if your status checks passed or failed. ## Additional resources Apache Tomcat: https://tomee.apache.org/ Apache Guacamole: https://guacamole.apache.org MySQL: https://www.mysql.com/