Skip to content

Commit

Permalink
Update diagnosis.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Alessandro committed Sep 4, 2017
1 parent 244f31c commit 2d95ee5
Showing 1 changed file with 16 additions and 16 deletions.
32 changes: 16 additions & 16 deletions doc/admin/diagnosis.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,56 +6,56 @@
* [I/O Flows](#io-flows)

The Diagnosis Procedures are the first steps that a System Administrator
will take to locate the source of an error in SpagoBI. Once the nature of
will take to locate the source of an error in Knowage. Once the nature of
the error is identified with these tests, the system admin will often
have to resort to more concrete and specific testing to pinpoint the
exact point of failure and a possible solution. Such specific testing is
out of the scope of this section.

Please report any bug or problem with SpagoBI by [opening and issue in JIRA](https://spagobi.eng.it/jira/secure/Dashboard.jspa).
Please report any bug or problem with Knowage by [opening and issue in JIRA](https://www.knowage-suite.com/jira/).

## Resource Availability

Although we haven't done yet a precise profiling on SpagoBI, tests done in our development and testing environment show that
a host with 2 CPU cores and 8 GB RAM is the minimum configuration to run SpagoBI with MySQL server.
Although we haven't done yet a precise profiling on Knowage, tests done in our development and testing environment show that
a host with 2 CPU cores and 8 GB RAM is the minimum configuration to run Knowage with MySQL server.

[Top](#top)

## Remote Service Access

SpagoBI can run *standalone*, it's a Business Intelligence Application and it can grab the data from different data sources. However, when considering its use in the FIWARE platform, below is a list of the GEs that typically can be
connected to SpagoBI usage:
Knowage can run *standalone*, it's a Business Intelligence Application and it can grab the data from different data sources. However, when considering its use in the FIWARE platform, below is a list of the GEs that typically can be
connected to Knowage usage:

* [Identity Management - KeyRock](http://catalogue.fiware.org/enablers/identity-management-keyrock) : SpagoBI can use authentication and authorization mechanism provided by the Identity Manament. Check the [admin manual](https://github.com/SpagoBILabs/SpagoBI/tree/master/doc/admin/README.md)
* [Orion Context Broker](https://github.com/telefonicaid/fiware-orion) : SpagoBI can query and analyze the data coming from Orion and it can be notified if the data changes. Check the [NGSI manual](https://github.com/SpagoBILabs/SpagoBI/blob/master/doc/user/NGSI/README.md)
* CKAN: SpagoBI can query and analyze the data from CKAN portal. Check the [CKAN manual](https://github.com/SpagoBILabs/SpagoBI/blob/master/doc/user/CKAN/README.md)
* [Identity Management - KeyRock](http://catalogue.fiware.org/enablers/identity-management-keyrock) : Knowage can use authentication and authorization mechanism provided by the Identity Manament. Check the [admin manual](https://github.com/KnowageLabs/Knowage-Server/tree/master/doc/admin/README.md)
* [Orion Context Broker](https://github.com/telefonicaid/fiware-orion) : Knowage can query and analyze the data coming from Orion and it can be notified if the data changes. Check the [NGSI manual](https://github.com/KnowageLabs/Knowage-Server/blob/master/doc/user/NGSI/README.md)
* CKAN: Knowage can query and analyze the data from CKAN portal. Check the [CKAN manual](https://github.com/KnowageLabs/Knowage-Server/blob/master/doc/user/CKAN/README.md)

[Top](#top)

## Resource consumption

The most usual problems that SpagoBI may have are related
The most usual problems that Knowage may have are related
to abnormal consumption of memory due to leaks.

Regarding abnormal consumption of memory, it can be detected by the the
following symptoms:

- SpagoBI launches OutOfMemoryExceptions
- SpagoBI doesn't crash but stops processing requests, i.e. new
- Knowage launches OutOfMemoryExceptions
- Knowage doesn't crash but stops processing requests, i.e. new
requests "hang" as they never receive a response.

You can verify these situations also checking the log files of Tomcat.

The solution to this problem is [restarting SpagoBI](https://github.com/SpagoBILabs/SpagoBI/tree/master/doc/admin#how-to-start-and-stop-spagobi-server).
The solution to this problem is [restarting SpagoBI](https://github.com/KnowageLabs/Knowage-Server/tree/master/doc/admin#how-to-start-and-stop-spagobi-server).

[Top](#top)

## I/O Flows

SpagoBI uses the following flows:
Knowage uses the following flows:

* Using TCP port 8080, default port of Tomcat Application Server
* From SpagoBI to MySQL database. In the case of running MySQL in the same host as the broker, this is an internal flow (i.e. using the loopback interface). The standard port in MySQL is 3306 although that can be changed in the configuration.
* From SpagoBI to external data sources. SpagoBI cqn query external data (REST services, external database connected with JDBC, CKAN portal)
* From Knowage to MySQL database. In the case of running MySQL in the same host as the broker, this is an internal flow (i.e. using the loopback interface). The standard port in MySQL is 3306 although that can be changed in the configuration.
* From Knowage to external data sources. SpagoBI cqn query external data (REST services, external database connected with JDBC, CKAN portal)

[Top](#top)

0 comments on commit 2d95ee5

Please sign in to comment.