{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"70%"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"text":"Discovery Environment ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"tools","type":"text","marks":[{"type":"strong"},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" are ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":"Docker images","type":"text","marks":[{"type":"link","attrs":{"href":"https://cyverse.atlassian.net/wiki/spaces/DEmanual/pages/242027007"}},{"type":"textColor","attrs":{"color":"#000000"}}]},{"text":" from which apps are created. There are numerous tools already available in the DE for new apps you are creating. It's easiest to just use one of those tools. However, sometimes the tool or version isn't available, so you can request installation of a new tool or create a new one yourself. If you create a new tool, it is available by default in your personal Tools list and available only for your use. You can share the tool with specific collaborators, or make it public (all tools created prior to the 2.13 release in June 2017 are public). ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"paragraph","content":[{"text":"You can edit and delete a tool you own, as well as jump-start the creation of a new app from the Tools window. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Managing Tools","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Adding a tool and Requesting a tool","type":"text"}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"Adding or Requesting a New Tool","type":"text","marks":[{"type":"link","attrs":{"href":"https://cyverse.atlassian.net/wiki/spaces/DEmanual/pages/242027036"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Editing a tool","type":"text"}]},{"type":"paragraph","content":[{"text":"For tools you created, you can edit the tool name, description, version, and Docker Hub URL. The image name and tag are not editable after the tool has been created.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the tool you own that you want to edit.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Tools","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the image name, description of the tool, version, and/or Docker Hub URL as needed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When done, click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Deleting a tool","type":"text"}]},{"type":"paragraph","content":[{"text":"You can delete a tool you created.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the tool you own that you want to delete.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Tools","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Delete","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Yes ","type":"text","marks":[{"type":"strong"}]},{"text":"to verify you want to delete the tool.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"anchor","parameters":{"macroParams":{"":{"value":"UseToolCreateApp"},"legacyAnchorId":{"value":"ManagingToolsintheDE-UseToolCreateApp"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Anchor"}}}},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"show-if","parameters":{"macroParams":{"atlassian-macro-output-type":{"value":"INLINE"},"group":{"value":"Staff"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"show-if"}}},"content":[{"type":"paragraph","content":[{"type":"status","attrs":{"color":"green","style":"bold","text":"Anchor"}},{"text":" ","type":"text"},{"text":"Anchor = UseToolCreateApp (visible only to Staff)","type":"text","marks":[{"type":"strong"},{"type":"em"},{"type":"textColor","attrs":{"color":"#339966"}}]}]}]}],"version":1},"cxhtml":"INLINEStaff

GreenAnchor Anchor = UseToolCreateApp (visible only to Staff)

"}}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using a tool to create an app","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you've found the tool to use in an app you want to create, you can \"jump-start\" the creation of a new app right from the Tools menu.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the tool to use for the new app.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Tools","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Use in app","type":"text","marks":[{"type":"strong"}]},{"text":". The Create App window opens with the tool selected.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Continue to ","type":"text"},{"text":"Creating a New App Interface","type":"text","marks":[{"type":"link","attrs":{"href":"https://cyverse.atlassian.net/wiki/spaces/DEmanual/pages/242027118"}}]},{"text":" for instructions on how to create the new app.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Sharing tools","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have created a tool, by default, it is private and available only for your personal use. You can share it with selected collaborators or make the tool public (the default for all tools created prior to the 2.13 release). You also can edit and delete a tool you created that is in Own status. Giving Own access allows the collaborator to share, edit, and delete the tool, so grant this permission with care.","type":"text"}]},{"type":"paragraph","content":[{"text":" Before a new app can be created, the tool that app is based on must be made available in the DE.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sharing a tool with a collaborator","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the tool you own that you want to share.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Share","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Share with collaborators","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select a user in your ","type":"text"},{"text":"Collaborators list","type":"text","marks":[{"type":"link","attrs":{"href":"https://pods.iplantcollaborative.org/wiki/display/DEmanual/Adding+and+Deleting+Users+from+the+Collaborators+List+in+Preferences"}}]},{"text":": Click ","type":"text"},{"text":"Choose Collaborators","type":"text","marks":[{"type":"strong"}]},{"text":", select the user, click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":", and then click ","type":"text"},{"text":"Done","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"To add a new collaborator, click in the search field, begin entering the user's name, and then click the user's name from the list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To change the collaborator's permission level, click the ","type":"text"},{"text":"Permissions","type":"text","marks":[{"type":"strong"}]},{"text":" down arrow and change the permission.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repeat for each collaborator.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Done","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Sharing a tool with the public","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the tool you own that you want to share with the public.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Share","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Make public","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This opens a form which you will need to fill it up and click ","type":"text"},{"text":"Submit","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will receive email notifications as the tool progresses through the process of making it public.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Unsharing a tool","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Apps window, click ","type":"text"},{"text":"Manage Tools ","type":"text","marks":[{"type":"strong"}]},{"text":"at the top and then click to select the tool to unshare.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Share","type":"text","marks":[{"type":"strong"}]},{"text":" menu and then click ","type":"text"},{"text":"Share with collaborators","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Find the collaborator and click","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":16,"widthType":"pixel"},"content":[{"type":"media","attrs":{"type":"external","url":"https://pods.iplantcollaborative.org/wiki/download/thumbnails/11439710/X-icon.jpg?version=1&modificationDate=1484935825000&api=v2"}}]},{"type":"paragraph","content":[{"text":" to the right of the collaborator's name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Done","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"30%"}},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"SteelBlue","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Helpful Links","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ffffff"}},{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"WhiteSmoke","rowspan":1},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"On this page:","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"schemaVersion":{"value":"1"},"title":"Table of Contents"}}}},{"type":"paragraph","content":[{"text":"Related pages:","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Adding or Requesting a New Tool","type":"text","marks":[{"type":"link","attrs":{"href":"https://cyverse.atlassian.net/wiki/spaces/DEmanual/pages/242027036"}}]}]}]}]}]}]}]}]}],"version":1}

Managing Tools in the DE