---
title: "Onesait Architecture Development Environment"
canonical: "https://onesaitplatform-es.refined.site/space/DOC/3553132547/Onesait+Architecture+Development+Environment"
format: markdown
---
|  |  |  |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
| Nombre | Arquitecture Development Environment | ID | A.ARQ.01 | Versión | v 1.0.0 | Licencia | Free |
| Área | Arquitectura | Fase | Lanzamiento | Tipo | Acelerador | Impacto | 43 horas |


|  |  |
| --- | --- |
| # Funcionalidad<br>A continuación se describe la herramienta Onesait Architecture Development Environment, que consiste básicamente en una serie de scripts que pondrán en la mano del usuario gran parte de las herramientas y tecnologías que serán usadas para el entorno del producto. En el siguiente enlace podremos descargar un archivo .zip con la herramienta lista para ser utilizada. | # Requisitos<br>Acceso a office365<br>Equipo con 8GB de RAM mínimo (16GB recomendables) |

## Instrucciones de instalación

- Descomprimir el archivo OA_ENV.zip en una localización deseada.
- Ejecutar el script OA_ENV_START.bat situado en el directorio principal del OA_ENV para ejecutar el entorno. Esto creará un nuevo disco T:.
- A partir de este momento, ejecutar los programas deseados con su script determinado (en la carpeta T:OA_ENV/scripts) para evitar problemas de ejecución.
- Cuando se desee terminar con los programas, ejecutar el script OA_ENV_STOP.bat en el directorio principal de OA_ENV. El disco T: desaparecerá.

## Contenido 

En el disco virtual generado podremos encontrar 4 carpetas principales: 

- “*T:/*m2_repo”: Carpeta que actuará como repositorio local para Maven. Aquí se descargarán las dependencias de Maven utilizadas en los proyectos.
- “T:/*sources*”: Carpeta donde de manera recomendada se guardarán los distintos proyectos realizados.
- “*T:/*scripts”: Aquí encontramos los scripts para iniciar de manera correcta los distintos programas.
- “*T:/tools*”: Aquí encontramos la carpeta de instalación de los distintos programas incluidos*. A continuación mostramos la lista de todos ellos, y su versión:
  - 
    - openjdk:1.8.0_282 (adoptopenjdk) (* También se aceptaría openjdk)
    - maven: 3.6.1
    - sts: 4.3.0
    - visual studio code: 1.32.1
    - node.js: 10.16.0
    - mysql: 8.0.16
    - mongo: 4.0.10
    - git: 2.9
    - postgresql: 11
    - postgis 2.5.2x64
    - python: 3.7
    - junit: 4.10
    - notepad++: 7.7.1

[Para mas información sobre las herramientas pulsa aquí.](/pages/viewpage.action?pageId=356815204)

**No se recomienda la ejecución de estos programas directamente desde el ejecutable de la carpeta de instalación. *


### Observaciones generales

Si se desease ejecutar cualquier comando relativo a alguna de las herramientas instaladas por terminal (por ejemplo, git --version,...) se deberá tener en cuenta que dicha terminal deberá ser abierta por el script cmd_start.bat de la carpeta scripts. De esta manera, abriremos una consola bajo el disco T: que tiene en cuenta las variables de entorno necesarias para la ejecución de los comandos.

### Observaciones de STS

Para el correcto funcionamiento del STS deberemos asegurarnos de que las preferencias de Maven estén correctamente configuradas. Para ello deberemos ir a: *Windows->Preferences->Maven.*

Aquí deberemos hacer dos comprobaciones: 

1. En Installations: Deberemos añadir si no existe la carpeta de instalación de maven(*T:\tools\maven*), y marcar esta casilla desmarcando las otras dos existentes.
2. En User Settings: En el campo de User Settings añadir la ruta al settings.xml: “*T:\tools\maven\conf\settings.xml”* y asegurarnos de que la ruta de Local Repository sea: “T:/m2_repo/” en caso de que no salga esta ruta pulsaremos sobre “Reindex” y se deberá actualizar.

### Observaciones de Maven

Cambiar la configuración de proxy de maven en el archivo settings.xml localizado en la ruta _OA_ENV\tools\apache-maven-3.6.1\conf\settings_. Debemos de cambiar el nombre de usuario y la contraseña de la parte de código apartado.

<proxies>

<proxy>  
<id>proxy-localhost</id>  
<active>true</active>  
<protocol>http</protocol>  
<username>**USER**</username>  
<password>**PASSWORD**</password>  
<host>*[proxy.indra.es](http://proxy.indra.es/)*</host>  
<port>8080</port>  
<nonProxyHosts>*[local.net](http://local.net/)*|*[some.host.com](http://some.host.com/)*</nonProxyHosts>  
</proxy>

...

</proxies>

### Observaciones de PostgreSQL

Si durante la ejecución del postgresql_start.bat(pgAdmin 4) aparece un error de conexión, cambia la IP de la URL del navegador por localhost.

Ejemplo:  
*[http://XXX.0.0.1:60989/?key=](http://XXX.0.0.1:60989/?key=)*...   —>   *[http://localhost:60989/?key=](http://localhost:60989/?key=)*...

- Para acceder a los servidores de Postgresql con tu usuario y contraseña del PC en vez de con el usuario de Postgres:
  - Crear un nuevo servidor haciendo click derecho en Servers.
  - General/Nombre: Cualquiera.
  - Connection/Host: localhost.
  - Connection/Port: 5434.
  - Connection/Username: tu usuario del PC.
  - Connection/password: to contraseña del PC.
  - Save.

A partir de este momento estamos conectados al servidor de PostgreSQL localizado del el disco T:, y podremos realizar todas las operaciones deseadas con las bases de datos del servidor.

En la instalación de PostgreSQL y Pgadmin también se incluye el plugin de PostGIS, que extiende la funcionalidad de PostgreSQL agregando soporte para objetos geográficos permitiendo que las consultas de ubicación se ejecuten en SQL. Para su utilización simplemente bastará con añadir la extensión como se indica en su web: [https://postgis.net/](https://postgis.net/).

### Observaciones de Node.JS

Para el correcto funcionamiento de node.js y los comandos npm se debe configurar el fichero .npmrc bajo la ruta C:\Users\tu_usuario para indicarle el uso del proxy. Para ello debemos añadir la siguiente linea, introduciendo tu nombre de usuario y contraseña. En este fichero también encontramos un token de autenticación que se genera automáticamente al hacer npm login.

proxy=*[http://tu_usuario:tu_contraseña@proxy.indra.es:8080/](http://tu_usuario:tu_contraseña@proxy.indra.es:8080/)*

https-proxy=*[http://tu_usuario:tu_contraseña@proxy.indra.es:8080/](http://tu_usuario:tu_contraseña@proxy.indra.es:8080/)*