The whole installation process is being done offline, therefore, it is recommended to go through this quick start guide before installing Transporter on your computer/laptop. Follow the Please follow these four simple steps to install begin using Perifery Transporter:
| Table of Contents | ||||
|---|---|---|---|---|
|
In the box
The following items are present:
The Perifery Transporter device
A License USB key
A sheet with information about connecting to the device
Step 1
...
Connect the Transporter device and your computer/laptop with the DHCP switch. Turn the power of Transporter device on, which will advertise the hostname on Port 9010 and provides browser access over the same network.
Step 2: Login into Perifery
...
Enter the default username shared with Perifery.
Enter the password shared by Perifery team. This is only for onboarding users.
Click Login.
...
: 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 is a one-time update for onboarding users as default credentials are the same for all the onboarding users. 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.
...
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 saying that ‘Password updated successfully’.
Step 4: Dashboard
The dashboard screen provides:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
Status overview – Provides the current state of hardware (all the disks and drives) and services are up and running. If any hardware or services are down, the status overview will provide that information.
...
CPU, RAM, network, and disks) and Perifery Transporter services.
- Shows all the hardware/services are working fine.❗ – This status shows Shows all the hardware/services are not up and running as expected.
Storage
...
This section provides – Provides the total storage space information of the device and how much space has been consumed . Also, the user will see a bar view of consumed space out of the total space available.
...
How to Connect
Copy Access URLs and Tokens
There are two ways in a bar format.
How to connect
This section is used 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 to move content into the Transporter.
Copy access URLs and tokens one by one and save them into a notepad.
| Info |
|---|
By default, the S3 secret key is not visible. To view, click on the eye icon and copy the S3 secret key. |
How to upload content using S3?
Launch Cyberduck and click Open Connection.
Choose Amazon S3 from the dropdown list of protocols.
Fill in the following fields:
Server – The hostname of the Perifery S3 endpoint URL.
Port – A port in the Perifery S3 endpoint URL.
Access Key ID – The Perifery S3 Access Key.
Secret Access Key – The Perifery S3 Secret Key.
Verify that the URL in Cyberduck matches the Perifery S3 Endpoint URL (it is okay if the port is not shown in the Cyberduck URL).
Click Connect to connect to the default Perifery S3 endpoint.
Browse to the target S3 bucket in Cyberduck.
Data Migration
You can move the bucket content to the desired remote location by following the below steps:
...
Click on the Move icon corresponding to the bucket. It displays a form in the sliding panel.
...
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.
...
| Info |
|---|
Once the content has been moved to the remote location, Move icon gets disabled corresponding to the source location row as it is now empty. |
Report Generation
...
If the report is generated for the failed data migration, then it gives the reason for the failure.
...
Click Download. It generates the bucket content report in JSON.
| Info |
|---|
The Report icon gets disabled once the data is migrated and the report is generated. |
View Content Portal
...
Go to the Manage Content section and click Manage Content. This will navigate to the Content Portal to view all the . 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, select Change Password. It displays a form to update the 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.