IBM Aspera for Desktop

https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x
Admin
IBM Aspera for Desktop is a client application designed for high-speed transfer of large files and...
Tokens:10,011
Snippets:90
Trust Score:10
Update:10 months ago
Show doc for...
Tokens:
Raw
### Make AppImage Executable and Run via Command Line

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=upgrades-installation

These commands are used to make the IBM Aspera for Desktop AppImage executable and then run the application from the command line. Navigate to the directory containing the AppImage using 'cd' first.

```bash
$ chmod +x ibm-aspera-desktop_version_linux.AppImage
$ ./ibm-aspera-desktop_version_linux.AppImage
```

--------------------------------

### Install IBM Aspera via Debian Package

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=upgrades-installation

This command installs the IBM Aspera for Desktop using a Debian package (.deb file). Ensure you have the correct package name and version. This method is for Debian-based Linux distributions.

```bash
$ dpkg -i ibm-aspera-desktop_version_linux.deb
```

--------------------------------

### Example defaults.json Configuration

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON configuration demonstrates how to set enforced and default preferences for Aspera Desktop. It includes examples for disabling auto-updates and setting a custom download directory.

```json
{
  "enforced": {
    "auto_update": {
      "enabled": false
    }
  },
  "defaults": {
    "download_dir": "/path/to/folder"
  }
}
```

--------------------------------

### Windows Silent MSI Installation for IBM Aspera

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=upgrades-installation

Demonstrates how to perform a silent installation of IBM Aspera for Desktop on Windows using the MSI package and the /quiet command-line argument. This method is useful for automated deployments and requires elevated privileges.

```cmd
C:\Users\Asp1\Downloads\ibm-aspera-desktop-1.0.15-x64.msi /quiet
```

--------------------------------

### Bandwidth Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON object defines bandwidth limits for uploads and downloads in Aspera Desktop. It allows enabling limits and setting the aggregate bandwidth in Kbps.

```json
{
    "upload_limit_enabled": true,
    "upload_limit": 100000,
    "download_limit_enabled": true,
    "download_limit": 100000
}
```

--------------------------------

### Branding Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON object details how to apply custom branding themes to Aspera Desktop. It includes setting an active theme and defining a list of custom themes with their properties.

```json
{
    "active": "my-theme",
    "themes": [{
        "id": "my-theme",
        "name": "Acme Theme",
        "theme": {}
    }]
}
```

--------------------------------

### Export Settings: Windows

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-import-export-settings-from-connect

Commands to export IBM Aspera Connect settings to a specified user's connect-settings.json on Windows. Requires opening Command Prompt. Supports both system-wide and single-user installations.

```shell
"C:\Program Files\IBM\Aspera Connect\bin\asperaconnect.exe" -w C:\Users\<user>\connect-settings.json
```

```shell
"C:\Users\<user>\AppData\Local\Programs\IBM\Aspera Connect\bin\asperaconnect.exe" -w C:\Users\<user>\connect-settings.json
```

--------------------------------

### Preloaded Accounts Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON array demonstrates how to pre-configure accounts for Aspera Desktop. Each account object specifies its display name, URL, type (e.g., 'aoc', 'enterprise', 'hsts'), and optional Node API user.

```json
[
{
    "name": "My Aspera on Cloud",
    "url": "https://acme.ibmaspera.com",
    "type": "aoc"
}
]
```

--------------------------------

### Export Settings: macOS

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-import-export-settings-from-connect

Commands to export IBM Aspera Connect settings to ~/connect-settings.json on macOS. Requires opening Terminal.app. Supports both all-users and single-user installations.

```shell
"/Applications/IBM Aspera Connect.app/Contents/MacOS/IBM Aspera Connect" -w ~/connect-settings.json
```

```shell
"~/Applications/IBM Aspera Connect.app/Contents/MacOS/IBM Aspera Connect" -w ~/connect-settings.json
```

--------------------------------

### FASP Proxy Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON object illustrates the configuration for FASP proxy settings. It allows enabling the proxy, specifying the host, port, username, and whether to use the DNATS protocol.

```json
{
    "enabled": true,
    "use_dnats": true,
    "host": "proxy.acme.com",
    "port": 9092,
    "username": "aspera"
}
```

--------------------------------

### Privacy Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON object configures privacy settings, specifically controlling whether IBM can track user actions for product improvement. It can be enabled or disabled.

```json
{
    "tracking_enabled": false
}
```

--------------------------------

### Auto-Update Configuration Example

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-configure-default

This JSON snippet shows how to configure the automatic update setting for Aspera Desktop. It can be enabled or disabled by setting the 'enabled' property to true or false.

```json
{
   "enabled": true
}
```

--------------------------------

### Export Settings: Linux

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-import-export-settings-from-connect

Command to export IBM Aspera Connect settings to ~/connect-settings.json on Linux. Requires opening a terminal.

```shell
.~/connect/bin/asperaconnect -w ~/connect-settings.json
```

--------------------------------

### Create Default Keychain on Linux using secret-tool

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=troubleshooting-troubleshoot-adding-account

This command creates a default keychain for the Aspera desktop app on Linux systems. It utilizes the 'secret-tool' command to store a test value, ensuring the Secret Service API is correctly configured. This is crucial for securely storing account passwords.

```bash
echo -n testing | secret-tool store --label='Testing' anything somevalue
```

--------------------------------

### Configure Enforced Bandwidth Limits in defaults.json

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-limit-bandwidth-usage

This JSON configuration snippet defines enforced bandwidth limits for Aspera Desktop. By setting 'upload_limit_enabled' and 'download_limit_enabled' to true within the 'enforced.bandwidth' section, administrators can prevent users from changing these settings through the application's UI. This requires modifying the defaults.json file in the application's configuration directory.

```json
{
  "enforced": {
    "bandwidth": {
      "upload_limit_enabled": true,
      "download_limit_enabled": true
    }
  }
}

```

--------------------------------

### Uninstall Aspera for Desktop on Linux (Debian)

Source: https://www.ibm.com/docs/en/aspera-for-desktop/1.0.x/index_topic=preferences-update-aspera-desktop

This snippet shows how to uninstall Aspera for Desktop on Debian-based Linux systems using the apt package manager and remove configuration files. It requires administrator privileges for the apt command.

```shell
sudo apt remove ibm-aspera
rm -rf ~/.config/com.ibm.software.aspera.desktop
```
Tokens:
Raw