Instrucciones de uso

Primeros pasos



  1. Lance el producto via 1-Click

  2. Use un navegador para acceder a la consola en: http://[ec2-ip]:8080/guacamole donde [ec2-ip] es la ip publica facilitada por Amazon para tu instancia.

  3. Acceda utilizando las siguientes credenciales:

    • Usuario: guacadmin

    • Contraseña: el campo instance_id de la instancia


También puede acceder a su instancia via SSH, usando el usuario correspondiente y su clave privada de Amazon.
El usuario depende del sistema operativo: 
  - Centos 9 Stream: 'ec2-user'
  - Otros Centos: 'centos'
  - Ubuntu: 'ubuntu'
  - Rocky Linux: 'rocky'

Detalles de la instalación



  • Instalado Apache Guacamole 1.3.0 compilado de forma nativa funcionando contra Apache Tomcat 9, OpenJDK 11 y MySQL 8.
  • El directorio de configuración del proyecto se encuentra en /etc/guacamole ($GUACAMOLE_HOME) dónde se ubican los ficheros de configuración. Las extensiones en $GUACAMOLE_HOME/extensions y las librerías en $GUACAMOLE_HOME/lib.
  • El servidor Tomcat está instalado en el directorio /usr/java/apache-tomcat-[version], el cual esta enlazado a /usr/java/apache-tomcat, siendo ésta la ruta de $CATALINA_HOME.
  • El fichero WAR del proyecto Apache Guacamole está desplegado en $CATALINA_HOME/webapps.
  • Los servicios están configurados con systemd.


(*) Si el cliente quisiera utilizar otro tipo de autenticación, dispone del proyecto y las librerías ya descargadas en $HOME/software/guacamole.


Tipos de autenticación



MySQL

El proyecto utiliza el módulo de autenticación a través de la base de datos MySQL con la librería de autenticación por base de datos MySQL (guacamole-auth-jdbc-mysql-x.x.x.jar) en $GUACAMOLE_HOME/extensions, el driver JDBC de MySQL (mysql-connector-java-x.x.x.jar) en $GUACAMOLE_HOME/lib y la configuración de la base de datos en $GUACAMOLE_HOME/guacamole.properties.

PostgreSQL

El proyecto utiliza el módulo de autenticación a través de la base de datos PostgreSQL con la librería de autenticación por base de datos PostgreSQL (guacamole-auth-jdbc-postgresql-x.x.x.jar) en $GUACAMOLE_HOME/extensions, el driver JDBC de MySQL (postgresql-x.x.x.jar) en $GUACAMOLE_HOME/lib y la configuración de la base de datos en $GUACAMOLE_HOME/guacamole.properties.

Tomcat



Ver estado del servicio:

$ sudo systemctl status tomcat

Parar el servicio:

$ sudo systemctl stop tomcat

Lanzar el servicio:

$ sudo systemctl start tomcat

Guacamole



Ver estado del servicio:

$ sudo systemctl status guacd

Parar el servicio:

$ sudo systemctl stop guacd

Lanzar el servicio:

$ sudo systemctl start guacd

MySQL



Ver estado del servicio:

$ sudo systemctl status mysqld

Parar el servicio:

$ sudo systemctl stop mysqld

Lanzar el servicio:

$ sudo systemctl start mysqld

Acceder a la consola de MySQL desde su terminal:

$ sudo mysql

PostgreSQL



Ver estado del servicio:

$ sudo systemctl status postgresql

Parar el servicio:

$ sudo systemctl stop postgresql

Lanzar el servicio:

$ sudo systemctl start postgresql

Acceder a la consola de MySQL desde su terminal:

$ sudo -u postgres psql


Recursos adicionales