Start using Pixiu#
You can start using Pixiu once you have your Requesting Access and Creating a Bucket activated. To access a bucket located in Pixiu, you need to connect through a client application that supports the Amazon S3 protocol. There are many options on the market. We provide support for the solutions described here below. We recommend to use the VUB Pixiu Drive as it is the easiest solution.
In general for any client, you need the following info:
the hostname is pixiu.vub.be.
both path style and DNS style are supported.
both signature v2 and v4 are supported but preferably you use v4.
VUB Pixiu Drive#
VUB Pixiu Drive is a VUB branded version of Mountain Duck. It includes a license and a custom profile to connect to Pixiu. Once it is installed and configured, a link to your Pixiu resources will appear in the file browser of your system.
Download#
Go to VUB Softweb
Scroll down the page until you see VUB Pixiu Drive and click on it.
Note
Alternatively, you can find VUB Pixiu Drive also in the Company Portal App on your desktop and directly install it from there.
The description page of VUB Pixiu Drive will open. Read it and under Instructions, click on VUB - Sharepoint to download it.
Once the download page opens, pick the file corresponding to the operating system in your computer:
MS Windows: download the file with the
.msi
extensionApple macOS: download the file with the
.pkg
extension
Installation#
Download the VUB Pixiu Drive for macOs from VUB Softweb
Open the VUB Pixiu Drive pkg file by double clicking
Click Continue
Click Install
You will need to use Touch ID or provide your password
Your VUB Pixiu Drive client is now installed! You can close the installer.
Move the installer to the Trash
Download the VUB Pixiu Drive for Windows from VUB Softweb
Open the VUB Pixiu Drive msi file by double clicking
Click Yes to install
The VUB Pixiu Drive client is now being installed. There is no notification after the installation.
You can now open the VUB Pixiu Drive client
Configuring the client#
This will guide you through the configuration of the VUB Pixiu Drive client.
Open the VUB Pixiu Drive client from Applications, a VUB icon will appear in the Menu Bar at the top of the screen.
Note
If you have a lot of icons it is possible that the VUB Pixiu Drive icon is hidden, try changing to an app with less menu items at the top (like Firefox)
Click on the VUB icon in the Menu Bar and then on Open Connection
Complete the profile and add your Access Key and Secret Access Key
Click Connect
Note
Make sure you are on campus or connected through the VPN of VUB, otherwise it is not possible to connect to Pixiu.
Optional You can add the secret to your keychain when prompted
The VUB Pixiu Drive will now have mounted a new location in Finder
Your client is now configured, you can see all the buckets in your account.
Open the VUB Pixiu Drive client from the start menu, a VUB icon will appear in the Task Bar at the bottom of the screen.
If you have a lot of icons it is possible that the VUB Pixiu Drive icon is hidden, click on the little arrow to show all the icons
Click on the VUB icon in the Task Bar and then on Open Connection
Complete the profile and add your Access Key and Secret Access Key
Click Connect
Note
Make sure you are on campus or connected through the VPN of VUB, otherwise it is not possible to connect to Pixiu.
The VUB Pixiu Drive will now have mounted a new drive location in windows explorer
Your client is now configured, you can see all the buckets in your account.
Cyberduck#
The Cyberduck installer is a custom version of Cyberduck. It includes a license and a custom profile to connect to Pixiu.
Download#
We provide a custom installer of Cyberduck on VUB Softweb
Click on Cyberduck
Note
Alternatively, you can find Cyberduck also in the Company Portal App on your desktop and directly install it from there.
The description page of Cyberduck will open. Read it and under Instructions, click on VUB - Sharepoint to download it.
Once the download page opens, pick the file corresponding to the operating system in your computer:
MS Windows: download the file with the
.msi
extensionApple macOS: download the file with the
.pkg
extension
Installation#
Download Cyberduck from VUB Softweb
Open the Cyberduck pkg file by right clicking on the installer and selecting open
Click Continue
Click Install
You will need to use Touch ID or provide your password
Your Cyberduck client is now installed! You can close the installer.
Download Cyberduck from VUB Softweb
Open the Cyberduck msi file by double clicking
Click Yes to install (the publisher is unknown because we made modifications to the installer ourselves)
The Cyberduck client is now being installed. There is no notification after the installation.
You can now open the Cyberduck client
Configuring the client#
This will guide you through the configuration of the custom Cyberduck client.
Open the Cyberduck client from Applications
Click Open when asked if you want to open an app that has been downloaded from the internet
Click Open Connection
Click on the protocol list
Select VUB Pixiu at the bottom of the list (you may need to scroll down)
Complete the profile and add your Access Key and Secret Access Key
Click Connect
Note
Make sure you are on campus or connected through the VPN of VUB, otherwise it is not possible to connect to Pixiu.
Optional You can add the secret to your keychain when prompted
Your client is now configured, you can see all the buckets in your account.
Open the Cyberduck client from the start menu
The first time you open the client, it might take some time to start up
Click Open Connection
Click on the protocol list
Select VUB Pixiu at the bottom of the list (you may need to scroll down)
Complete the profile and add your Access Key and Secret Access Key
Click Connect
Note
Make sure you are on campus or connected through the VPN of VUB, otherwise it is not possible to connect to Pixiu.
Your client is now configured, you can see all the buckets in your account.
S3cmd#
S3cmd is commandline tool to access S3 buckets. It is written in Python and can be used under Linux, Windows, Mac, … It is installed on Hydra for direct interaction between our HPC cluster and the Pixiu storage.
Installation#
As S3cmd is a multiplatform tool, the prefered installation may differ depending on your platform. The overview can be found at s3tools/s3cmd
But the most general and simple method is to use pip:
pip install s3cmd
Configuration#
The configuration settings of s3cmd have to be set in its configuration file. By default, it is located at ~/.s3cfg. The following configuration file contains the minimum settings needed by s3cmd to connect to Pixiu:
[default]
access_key = YOUR_ACCESS_KEY
secret_key = YOUR_SECRET_KEY
host_base = pixiu.vub.be
host_bucket = %(bucket)s.pixiu.vub.be
If you are using S3cmd on Hydra, we recommend to add the following lines to increase the (upload) speed:
multipart_chunk_size_mb = 256
Usage#
View all your buckets, run:
s3cmd ls s3://
View a specific bucket:
s3cmd ls s3://mybucket/sub_directory/
Download a file:
s3cmd get s3://mybucket/file.txt
Upload a file:
s3cmd put file.txt s3://mybucket