====== TapeTrack Slack App ====== The TapeTrack Slack App allows you to query tape libraries and move tapes from one location to another all from within [[https://slack.com/ | Slack]]. {{:extensions:slack_help.png?600|}} {{page>common:support}} ====== Prerequisites ====== - Active Slack Account - Open Data Protection API (ODPAPI) Adapter for TapeTrack or URL of an existing Adapter. - [[common:logon|TapeTrack credentials]]. ====== Connecting the App ====== To install the App simply click the App icon on the Slack app directory or by clicking the icon below. Add to Slack As all settings are set via /tapetrack commands, there is no need to interact outside of Slack during installation. ====== Security Considerations ====== When adding new adapters to your Slack profile, the following information will be securely stored on GazillaByte's Servers: - Adapter name. - Adapter URL - TapeTrack User-ID and password. Only the Slack user that sets these values will be able to use, list and delete this data. When listing adapters, the password will not be displayed to preserve security. When an adapter is added to your Slack profile, care should be taken to ensure that unauthorized users do not use your Slack account. ====== App Commands ====== ===== Adapters ===== Before you can use the TapeTrack Slack App you must first add at least one ODPAPI Adapter. ==== Adding an Adapter ==== === Syntax === /tapetrack adapter add name adapter_url === Example === /tapetrack adapter add TestBed http://testuser:testuser@testbed.tapetrack.com/dpapi-v1 ==== Listing Adapters ==== === Syntax === /tapetrack adapter list {{:extensions:slack_adapter_list.jpg}} ==== Deleting an Adapter ==== === Syntax === /tapetrack adapter delete name === Example === /tapetrack adapter delete TestBed ===== Libraries ===== ==== Listing Libraries ==== When listing libraries you can either query one of the adapters by name, or use a wildcard to match the closest adapter. === Syntax === /tapetrack name library list === Example === /tapetrack * library list {{:extensions:slack_library_list.jpg|}} In the returned list of accessible libraries you will get a library UUID along with the library description. The library UUID will be used to access that library and the tapes within it going forward. ==== Library Information ==== === Syntax === /tapetrack name library info library_uuid === Example === /tapetrack name library info 41553031-0000-0000-4c54-4f004f464653 {{:extensions:slack_library_info.jpg?}} At the bottom of the library info command button is a Show button. You can click this to list the tapes that belong to that library. ======Tapes====== ==== Listing Tapes ==== === Syntax === /tapetrack name object list library_uuid === Example === /tapetrack * object list 41553031-0000-0000-4c54-4f004f464653 {{:extensions:slack_object_list.jpg}} ==== Tape Information ==== === Syntax === /tapetrack name object info library_uuid tape_id === Example === /tapetrack * object info 41553031-0000-0000-4c54-4f004f464653 000002L4 {{:extensions:slack_object_info.jpg}} ====== Finding a tape ====== To find a tape you can use the whereis command. This will tell you which libraries a given tape can be found in. === Syntax === /tapetrack name whereis tape_id === Example === /tapetrack * whereis 000001L4 {{:extensions:slack_whereis.jpg}} ====== Help ====== To obtain help text run the help command. {{:extensions:slack_help_command.jpg}}