AWS Marketplace

{{toc}}

# 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:

``` shell

$ sudo systemctl status tomcat

```

Parar el servicio:

``` shell

$ sudo systemctl stop tomcat

```

Lanzar el servicio:

``` shell

$ sudo systemctl start tomcat

```

### Guacamole

Ver estado del servicio:

``` shell

$ sudo systemctl status guacd

```

Parar el servicio:

``` shell

$ sudo systemctl stop guacd

```

Lanzar el servicio:

``` shell

$ sudo systemctl start guacd

```

### MySQL

Ver estado del servicio:

``` shell

$ sudo systemctl status mysqld

```

Parar el servicio:

``` shell

$ sudo systemctl stop mysqld

```

Lanzar el servicio:

``` shell

$ sudo systemctl start mysqld

```

Acceder a la consola de MySQL desde su terminal:

``` shell

$ sudo mysql

```

### PostgreSQL

Ver estado del servicio:

``` shell

$ sudo systemctl status postgresql

```

Parar el servicio:

``` shell

$ sudo systemctl stop postgresql

```

Lanzar el servicio:

``` shell

$ sudo systemctl start postgresql

```

Acceder a la consola de MySQL desde su terminal:

``` shell

$ sudo -u postgres psql

```

## Otros datos útiles

**Ubicación de información sensible**

No hay datos sensibles

**Configuración de cifrado**

No hay datos cifrados.

**Cambiar las credenciales del sistema**

Para cambiar las credenciales de Guacamole tienes que ir al menú derecho, hacer clic en el botón "Configuración", sección usuarios, seleccionar usuario guacadmin y completar el formulario.

**Instrucciones sobre cómo el usuario interactúa con Guacamole para descifrar los datos necesarios**

Puede utilizar la consola de administración de Guacamole para ver todos los datos necesarios.

**Cómo evaluar y monitorear el estado y el funcionamiento adecuado de la aplicación.**

1. Navegue hasta su consola Amazon EC2 y verifique que se encuentre en la región correcta.

2. Elija Instancia y seleccione su instancia lanzada.

3. Seleccione el servidor para mostrar su página de metadatos y elija la pestaña Verificaciones de estado en la parte inferior de la página para revisar si sus verificaciones de estado pasaron o fallaron.

## Recursos adicionales

Apache Tomcat: 

* https://tomee.apache.org

Apache Guacamole: 

* https://guacamole.apache.org

MySQL: 

* https://www.mysql.com

PostgreSQL: 

* https://www.postgresql.org