Se usó la API de Cloud Translation para traducir esta página.

Incorpore una organización

Edge for Private Cloud v4.18.05

Usa la secuencia de comandos setup-org para realizar el proceso de integración. Debes ejecutar la secuencia de comandos en el nodo del servidor de administración.

Para incorporar una organización, sigue estos pasos:

Instala apigee-provision en el nodo del servidor de administración:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision install

Ejecuta la secuencia de comandos setup-org en el nodo del servidor de administración:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
El usuario "apigee" debe poder leer el archivo de configuración. Para ver un ejemplo de archivo de configuración, consulta Archivo de configuración de integración.
Verifica que hayas integrado correctamente una organización. Una forma de hacerlo es acceder a la IU solicitando la siguiente URL en un navegador:
```
http://IP_address:9000/login
```
En el ejemplo anterior, IP_address es la dirección IP del servidor en el que instalaste la IU de Edge.

Para conocer otros pasos de verificación, consulta Cómo verificar la integración.
Crea tu primer proxy

Archivo de configuración de la integración

Para realizar una configuración silenciosa con la secuencia de comandos setup-org, pasa un archivo de configuración con la opción -f, como se muestra en el siguiente ejemplo:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Esta sección incluye un archivo de configuración de muestra para integrar una organización con setup-org.

Cuando se incorpora una organización, la secuencia de comandos setup-org hace lo siguiente:

Crea una organización nueva.
Crea un entorno.
Crea un host virtual para el entorno.
Establece al usuario especificado como administrador de la organización. Ten en cuenta lo siguiente:
- Puedes usar un usuario existente o crear uno nuevo para el administrador de la organización.
- El administrador de la organización no debe ser el mismo que el administrador del sistema.
Asocia la organización con el Pod “puerta de enlace”. (Esta es la configuración predeterminada y no se puede cambiar).
Asocia el entorno con todos los procesadores de mensajes.
Habilita las estadísticas.

Copia el siguiente ejemplo y edítalo según sea necesario para integrar tu organización:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

Notas:

Para VHOST_ALIAS, si ya tienes un registro DNS que usarás para acceder al host virtual, especifica el alias de host y, de manera opcional, el puerto, por ejemplo, "myapi.example.com". Si aún no tienes un registro DNS, puedes usar la dirección IP del router.

Para obtener más información sobre cómo configurar el host virtual, consulta Cómo configurar un host virtual.
Para la configuración de TLS/SSL, consulta almacenes de claves y almacenes de confianza y Configura el acceso TLS a una API para la nube privada a fin de obtener más información sobre la creación del archivo JAR y otros aspectos de la configuración de TLS/SSL.
Para obtener más información sobre la configuración de hosts virtuales, consulta Configura el acceso a TLS a una API para la nube privada.
No puedes crear dos organizaciones con el mismo nombre. En ese caso, la segunda creación fallará.

Si deseas obtener más información sobre el uso de la API de Management para incorporar una organización, consulta Crea una organización, un entorno y un host virtual.

Verifica la integración

Cuando se complete la integración, verifica el estado del sistema con los siguientes comandos de CURL en el nodo del servidor de administración:

Ejecuta los siguientes comandos para verificar el estado de los usuarios y la organización en el servidor de administración:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations/org_name/deployments

Para verificar las estadísticas, ejecuta el siguiente comando:

curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

Para verificar el estado de la base de datos de PostgreSQL, ejecuta los siguientes comandos en el nodo 2 (como se muestra en las topologías de instalación):
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
En el símbolo del sistema, ingresa el siguiente comando para ver la tabla de estadísticas de tu organización:
```
\d analytics."org_name.env_name.fact"
```
Usa el siguiente comando para salir de psql:
```
\q
```
Accede a la IU de Apigee Edge con un navegador web. Recuerda que ya anotaste la URL de la consola de administración al final de la instalación.
1. Inicia tu navegador preferido y, luego, ingresa la URL de la IU de Edge. Se ve similar al siguiente, en el que la dirección IP es para el nodo 1 (como se muestra en las topologías de instalación) o cualquier nodo en el que instalaste la IU para configuraciones alternativas:
```
http://192.168.56.111:9000/login
```
  9000 es el número de puerto que usa la IU.
  
  Si inicias el navegador directamente en el servidor que aloja la IU de Edge, puedes usar una URL del siguiente formato:
```
http://localhost:9000/login
```
  Nota: Asegúrate de que el puerto 9000 esté abierto. Si usas un servicio como Google Cloud Engine, es posible que debas modificar las reglas de firewall para poder acceder a los servicios de Apigee a través de un navegador.
2. En la página de acceso de la consola, especifica el nombre de usuario y la contraseña del administrador del sistema de Apigee.
  Nota: Esta es la contraseña de administrador del sistema global que estableciste durante la instalación.
Regístrate para obtener una nueva cuenta de usuario de Apigee y usa la nueva credencial de usuario para acceder. En la página de acceso de la consola, haz clic en el botón Acceder.

El navegador redirecciona a http://192.168.56.111:9000/platform/#/org_name/ y abre un panel que te permite configurar la organización que creaste (si accediste con credenciales de administrador de Apigee).

Crea tu primer proxy

Después de incorporar una organización nueva y verificar que el proceso de integración se realizó correctamente, ahora puedes crear tu primer proxy. Para obtener más información, consulta Crea tu primer proxy de API.

Estos son otros recursos que podrían resultarte útiles: