You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@synapse.apache.org by "Evanthika Amarasiri (JIRA)" <ji...@apache.org> on 2008/05/09 07:48:55 UTC

[jira] Created: (SYNAPSE-299) Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"

Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"
------------------------------------------------------------------------------------------------------

                 Key: SYNAPSE-299
                 URL: https://issues.apache.org/jira/browse/SYNAPSE-299
             Project: Synapse
          Issue Type: Bug
          Components: Documentation
    Affects Versions: 1.2-QA-B1
         Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
            Reporter: Evanthika Amarasiri


Issue 1
=====
In the Synapse_Samples_Setup.html under the heading "Setting up Derby database server", the commands you have given to create connections, databases and tables are not very clear. Make them bold and stand out and show the commands clearly to the user. Make sure that the extra numbers which are there for the steps are also removed.

Issue 2
====
Also under the heading "Setting up Synapse DataSources", you have said "Please follows the above (Setting up Derby Database server) section and setup database for 'jdbc:derby://localhost:1527/lookupdb' and 'jdbc:derby://localhost:1527/reportdb' using user name and password as 'synapse'." but this does not give a clear meaning for the user that he should also create the tables and insert the data as well. Therefore clearly state that the user should create two databases and also he/she should create the tables and insert the data as well.

Issue 3
=====
In addition under Sample 363 in the Synapse_Samples.html when you say "Prerequisites: Setting up DataBase and DataSources according to the sample setup guide." specify the link to the Samples_Setup.html here.

Issue 4
=====
Another issue that I found out was that in the same sample, the way that you have asked the user to start the sample is invalid. You have given it as "synapse -sample 3623". Please correct this as well.

Don't just say "Then the console output". Please rephrase this. Also without just giving out the console output as

INFO LogMediator text = ** Looking up from the Database **
      ...
      ID - c1
      ...
      INFO LogMediator text = ** Reporting to the Database **
      INFO LogMediator text = ** Looking up from the Database **
      INFO LogMediator text = Stock price - 183.3635460215262

give it as follows

INFO LogMediator text = ** Looking up from the Database **
      ...
      ID - c1
      ...
      INFO LogMediator text = ** Reporting to the Database **
      ...
      INFO LogMediator text = ** Looking up from the Database **
      ...
      INFO LogMediator text = Stock price - 183.3635460215262
so that the user would know there are other logs being printed in between these lines.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@synapse.apache.org
For additional commands, e-mail: dev-help@synapse.apache.org


[jira] Resolved: (SYNAPSE-299) Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"

Posted by "Ruwan Linton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/SYNAPSE-299?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ruwan Linton resolved SYNAPSE-299.
----------------------------------

    Resolution: Fixed

Fixed on the 1.2 branch.

> Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"
> ------------------------------------------------------------------------------------------------------
>
>                 Key: SYNAPSE-299
>                 URL: https://issues.apache.org/jira/browse/SYNAPSE-299
>             Project: Synapse
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 1.2-QA-B1
>         Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
>            Reporter: Evanthika Amarasiri
>            Assignee: Ruwan Linton
>             Fix For: 1.2
>
>
> Issue 1
> =====
> In the Synapse_Samples_Setup.html under the heading "Setting up Derby database server", the commands you have given to create connections, databases and tables are not very clear. Make them bold and stand out and show the commands clearly to the user. Make sure that the extra numbers which are there for the steps are also removed.
> Issue 2
> ====
> Also under the heading "Setting up Synapse DataSources", you have said "Please follows the above (Setting up Derby Database server) section and setup database for 'jdbc:derby://localhost:1527/lookupdb' and 'jdbc:derby://localhost:1527/reportdb' using user name and password as 'synapse'." but this does not give a clear meaning for the user that he should also create the tables and insert the data as well. Therefore clearly state that the user should create two databases and also he/she should create the tables and insert the data as well.
> Issue 3
> =====
> In addition under Sample 363 in the Synapse_Samples.html when you say "Prerequisites: Setting up DataBase and DataSources according to the sample setup guide." specify the link to the Samples_Setup.html here.
> Issue 4
> =====
> Another issue that I found out was that in the same sample, the way that you have asked the user to start the sample is invalid. You have given it as "synapse -sample 3623". Please correct this as well.
> Don't just say "Then the console output". Please rephrase this. Also without just giving out the console output as
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       INFO LogMediator text = ** Looking up from the Database **
>       INFO LogMediator text = Stock price - 183.3635460215262
> give it as follows
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       ...
>       INFO LogMediator text = ** Looking up from the Database **
>       ...
>       INFO LogMediator text = Stock price - 183.3635460215262
> so that the user would know there are other logs being printed in between these lines.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@synapse.apache.org
For additional commands, e-mail: dev-help@synapse.apache.org


[jira] Updated: (SYNAPSE-299) Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"

Posted by "Ruwan Linton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/SYNAPSE-299?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ruwan Linton updated SYNAPSE-299:
---------------------------------

    Fix Version/s: 1.2

need to fix this for the 1.2 release

> Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"
> ------------------------------------------------------------------------------------------------------
>
>                 Key: SYNAPSE-299
>                 URL: https://issues.apache.org/jira/browse/SYNAPSE-299
>             Project: Synapse
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 1.2-QA-B1
>         Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
>            Reporter: Evanthika Amarasiri
>             Fix For: 1.2
>
>
> Issue 1
> =====
> In the Synapse_Samples_Setup.html under the heading "Setting up Derby database server", the commands you have given to create connections, databases and tables are not very clear. Make them bold and stand out and show the commands clearly to the user. Make sure that the extra numbers which are there for the steps are also removed.
> Issue 2
> ====
> Also under the heading "Setting up Synapse DataSources", you have said "Please follows the above (Setting up Derby Database server) section and setup database for 'jdbc:derby://localhost:1527/lookupdb' and 'jdbc:derby://localhost:1527/reportdb' using user name and password as 'synapse'." but this does not give a clear meaning for the user that he should also create the tables and insert the data as well. Therefore clearly state that the user should create two databases and also he/she should create the tables and insert the data as well.
> Issue 3
> =====
> In addition under Sample 363 in the Synapse_Samples.html when you say "Prerequisites: Setting up DataBase and DataSources according to the sample setup guide." specify the link to the Samples_Setup.html here.
> Issue 4
> =====
> Another issue that I found out was that in the same sample, the way that you have asked the user to start the sample is invalid. You have given it as "synapse -sample 3623". Please correct this as well.
> Don't just say "Then the console output". Please rephrase this. Also without just giving out the console output as
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       INFO LogMediator text = ** Looking up from the Database **
>       INFO LogMediator text = Stock price - 183.3635460215262
> give it as follows
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       ...
>       INFO LogMediator text = ** Looking up from the Database **
>       ...
>       INFO LogMediator text = Stock price - 183.3635460215262
> so that the user would know there are other logs being printed in between these lines.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@synapse.apache.org
For additional commands, e-mail: dev-help@synapse.apache.org


[jira] Assigned: (SYNAPSE-299) Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"

Posted by "Ruwan Linton (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/jira/browse/SYNAPSE-299?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Ruwan Linton reassigned SYNAPSE-299:
------------------------------------

    Assignee: Ruwan Linton

> Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"
> ------------------------------------------------------------------------------------------------------
>
>                 Key: SYNAPSE-299
>                 URL: https://issues.apache.org/jira/browse/SYNAPSE-299
>             Project: Synapse
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 1.2-QA-B1
>         Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
>            Reporter: Evanthika Amarasiri
>            Assignee: Ruwan Linton
>             Fix For: 1.2
>
>
> Issue 1
> =====
> In the Synapse_Samples_Setup.html under the heading "Setting up Derby database server", the commands you have given to create connections, databases and tables are not very clear. Make them bold and stand out and show the commands clearly to the user. Make sure that the extra numbers which are there for the steps are also removed.
> Issue 2
> ====
> Also under the heading "Setting up Synapse DataSources", you have said "Please follows the above (Setting up Derby Database server) section and setup database for 'jdbc:derby://localhost:1527/lookupdb' and 'jdbc:derby://localhost:1527/reportdb' using user name and password as 'synapse'." but this does not give a clear meaning for the user that he should also create the tables and insert the data as well. Therefore clearly state that the user should create two databases and also he/she should create the tables and insert the data as well.
> Issue 3
> =====
> In addition under Sample 363 in the Synapse_Samples.html when you say "Prerequisites: Setting up DataBase and DataSources according to the sample setup guide." specify the link to the Samples_Setup.html here.
> Issue 4
> =====
> Another issue that I found out was that in the same sample, the way that you have asked the user to start the sample is invalid. You have given it as "synapse -sample 3623". Please correct this as well.
> Don't just say "Then the console output". Please rephrase this. Also without just giving out the console output as
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       INFO LogMediator text = ** Looking up from the Database **
>       INFO LogMediator text = Stock price - 183.3635460215262
> give it as follows
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       ...
>       INFO LogMediator text = ** Looking up from the Database **
>       ...
>       INFO LogMediator text = Stock price - 183.3635460215262
> so that the user would know there are other logs being printed in between these lines.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@synapse.apache.org
For additional commands, e-mail: dev-help@synapse.apache.org


[jira] Commented: (SYNAPSE-299) Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"

Posted by "Evanthika Amarasiri (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/jira/browse/SYNAPSE-299?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12606674#action_12606674 ] 

Evanthika Amarasiri commented on SYNAPSE-299:
---------------------------------------------

Issue 1, 2 and 3 are fixed. But there is a small issue in issue 3. Will it be possible to point to the proper location of the "Sample setup guide.html". Also in issue 4 "Then the console output" should be rephrased. Please fix these two issues

> Documentation issue regarding "Setting up Synapse Datasources" and " Setting up Derby database server"
> ------------------------------------------------------------------------------------------------------
>
>                 Key: SYNAPSE-299
>                 URL: https://issues.apache.org/jira/browse/SYNAPSE-299
>             Project: Synapse
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 1.2-QA-B1
>         Environment: Ubuntu 7.10, Java version "1.5.0_14", Firefox2.0.0.12
>            Reporter: Evanthika Amarasiri
>            Assignee: Ruwan Linton
>             Fix For: 1.2
>
>
> Issue 1
> =====
> In the Synapse_Samples_Setup.html under the heading "Setting up Derby database server", the commands you have given to create connections, databases and tables are not very clear. Make them bold and stand out and show the commands clearly to the user. Make sure that the extra numbers which are there for the steps are also removed.
> Issue 2
> ====
> Also under the heading "Setting up Synapse DataSources", you have said "Please follows the above (Setting up Derby Database server) section and setup database for 'jdbc:derby://localhost:1527/lookupdb' and 'jdbc:derby://localhost:1527/reportdb' using user name and password as 'synapse'." but this does not give a clear meaning for the user that he should also create the tables and insert the data as well. Therefore clearly state that the user should create two databases and also he/she should create the tables and insert the data as well.
> Issue 3
> =====
> In addition under Sample 363 in the Synapse_Samples.html when you say "Prerequisites: Setting up DataBase and DataSources according to the sample setup guide." specify the link to the Samples_Setup.html here.
> Issue 4
> =====
> Another issue that I found out was that in the same sample, the way that you have asked the user to start the sample is invalid. You have given it as "synapse -sample 3623". Please correct this as well.
> Don't just say "Then the console output". Please rephrase this. Also without just giving out the console output as
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       INFO LogMediator text = ** Looking up from the Database **
>       INFO LogMediator text = Stock price - 183.3635460215262
> give it as follows
> INFO LogMediator text = ** Looking up from the Database **
>       ...
>       ID - c1
>       ...
>       INFO LogMediator text = ** Reporting to the Database **
>       ...
>       INFO LogMediator text = ** Looking up from the Database **
>       ...
>       INFO LogMediator text = Stock price - 183.3635460215262
> so that the user would know there are other logs being printed in between these lines.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@synapse.apache.org
For additional commands, e-mail: dev-help@synapse.apache.org