Please follow these four simple steps to begin using Perifery Transporter:
| Table of Contents | ||||
|---|---|---|---|---|
|
In the box
The whole setup is being done offline so it is advised to go through this quick start guide for setting up Transporter.
Step 1: Connect the device
Connect the ethernet cable with Transporter and your device to start the offline installation.
Step 2: Log into Perifery
Enter the email address and password.
Click Login.
Step 3: Update the password
Change the default password to a human-readable and memorable password. The new password must be between 8-64 characters including at least one uppercase, one lowercase, one number, and one special character.following items are present:
The Perifery Transporter device
A License USB key
A sheet with information about connecting to the device
Step 1: Set up
The whole setup needs three steps:
Plug the License USB key into the Perifery Transporter device.
Plug the device and computer/laptop into the same network switch.
Power on the device. The device will be accessible via the network and will start up. Consult the sheet that came with the device for the URL. Enter the same URL into the browser to view the console.
Boot
The boot process for Perifery Transporter can take a few minutes, depending on the amount of data stored. No user action is required.
...
A confirmation message displays when the boot is complete.
...
| Info |
|---|
Perifery Transporter performs these same steps on every boot. |
Step 2: Login
...
Enter the default username and password available on the sheet that came with the device.
Username – periferyadmin
Password – password
Click Login.
| Info |
|---|
Login will not be possible until all the services have fully come online. |
Step 3: Update your password
This step is applicable to the first-time login only.
Enter the new password and re-enter it again to confirm.
Click Update Password and Continuepassword.
A confirmation message appears that ‘Password changed updated successfully’.
Step 4: Dashboard
The dashboard screen provides:
Hardware and service status
Access URLs and tokens (S3 endpoint URL, bucket name, access key, and secret key)
List of configured buckets
A mechanism to move bucket content and report generation
Links to browse all content via Content Portal and to monitor system status on the Grafana dashboard
Links to third-party applications
Copy access URLs and tokens
There are two ways to copy access URLs and tokens:
To copy all (S3 endpoint URL, bucket name, access key, and secret key) in one go, click Copy All and save them into Notepad. These details will be used in the future while moving bucket content.
Copy access URLs and tokens one by one and save them into a notepad.
Move bucket content
Click on the Move icon corresponding to the bucket which you want to move to a remote S3 location.
A modal presents a form as shown in the example below:Fill up the required fields marked with asterisks (*):
S3 Endpoint URL – Enter the target S3 endpoint URL.
S3 Bucket – Enter the target S3 bucket where the content is to be moved.
Remote Folder – An optional folder path within the remote bucket.
Access Key – An access key for the remote bucket. It must be generated within the remote cloud storage service.
Secret Key – An S3 secret key. It is generated with the access key.
Click Move. A confirmation message appears.
The target remote bucket contains the content moved from the source, and now the source bucket is empty.
Report Generation
...
Click Download. It generates the bucket content report in JSON.
View Content Portal
...
Status overview – Provides the current state of hardware (CPU, RAM, network, and disks) and Perifery Transporter services.
- Shows all the hardware/services are working fine.❗ – Shows all the hardware/services are not up and running as expected.
Storage – Provides the total storage space of the device and how much space has been consumed in a bar format.
How to connect
This section is used to copy access URLs and tokens. Choose either option to copy and save access information in a text document or email:
Click
to copy everything in one go. Click
to copy one by one.
Use any S3 tool to upload content to Perifery Transporter. Here is an example of Cyberduck for illustrative purposes; the same information may be used for any application that uses an S3 connection.
...
For detailed information about how to connect to upload content to S3 using Cyberduck, see https://perifery.atlassian.net/wiki/spaces/DOCS/pages/3132293151/DRAFT+Transporter+User+Guide#How-to-connect.
View Content Portal
Another way to upload content to the Perifery Transporter is using Content Portal, which provides multiple functionalities to safely store and manage content (bucket, objects, etc.).
Monitor System Status
Go to the Status Details section and click View DashboardNavigate to Advanced > Content Management > click Manage Content. This will navigate to the Grafana dashboard where you can monitor the current status of the system.
User Profile
...
Go to the top-right corner of the screen and click on the username. It shows two options, Change Password and Logout.
...
To change the password:
Click Change Password.
Enter the current password.
Enter a new password and re-enter it again.
Click Change. A confirmation message appears saying that ‘Password changed successfully'.
...
open the Content Portal in a new browser tab. For more information about Content Portal, see Using the Content UI.
...
Data Migration
After successfully uploading content to Perifery Transporter, migrate it to any remote S3 destination. For step-by-step guidance, see https://perifery.atlassian.net/wiki/spaces/DOCS/pages/3132293151/DRAFT+Transporter+User+Guide#Data-migration.