Diagnosis procedures
Content:
- Problem: Logs are not traced
- Problem: The API does not work
- Problem: The GUI does not work
- Other problems
Problem: Logs are not traced
Reason: There may be a problem with the logging folder
First, check the folder /var/log/cygnus
has been created:
$ ls -la /var/log/cygnus
total 117712
drwxr-xr-x 3 frb staff 102 19 feb 09:02 .
drwxr-xr-x 61 root wheel 2074 6 may 07:32 ..
-rw-r--r-- 1 frb staff 60265711 19 feb 09:00 cygnus.log
Second, check the ownership of the above folder. If the owner is not cygnus
and the group is not cygnus
, you must change the ownership:
$ chown cygnus:cygnus /var/log/cygnus
Third, check the permissions of the log folder. If the permissions does not contain write permissions, add them:
$ chmod a+w /var/log/cygnus
Reason: There may be a problem with the logging configuration of Cygnus
Check the log4j configuration is using a file-related appender.
First of all, check you have a valid lo4j.properties
file (not a template) in /usr/cygnus/conf/
.
Then, verify you have these lines configured:
flume.log.dir=/var/log/cygnus/
flume.log.file=cygnus.log
Another possibility is you are changing the above configuration from the command line, by using the following arguments:
-Dflume.root.logger=<log_level>,<appender>
Check the apender value is LOG_FILE
.
Problem: The API does not work
Reason: There may be a problem with the configured port
Check the port you are using in the request is the one configued in Cygnus. By default, it is 8081
, but can be modified by Cygnus administrator.
Reason: The configured port is not open in the firewall
The API port may be properly configured but not opened in the firewall (if such a firewall is running) protecting your machine.
The specific solution depends on the specific firewall. Here, iptables
-based firewalling is shown. Please, check the port is open (default 8081
is used in the examples):
$ (sudo) iptables -L
Chain INPUT (policy ACCEPT)
target prot opt source destination
ACCEPT tcp -- anywhere anywhere tcp dpt:8081
Chain FORWARD (policy ACCEPT)
target prot opt source destination
Chain OUTPUT (policy ACCEPT)
target prot opt source destination
If not, open it:
$ (sudo) iptables -I INPUT -p tcp --dport 8081 -j ACCEPT
Problem: The GUI does not work
Coming soon.
Other problems
Please look for fiware-cygnus
tag in stackoverflow.com.