[DRAFT] Transporter - Quick Start Guide

Please follow these four simple steps to begin using Transporter:

In the Box

The following items should be present:

• The Transporter device

• A USB key

• A sheet with information about connecting to the device

Step 1: Set up

The whole setup needs three steps:

1. Plugin the USB key into the Transporter device.

2. Plug the Transporter device and computer/laptop into the same network switch.

3. Power on the device. Now, the device will be accessible via the network. Consult the sheet that came with the device for the URL to enter into your browser to view the console. For example, the URL is http://frankenporter.local:9010/ui.

Step 2: Login

1. Enter the default username and password available on the sheet that came with the device.

   1. Username – periferyadmin

   2. Password – password

2. Click Login.

Step 3: Update your password

This is a one-time update for the first-time login user.

1. Enter the new password and re-enter it to confirm.

   

2. Click Update password.
   A confirmation message appears saying that ‘Password updated successfully’.

Step 4: Dashboard

The dashboard screen provides:

Status overview

The status overview provides the current state of hardware (CPU, RAM, network, and disks) and transporter services.

• - Shows all the hardware/services are working fine.

• ❗ – Shows all the hardware/services are not up and running as expected.

Storage

This section provides the total storage space of the device and how much space has been consumed in a bar format.

How to connect

Copy access URLs and tokens

Access URLs and tokens will be used later to perform the Move operation, so save them in a text document.

Choose either option to copy:

• Click to copy everything in one go.

• Click to copy one by one.

How to upload content using S3?

Cyberduck is being used for illustrative purposes, but the same information may be used for any application that uses an S3 connection.

1. Launch Cyberduck and click Open Connection.

   

2. Choose Amazon S3 from the dropdown list of protocols.

   

3. 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).

4. Click Connect.

5. Browse to the target S3 bucket in Cyberduck.

View Content Portal

Go to Advanced > click Manage content. It navigates to the Content Portal to view all the content (bucket, objects, etc.).

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:

1. Click corresponding to the bucket. It displays a form in the sliding panel.

   

2. Fill in the required fields marked with asterisks (*):

   1. S3 endpoint URL – A target S3 endpoint URL.

   2. S3 region – A geographic area of the storage.

   3. S3 bucket – A target S3 bucket where the content is to be moved.

   4. Remote folder – A folder path within the remote bucket.

   5. Access key – An access key for the remote bucket. It must be generated within the remote cloud storage service.

   6. Secret key – An S3 secret key that is generated with the access key.

3. Click Move. A confirmation message appears.

   

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:

1. Click corresponding to the bucket.

   1. 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.

      

   2. 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.

      

2. 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.

User Profile

1. Click on periferyadmin at the top right corner. It shows two options, Change password and Logout.

   

2. To change the password, select Change password.

   

   1. Enter the current password.

   2. Enter a new password.

   3. Re-enter the new password in Confirm password field.

   4. Click Save. A confirmation message appears saying that ‘Password changed successfully'.

3. Click Logout to sign out of the account.