Nextcloud

Overview

On Genkai, you can access the shared storage (Lustre) using Nextcloud.
It is possible to operate files and folders on the shared storage from a web browser.

The browsers supported by Nextcloud are as follows.

  • Google Chrome/Chromium
  • Mozilla Firefox
  • Apple Safari
  • Microsoft Edge

Preparation for use

To use Nextcloud, it is necessary to create a supercomputer account and set a password in advance.

Logging in and out of Nextcloud

First-time login

Nextcloud login

Access Nextcloud(https://genkai-nextcloud.hpc.kyushu-u.ac.jp/login) using a web browser, enter the "Supercomputer account" and "Password", and click "→Log in".

Two-factor authentication setup

When logging in for the first time, a screen will appear prompting you to set up two-factor authentication.
Click "TOTP (Authenticator app) Authenticate with TOTP app".

A QR code and setup code (TOTP secret key) will be displayed, so register them in the Authenticator app.
After registering, enter the authentication code displayed in the Authenticator app in the "Authentication code" field and click the "Verify" button.

If the verification result is that there is no problem with the authentication code, click "TOTP (Authenticator app) Authenticate with TOTP app".

Two-factor authentication

The authentication code screen will appear, so check the authentication code from the Authenticator app, enter it in the authentication code field, and click "Send".

If the initial screen appears, you have successfully logged in.
The maximum shared storage area will be displayed as "Genkai_Nextcloud".

Logging in for the second time and beyond

Nextcloud login

Access Nextcloud using a web browser, enter the "Supercomputer account" and "password", and click "→Login".

Two-factor authentication

The authentication code screen will appear, so check the authentication code from the Authenticator app, enter it in the authentication code field, and click "Send".

If the initial screen appears, the login was successful.
The maximum shared storage area will be displayed as "Genkai_Nextcloud".

Logging out

To log out, click the user icon in the top right of the screen and select "Log out" from the menu that appears.

Using Nextcloud

Accessing the shared storage

When logged into Nextcloud, the shared storage area will be displayed as "Genkai_Nextcloud".
The shared storage path is as follows.
/home/nextcloud/<group>/<user>
To access the shared storage, click on "Genkai_Nextcloud" to navigate to it and then perform the operation.

Uploading files and folders

Uploading by drag and drop

Move to the location where the files or folders will be uploaded, and drag the files or folders into the browser. A prompt will appear saying "Drag and drop files here to upload", so drag and drop the files or folders into the area to upload them.
Uploading will begin, and when the files or folders you dragged and dropped appear on the screen, the upload will be complete.

Uploading using the menu

Go to the location to upload to, click "+ New" at the top of the screen, and select "Upload files" from the menu to display the file reference menu. Select the files or folders to upload, and click "Open".
Uploading will begin, and when the selected files or folders are displayed on the screen, the upload will be complete.

Uploading files and folders

Downloading files and folders individually

To download a file or folder, click the "…" button on the right-hand side of the file or folder, and then select "Download" from the menu. If a folder is specified, it will be downloaded in zip archive format.

Downloading multiple files or folders

To download multiple files or folders, tick the checkboxes on the left-hand side of the files or folders to be downloaded, and then click the "Download" button at the top of the screen.

File and folder operations

Operations on individual files or folders

To rename, move, copy or delete a file or folder, click the "…" button on the right and select "Rename", "Move or copy", "Delete file" or "Delete folder" from the menu.

Operations on multiple files and folders

To move, copy or delete multiple files or folders, check the boxes on the left, and then select "Move or copy", "Delete files", "Delete folder" or "Delete (when both files and folders are selected)" from the menu at the top of the screen.

Sharing file and folder URLs

It is possible to share files and folders with people who do not have a Kanji-Kai account. Click the share icon to the right of the file or folder to be shared, and the "Share" menu will appear on the right. Click the "+" to the right of "Share by URL" to start sharing.

When sharing starts, the sharing link will be stored in the PC’s clipboard. It is possible to check the address by pasting it into a notepad or similar. In addition, by clicking the "…" mark displayed to the right of "Share by URL", it is possible to store the sharing link in the clipboard again. To end sharing, click the "…" mark displayed to the right of "Share by URL", and select "Unshare" from the menu. In addition, by selecting "Customize sharing", it is possible to make detailed settings for sharing.

The settings are shown below.

Item name Description
Set Password Set a password for opening the URL.
Set Expiration Date Set the expiration date (year/month/day) for sharing the URL.
Hide Download Button Do not display the "Download" button when opening the URL.
Note to Recipient Add a note to the recipient.
Custom Permissions Select the permissions available to the recipient from the following: [Read], [Edit], [Delete]

External Storage Integration

The following functions can be integrated as external storage integration.

  • SFTP - Amazon S3 - Nextcloud

To use the external storage integration function, click the user icon in the upper right corner of the screen and select "Settings".
Select "External Storage" from the settings menu.

SFTP Integration

When using external storage integration for SFTP, set the following items.
As an example, the following describes how to connect to the supercomputer login node (access to the home area).
After setting the following, access is possible by adding the displayed public key to the authorized?keys of your own.

Item name Description Login node connection
Folder name Set an arbitrary folder name. ←
External storage Select "SFTP". ←
Authentication Select the authentication method for the linked destination. RSA public key
Settings Description Login node connection
Host Set the host to connect to.
Root Set the directory path.
User name Set the user name. Supercomputer account
Public key The public key is displayed. Add to authorized?keys of the target user
Bit length Set the rsa bit length of the public key. 1024, 2048, 4096

Amazon S3 integration

When using external storage integration with Amazon S3, set the following items. The following describes how to connect to the supercomputer shared storage S3 integration as an example.

Item name Description Connection for Amazon S3 integration
Folder name Set an arbitrary folder name. ←
External storage Select "Amazon S3". ←
Authentication Select the authentication method for the connection destination. Access Key
Settings Description Login Node Connection
Bucket Name Set the bucket name. Bucket name created in shared storage.
Host Name Set the host name of the connection destination.
Port Set the destination port number. Leave blank (no input required)
Region Set the region. Leave blank (no input required)
Storage class Set the storage class. Leave blank (no input required)
Enable SSL Set whether or not to enable SSL. Check the box (Enable SSL)
Enable Path Format Set whether to enable or disable path format.
Enable Legacy Authentication (v2) Set whether to enable or disable legacy authentication (v2).
Enable Multi-part Copy Set whether to enable or disable multi-part copy.
Secret key Set the secret key. Obtained secret key

Nextcloud integration

When using external storage integration with Nextcloud, set the following items.

Item name Description
Folder name Set an arbitrary folder name.
External storage Select "Nextcloud".
Authentication Select the authentication method for the linked destination.
URL Set the connection destination URL.
Remote subfolder Set the Nextcloud folder to connect to as necessary (blank is also possible).
Secure https:// Set the https connection.
Username Set the username.
Password Set the password.