Papp3

papp_cloud-3.6.10 使用手册 #

1 简介 #

papp_cloud 是一个登录超算的命令行工具，具备 ssh、scp、rsync、sftp、sshfs 的基础功能，支持 IPv4 和 IPv6 两种协议。

1.1 功能 #

  • login：登录并行云服务
  • logout：注销并行云服务
  • acct：查看可用超算账号
  • lsc：查看支持的超算中心
  • ssh：登录超算
  • scp：上传/下载文件
  • rsync：同步文件
  • sftp：加密的ftp文件传输
  • sshfs：挂载远程服务器目录
  • completion：生成命令行自动补全的 shell 脚本

1.2 支持的平台 #

  • Linux x86_64
  • Linux i686
  • Linux aarch64
  • Darwin amd64
  • Darwin arm64

2 快速开始 #

本章节将带您快速上手 papp_cloud，以下操作都是在 linux/macOS 系统 的命令行中完成。接下来请您打开一个命令行界面，跟着本节教程一起完成以下操作。

2.1 下载 papp_cloud 安装包 #

如果您已经获取到 papp_cloud 的安装包，可以跳过这一步，进入下面的安装步骤。

  • 点击下载 进入 papp_cloud 下载页面。

2.2 安装 papp_cloud #

进入到 papp_cloud 安装包所在的目录，开始下面的步骤。

  • 解压 papp_cloud 安装包
unzip papp_cloud-3.6.10.zip
  • 进入 papp_cloud 安装包目录
cd papp_cloud-3.6.10
  • 安装
./install.sh install

2.3 登录并行云服务 #

使用并行账号（demo@paratera.com）登录

papp_cloud login -u demo@paratera.com -p

2.4 查看可用超算账号 #

papp_cloud acct

2.5 查看支持的超算中心 #

papp_cloud lsc

2.6 ssh 登录超算 #

papp_cloud ssh paratera@gz

2.7 sftp 登录超算 #

papp_cloud sftp paratera@gz

2.8 scp 上传本地文件到超算 #

papp_cloud scp file1 paratera@gz:/home/paratera

2.9 scp 下载超算文件到本地 #

papp_cloud scp  paratera@gz:/home/paratera/file1 /tmp

2.10 rsync 同步本地文件到超算 #

papp_cloud rsync file1 paratera@gz:/home/paratera/

2.11 rsync 同步超算文件到本地 #

papp_cloud rsync paratera@gz:/home/paratera/file1 /tmp

2.12 sshfs 挂载远程主机目录到本地 #

papp_cloud sshfs paratera@gz:/home/paratera/file1 /localdir

3 安装设置 #

3.1 安装 #

  • 解压 papp_cloud-3.6.10.zip
unzip papp_cloud-3.6.10.zip
  • 进入 papp_cloud-3.6.10 目录
cd papp_cloud-3.6.10
  • 执行 install.sh 脚本安装 papp_cloud
./install.sh install

3.2 升级 #

 ./install.sh update

3.3 卸载 #

./install.sh remove

4 login 登录并行云服务 #

命令格式：

papp_cloud login -u <email|mphone> -p
  • 并行账号包含：邮箱账号或手机账号
  • email：电子邮箱
  • mphone：手机号码
papp_cloud login -u demo@paratera.com -p

5 accounts 查看可用的超算账号 #

papp_cloud accounts

6 ssh 的使用 #

6.1 ssh 登录超算 #

命令格式

papp_cloud ssh [<flags>] <destination> [<command>...]

destination

  • 格式：user@sccname
  • user：超算账号
  • sccname：超算简称，（使用 papp_cloud lsc）查看

例1：使用 paratera 帐号登录广州超算（IPv4）

$ papp_cloud ssh paratera@gz

例2：使用 paratera 帐号登录广州超算（IPv6）

$ papp_cloud ssh -6 paratera@gz

7 scp 的使用 #

命令格式

papp_cloud scp [<flags>] <source ... target>...

7.1 上传本地文件到超算 #

例1：使用 paratera 帐号上传 file1、file2 文件到广州超算的 paratera 用户家目录（IPv4）

$ papp_cloud scp file1 file2 paratera@gz:/home/paratera

例2：使用 paratera 帐号上传 file1、file2 文件到广州超算的 paratera 用户家目录（IPv6）

$ papp_cloud scp -6 file1 file2 paratera@gz:/home/paratera

7.2 下载超算文件到本地 #

例1：使用 paratera 帐号下载广州超算 paratera 用户家目录下的 file1 文件到本地的 /data 目录（IPv4）

$ papp_cloud scp paratera@gz:/home/paratera/file1 /data

例2：使用 paratera 帐号下载广州超算 paratera 用户家目录下的 file1 文件到本地的 /data 目录（IPv6）

$ papp_cloud scp -6 paratera@gz:/home/paratera/file1 /data

8 rsync 功能(支持断点续传) #

命令格式

papp_cloud rsync [<flags>] <source ... target>...

8.1 同步本地文件到超算 #

例1：使用 paratera 帐号同步 file1、file2 文件到广州超算的 paratera 用户家目录（IPv4）

$ papp_cloud rsync file1 file2 paratera@gz:/home/paratera

例2：使用 paratera 帐号同步 file1、file2 文件到广州超算的 paratera 用户家目录（IPv6）

$ papp_cloud rsync -6 file1 file2 paratera@gz:/home/paratera

8.2 同步超算文件到本地 #

例1：使用 paratera 帐号下载广州超算 paratera 用户家目录下的 file1 文件到本地的 /data 目录（IPv4）

$ papp_cloud rsync paratera@gz:/home/paratera/file1 /data

例2：使用 paratera 帐号下载广州超算 paratera 用户家目录下的 file1 文件到本地的 /data 目录（IPv6）

$ papp_cloud rsync -6 paratera@gz:/home/paratera/file1 /data

9 sftp 的使用 #

9.1 sftp 登录超算 #

命令格式

papp_cloud sftp [<flags>] <destination>...

例1：使用 paratera 帐号登录广州超算（IPv4）

$ papp_cloud sftp paratera@gz

例2：使用 paratera 帐号登录广州超算（IPv6）

$ papp_cloud sftp -6 paratera@gz

10 sshfs 的使用 #

10.1 sshfs 挂载远程主机目录 #

命令格式

papp_cloud  sshfs <[user@]host:[dir]> <mountpoint>

例1：挂载广州超算目录 /home/paratera 到本地挂载点 /localdir

papp_cloud sshfs paratera@gz:/home/paratera /localdir

11 选择超算连接链路 #

默认情况下，不加 ‘-s’ 参数，papp_cloud 会自动选择一条 ping 延时最小的链路， 如果需要手动选择，需添加 ‘-s’ 参数。

支持 ssh、scp、rsync、sftp、sshfs 功能的链路选择，使用时在子命令后加 ‘-s’ 参数就开启了手动选择链路的功能

11.1 命令格式 #

papp_cloud ssh -s [<flags>] <destination> [<command>...]
papp_cloud scp -s [<flags>] <source ... target>...
papp_cloud sftp -s [<flags>] <destination>...
papp_cloud rsync -s [<flags>] <source ... target>...

11.2 使用实例 #

➜  papp_cloud git:(master) ✗ papp_cloud ssh -s paratera@gz
Super Computing link list:
[0]. cn-zhongwei-cstnet-22 (10690)
[1]. cn-beijing-22 (1020409)
[2]. cn-beijing-22 (118859)
[3]. cn-beijing-80 (506390)
Please input a nubmer continue or enter 'q' to quit:2
Last login: Thu Nov 30 15:41:04 2017 from 172.18.14.10
***************************************************************************************************
                 >>>>                       Paratera Message System               <<<<
                 >>>>                        做计算，找并行！                     <<<<
                 >>>>  注：请大家使用以下命令查看自己账号磁盘配额及使用情况，如果 <<<<
                 >>>>  发现磁盘配额用满或接近限额请及时清理数据或扩大存储，以免对 <<<<
                 >>>>  您的作业造成影响，有问题随时随时联系我们。                 <<<<
                 >>>>  例如：lfs quota -u ppXXX  /HOME/ppXXX/WORKSPACE            <<<<
                 >>>>  或    lfs quota -u ppXXX  /HOME/ppXXX/BIGDATA              <<<<
                 >>>>  当kbytes值>quota值或接近是就需要清理或扩大存储空间         <<<<

***************************************************************************************************

12 debug 功能 #

例1：paratera 用户不能正常登录广州超算，需要查看登录失败详情，使用以下命令

papp_cloud ssh -v paratera@gz

13 查看支持的超算中心 #

papp_cloud lsc