The whole installation process is being done offline, therefore, it is recommended to go through this quick start guide. Follow the Please follow these four simple steps to begin using Perifery Transporter:
| Table of Contents | ||||
|---|---|---|---|---|
|
Step 1: Connect the Transporter
...
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: 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 saying that ‘Password updated successfully’.
Step 4: Dashboard
The dashboard screen provides:
| Table of Contents | ||||
|---|---|---|---|---|
|
...
Status overview
...
Status overview – Provides the current state of hardware (CPU, RAM, network, and disks) and Perifery Transporter services.
- This status shows 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 of the device and how much space has been consumed . A bar view shows consumed space out of the total space availablein a bar format.
How to connect
Copy access URLs and tokens
There are two ways 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 in a text document. These details will be used to move content into the Transporter.
Copy access URLs and tokens one by one and save them.
| 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?
Cyberduck is being used for illustrative purposes, but . 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.
...
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.
...
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
...
Go to Advanced > Manage content section. Click Manage content, which navigates to the Content Portal to view all the 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.).
To learn more about functionalities like bucket, object, domain, and how to use them, see Using the Content UI. To know about how to configure and utilize these capabilities, see Swarm Content UI.
For Transporter users, the documentation provided above will help you safely store content in no time.
| Info |
|---|
The UI skin of the Content Portal has been improved so you will experience skin difference in images used in the documents. |
Data migration
This section provides a way to move bucket content to a remote S3 destination.
...
Move bucket
To move a bucket, refer to the following 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 region – Enter the S3 region, which is a geographic area of the storage if required by the remote storage vendor.
S3 bucket – Enter the target S3 bucket where the content is to be moved.
Remote folder – Enter the folder path within the remote bucket. This is optional.
Access key – Enter an access key for the remote bucket. It must be generated within the remote cloud storage service.
Secret key – Enter 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 the source bucket contains only objects describing the move operation and results.
Report generation
When data is moved irrespective of whether it is failed or successful, the report icon gets enabled for that bucket.
Refer to the following steps to generate a report:
...
Scenario 1: When data is migrated successfully and the report is generated, all the objects available in the selected bucket are displayed along with their object name and object status. It gives a preview of the bucket content report.
Scenario 2: When the data migration is failed for a bucket and the report is generated, it shows the reason for the data migration failure.
...
Click Download. It will either download or pop up in a browser tab depending on how the browser handles the content type of the JSON file.
| Info |
|---|
The Download button remains disabled for failed bucket data migration. For successfull data migration, Download button remains enabled. |
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.
Re-enter the new password in Confirm password field.
Click Save. A confirmation message appears saying that ‘Password changed successfully'.
...
Navigate to Advanced > Content Management > click Manage Content. This will 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.