[ 
https://issues.apache.org/jira/browse/IGNITE-11838?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Dmitry Sherstobitov updated IGNITE-11838:
-----------------------------------------
    Description: 
I was trying to run UriDeploymentSPi feature and actually failed in it. I've 
only managed to stop it using the actual Java code.

Here some issues in documentation I've found:
1. Not clear what is GAR file and how user can create it (manually?, using some 
utility?)
2. Local disk folder containing only compiled Java classes - this doesn’t work 
for me (and according to java code this shouldn't work)
3. Local disk folder with structure of unpacked GAR file - this DOES work but. 
META-INF/ actually is an optional folder, xyz.class -see previous). The only 
thing user need is to put lib/ folder in deployment URI and put .jar file there
4. Doesn’t clear what is ignite.xml descriptor file. How user can create it
5. I don’t like windows paths in examples (I think linux paths is more common 
in case of Ignite, we may create Note with Windows paths examples)
6. In case of Linux path user should write something like this: 
file:///tmp/path/deployment (3 slashes instead of 2)
7. 
https://apacheignite.readme.io/docs/service-grid-28#section-service-updates-redeployment
 - here link to URI looks strange and doesn’t work
8. Previous page: example temporaryDirectoryPath value is optional so we may 
remove it

  was:
I was trying to run UriDeploymentSPi feature and actually failed in it. I've 
only managed to stop it sung Java code.

Here some issues in documentation I've found:
1. Not clear what is GAR file and how user can create it (manually?, using some 
utility?)
2. Local disk folder containing only compiled Java classes - this doesn’t work 
for me (and according to java code this shouldn't work)
3. Local disk folder with structure of unpacked GAR file - this DOES work but. 
META-INF/ actually is an optional folder, xyz.class -see previous). The only 
thing user need is to put lib/ folder in deployment URI and put .jar file there
4. Doesn’t clear what is ignite.xml descriptor file. How user can create it
5. I don’t like windows paths in examples (I think linux paths is more common 
in case of Ignite, we may create Note with Windows paths examples)
6. In case of Linux path user should write something like this: 
file:///tmp/path/deployment (3 slashes instead of 2)
7. 
https://apacheignite.readme.io/docs/service-grid-28#section-service-updates-redeployment
 - here link to URI looks strange and doesn’t work
8. Previous page: example temporaryDirectoryPath value is optional so we may 
remove it


> Improve usability of UriDeploymentSpi documentation 
> ----------------------------------------------------
>
>                 Key: IGNITE-11838
>                 URL: https://issues.apache.org/jira/browse/IGNITE-11838
>             Project: Ignite
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 2.7
>            Reporter: Dmitry Sherstobitov
>            Priority: Critical
>
> I was trying to run UriDeploymentSPi feature and actually failed in it. I've 
> only managed to stop it using the actual Java code.
> Here some issues in documentation I've found:
> 1. Not clear what is GAR file and how user can create it (manually?, using 
> some utility?)
> 2. Local disk folder containing only compiled Java classes - this doesn’t 
> work for me (and according to java code this shouldn't work)
> 3. Local disk folder with structure of unpacked GAR file - this DOES work 
> but. META-INF/ actually is an optional folder, xyz.class -see previous). The 
> only thing user need is to put lib/ folder in deployment URI and put .jar 
> file there
> 4. Doesn’t clear what is ignite.xml descriptor file. How user can create it
> 5. I don’t like windows paths in examples (I think linux paths is more common 
> in case of Ignite, we may create Note with Windows paths examples)
> 6. In case of Linux path user should write something like this: 
> file:///tmp/path/deployment (3 slashes instead of 2)
> 7. 
> https://apacheignite.readme.io/docs/service-grid-28#section-service-updates-redeployment
>  - here link to URI looks strange and doesn’t work
> 8. Previous page: example temporaryDirectoryPath value is optional so we may 
> remove it



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to