ÁguilaControl    
Administración,   modo  consola  

 
Plataforma  GPS  

Sistema   Listeners   Sutran  

Aprenda  a  manejar  la   Inicie  los  programas   Configure  y  monitoree  la  
consola  de  su  VPS.   “Listener”,  monitoree  el   transmisión  al  Centro  de  
Monitoree  el  consumo  de   tráfico  de  los  equipos  GPS.   Control  y  Monitoreo  de  
recursos.   Flotas  –  SUTRAN.  

Administrar  su  VPS  en  modo  consola  

no  tiene  por  qué  ser  difícil.  Sólo  siga  esta  guía  
para  mantener  su  servidor  siempre  en  línea.  

Para  administrar  nuestro  VPS  es  necesario  conectarnos  a  él  mediante  un  Terminal  SSH.  Desde  dicho  terminal  podremos  
enviar  los  comandos  respectivos  para  el  control  del  sistema.  El  preferido  de  todos  es  PuTTY  SSH  y  lo  puede  descargar  en:  

http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe      Para  esta  guía  usaremos  PuTTY  SSH.  

 Praesent  pretium  
Sistema   lectus  a  dui.  
Ingresamos la dirección IP de nuestro servidor y le
damos clic en “Open”. Aparecerá una ventana que
nos pedirá nuestras credenciales de acceso, “root”
y “password”.
Solicite al administrador sus credenciales.

Antes de seguir, configuraremos el PuTTY SSH para que permanezca activo, ya que si no se envía un
comando alguno por un lapso de tiempo, la sesión se cierra y tendremos que volver a ingresar al sistema.
Para evitar esto, le hacemos click derecho a la ventana, luego click en Change Settings.

En el menú izquierdo elegimos Connection, y en el cuadro “Seconds between …” le ponemos 10. Esto
hará que PuTTY mantenga activa la sesión.

2  
 
4
1
2
3
5

 www.aguilacontrol.com

Comandos básicos
Sistema      
A continuación presentamos una lista de los comandos básicos en el modo consola que le permitirán
moverse entre las carpetas, mostrar información del sistema, etc.
IMPORTANTE: Todos los comandos son CASE SENSITIVE de modo que deberá escribirlos TAL CUAL, con
minúsculas o mayúsculas según sea el caso.

1.1 Comandos básicos 1.3 Reinicio del sistema

Para movernos entre directorios, podemos usar el
comando “cd”, por ejemplo:
-# cd /directorio/subdirectorio/ (ir a ese directorio)
-# cd .. (descender una carpeta)
Para listar el contenido de una carpeta podemos
usar el comando “ls”, por ejemplo:
-# ls (muestra el contenido del directorio actual)
-# ls -1 (muestra una lista, un archivo por fila)
Para limpiar la ventana de la consola podemos usar
el comando “clear”
-# clear (limpia la ventana del terminal)
1.2 Ver procesos en ejecución
La plataforma GPS está basada en JAVA de modo
que podemos ver la lista de procesos que están
corriendo actualmente con el siguiente comando:
-# jps -l
En algunas ocasiones es necesario reiniciar el
sistema. Puede que después de una actualización
importante, para liberar recursos del sistema o
como una rutina de mantenimiento.
Para reiniciar el sistema operativo basta con
ejecutar el siguiente comando:
-# reboot
ADVERTENCIA: No reinicie el sistema a menos
que sea absolutamente necesario ya que podría
afectar al desempeño de la base de datos.
1.4 Monitoreo de la RAM disponible
Debido a que todos los procesos consumen
memoria RAM, debemos monitorear
constantemente que el sistema no se quede sin
memoria. Con el comando “free –m” podremos
ver cuánta memoria disponible en MB tenemos.
-# free –m

En este ejemplo vemos que se está usando

721MB y quedan libres unos 272MB.

1.5 Liberar memoria RAM

En ciertas ocasiones, cuando la RAM disponible
esté demasiado baja (debido a que usamos
muchos procesos en JAVA) es conveniente realizar
una limpieza de la memoria cache.
Se muestra el ID del proceso y al costado el
-# sudo sync && sudo sysctl -w vm.drop_caches=1
nombre del programa JAR (ejecutable Java) que
está corriendo.

3  
 
1
2
3

Operaciones con la Plataforma

Listeners      
Los Listeners, o capturadores de tramas, son programas hechos en JAVA que se encargan de procesar la
data proveniente de los dispositivos GPS. Debido a que cada marca/modelo emplea su propio protocolo,
es importante iniciar el capturador correspondiente a fin de que la data sea almacenada.

2.1 Lista de protocolos compatibles 2.2 Tabla de Equipos / Protocolos

Podemos listar la lista completa de los protocolos En muchos casos un solo protocolo puede ser
implementados en la plataforma, ejecutando el compatible con varios modelos de dispositivos
siguiente comando:
-# ls $GTS_HOME/dcservers -1
Nombre de Relación de Equipos
Protocolo compatibles
patrolscan XT5, Patrolscan v1 – v5
meitrack_mvt Meitrack MVT340, MVT 380,
MVT100, MVT600, MT88
meitrack Meitrack / Meligao VT300,
VT310, Topten TK668
autoleader AL800, AL900C
bofan PT502, PT80
tk10x TK102, TK103, GPS103B,
GPS518
gt06 Concox GT06
traxs4 GTE TraxS4
steppII Falcom SteppII
tlt2h TLT-2H, TLT-2F
wondeproud VT10
tt8750 Skypatrol TT8750
skypatrol Skypatrol TT8750+, TT9200
dct DCT Syrus SY2210 v1
gl100 Quectel GL100, RaptorGPS
vt3clon VT310BB Clon
hplow Hunter Pro Lojack HPLOW
tt8850 Skypatrol TT8850
tzone AVL05, AVL02
meitrack_t322 Meitrack T322
gt02 Concox GT02
gl200 Quectel Gl200, GV200
patrol5 Patrolscan v5
polestar Polestar TK103-2
La sintaxis es la siguiente: gt06d Concox GT06D, GT100
dcserver_Puerto_programador_NombreDeProtocolo
Por ejemplo, si tomamos el archivo: Si usa un dispositivo que no se encuentra en la lista,
dcserver_65203_aguila_meitrack.xml consulte con informes@aguilacontrol.com el
desarrollo de un nuevo módulo a fin de integrarlo
Significa que el “Capturador” para el protocolo
en la lista.
Meitrack usa el puerto 65203.
OBSERVACIÓN: Se usa el mismo puerto tanto para
TCP como para UDP

4  
 
1
2

 www.aguilacontrol.com

Operaciones con la Plataforma

Listeners      
Si bien la plataforma es compatible con la mayoría de equipos comerciales, no es recomendable tener
activos los capturadores que no se usan ya que consumen recursos que en un VPS son muy preciados,
como la memoria RAM.

2.3 Iniciando un capturador “listener”

Una vez identificado el protocolo a usar, podemos
proceder a iniciarlo con el siguiente comando:
-# $GTS_HOME/bin/runserver.sh –s NombreDeProtocolo
Por ejemplo, para iniciar el protocolo “meitrack”, el
comando sería así:
-# $GTS_HOME/bin/runserver.sh –s meitrack
Esto iniciará el programa “capturador” en
segundo plano y se le asignará un PID (Código
de Proceso).
Así mismo se creará un archivo log en la
carpeta: $GTS_HOME/logs
El NombreDeProtocolo lo puede obtener de
la sección 2.1.

2.4 Deteniendo un capturador “listener”

Por ejemplo, para detener el protocolo “meitrack” se
debe agregar “-kill” al final del comando.
-# $GTS_HOME/bin/runserver.sh –s meitrack -kill
Este comando enviará una señal KILL al
programa para que deje de ejecutarse
dejando libre el puerto que estaba usando
así como la memoria RAM asignada.

2.5 Iniciando un capturador “listener” en primer plano (Modo Interactivo)  

En ocasiones desearemos iniciar el
capturador en primer plano con el
fin de COMPROBAR que el
equipo GPS esté enviando data y
que el programa la está
recibiendo con normalidad. Por
ejemplo, si queremos correr el
protocolo “meitrack” en primer
plano, añadimos “-i” al final del
comando. Por ejemplo:

-# $GTS_HOME/bin/runserver.sh –s meitrack –i

5  
 
1
2

(Continuación)  
Operaciones con la Plataforma
Listeners      
De esta forma se iniciará el “capturador” en 2.6 Iniciar un capturador “listener” en otro
modo interactivo y se mostrará en pantalla toda puerto
comunicación que se vaya recibiendo de los
Por ejemplo, para iniciar el protocolo “meitrack” en
equipos GPS.
el puerto 25000 se debe agregar “-port
Para salir del modo interactivo presione: CTRL+C
númeroDePuerto” al final del comando. Ejemplo:
IMPORTANTE: Al salir del modo interactivo se
-# $GTS_HOME/bin/runserver.sh –s meitrack –port 25000
cerrará cualquier comunicación con los
dispositivos. Por lo que una vez cerrado el Esto iniciará un proceso en segundo plano
modo interactivo deberá dejar corriendo el escuchando el puerto 25000 tanto en UDP como en
programa “capturador” en segundo plano. Tal TCP.
cual se explicó en la sección 2.3 de este
manual.

Apache  Tomcat      
3.1 Iniciar Interfaz Web
La interface web de la plataforma GPS corre bajo
un programa servidor llamado Tomcat. Para
iniciar la interface web debe ejecutar el siguiente
comando

-# $CATALINA_HOME/bin/startup.sh

Es muy importante asegurarse que este proceso esté ejecutándose correctamente ya

que de no ser así, no se tendrá acceso a la plataforma WEB.

6  
 
1

 www.aguilacontrol.com

Agente de Comunicaciones
Control  de  Flotas  
SUTRAN      

La plataforma viene precargada con el software “Agente de Comunicaciones v2.5” y sólo necesita ser
iniciada con un comando. Esta aplicación no está diseñada para correr en segundo plano, de modo que es
necesario ejecutarla y luego “esconderla” para poder seguir usando nuestro sistema.  

3.2 Iniciar el Agente de

Comunicaciones SUTRAN
-# /usr/local/ccmf25/ccmf.sh

Este comando iniciará el programa en primer

plano. Para dejar corriendo el programa en
segundo plano sin cerrarlo debe presionar
CTRL+A, luego CTRL + D.

Le aparecerá el mensaje:
detached from 23302
Lo que indica que el programa ha pasado a
segundo plano y el PID es 23302 (número
aleatorio). En este momento puede
continuar usando su sistema normalmente.
Para traer a primer plano nuevamente el
programa ejecutar el siguiente comando:
-# screen –r 23302

Siendo 23302 el número del PID que nos dio

cuando lo pasamos a segundo plano.
Para listar los procesos que corren en
segundo plano, ejecutar el comando:
-# screen –ls

7  
 
3
1
2

  Agente de Comunicaciones
Control  de  Flotas     (Continuación)  
CCMF-­‐SUTRAN      
3.3 Transmisión Selectiva

Sólo se transmitirán los registros cuyo ID de

Vehículo contenga un guión al medio y
además contengan la placa del vehículo.
En este ejemplo, se transmitirá al CCMF los registros de la
placa A0M-844, porque tiene “guión al medio”, mientras
que los registros de la placa A0O-107 permanecerán en el
sistema.

Consideraciones  Generales      
4.1 Al reiniciar el sistema Si no puede tener acceso al sistema mediante SSH
infórmelo inmediatamente enviando un email a
Siempre que reinicie el sistema debe
informes@aguilacontrol.com.
asegurarse de cargar lo siguiente:
a) Apache Tomcat
# $CATALINA_HOME/bin/startup.sh

b) Agente SUTRAN (si se requiere)

# Siga procedimiento de la sección 3.2

c) Capturadores usados “PROTOCOLOS”

# $GTS_HOME/bin/runserver.sh –s protocolo
Más información en Capítulo Listeners.

4.2 Sistema Colgado?

Algunas de las razones por las que el sistema se
puede “congelar” son:

a) Poca memoria RAM. Use el comando

de la sección 1.5 para liberar memoria
cache y monitoree la RAM disponible
con el comando de la sección 1.4.
b) Muchos capturadores abiertos.
Ejecute el comando de la sección 1.2
para tener la lista de capturadores en
ejecución, cierre los que no usa. Vea el
capítulo LISTENERS.
c) Sistema desactualizado. Consulte con
su proveedor para actualizar el sistema
operativo.

8