Skip to content

Installing Arundo Edge

Here's how to install Arundo Edge.

Prerequisites

Arundo Edge

Complete the following to install Arundo Edge on your edge device.

1. Request a License Key

The first step is to request a license key for Arundo Edge.

Warning

You need a license key to continue using Arundo Edge beyond the 14-day trial period.

  1. Open a License Key request.
  2. In Request Details, enter your name, company, contact details, and number of edge devices you need to license.
  3. In Production Environment, select your Arundo Fabric environment or select "N/A" if you don't use Arundo Fabric.
  4. Click Send.

    • An Arundo representative will contact you shortly to provide you with a license key.
  5. Store the license key in a safe place for use later.

2. Download the Installer

The second step is to download the installer for your operating system.

Windows
  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge installer for Windows.
macOS
  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge installer for macOS.
Linux

Linux Desktop

  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge installer for Linux.

Linux Server

  1. Open a terminal.
  2. Run the following command:

    1
    curl https://arundoedge.blob.core.windows.net/arundo-edge-installer/v2/linux/arundo-edge-cli-linux-x64 --output /tmp/arundo-edge-cli-linux-x64    
    

3. Run the Installer

The third step is to run the installer. Follow the instructions for the operating system on the edge device.

Windows
  1. Double-click the installer and grant any necessary permissions to run it.

    • The installer opens and performs a system check.
    • Wait for the system check to finish and act if necessary.
  2. Complete the following if you have Arundo Edge 1.6.0 or earlier installed:

    1. Click UNINSTALL.
    2. Follow the on-screen instructions to uninstall the old version.
    3. Restart your device.
    4. Reopen the installer.
macOS
  1. Press Ctrl and click the installer.
  2. Select Open.

    • The installer opens and performs a system check.
    • Wait for the system check to finish and act if necessary.
  3. Complete the following if you have Arundo Edge 1.6.0 or earlier installed:

    1. Click UNINSTALL.
    2. Follow the on-screen instructions to uninstall the old version.
    3. Restart your device.
    4. Reopen the installer.
Linux

Linux Desktop

  1. Open a terminal.
  2. Browse to the folder where you downloaded the installer.
  3. Run the ./arundo-edge-installer-linux-x64.run command:

    • The installer opens and performs a system check.
    • Wait for the system check to finish and act if necessary.
  4. Complete the following if you have Arundo Edge 1.6.0 or earlier installed:

    1. Click UNINSTALL.
    2. Follow the on-screen instructions to uninstall the old version.
    3. Restart your device.
    4. Reopen the installer.

Linux Server

  1. Open a terminal.
  2. Browse to the folder where you downloaded the installer.
  3. Run the following command:

    1
    $ sudo ./arundo-edge-cli-linux-x64 install --skipUI --user [username] --password [password]
    
    • Replace [username] with a username for the master user.
    • Replace [password] with a password for the master user.

    This installs the Arundo Edge Server component with the default settings.

    Note

    To register and add a Cloud interface, you need to access the Arundo Edge Client on another device, connect to the device where you installed the Arundo Edge Server component, and then complete the necessary configuration.

4. Configure Arundo Edge

The fourth step is to configure Arundo Edge to meet your needs.

Default Configuration

Installation Method

Deselect Advanced install (highlighted below) and click NEXT.

Basic Install 1

License Agreement

Accept the license agreement and click NEXT.

Basic Install 2

Location

Click NEXT to install Arundo Edge in the default location.

Basic Install 3

User

Select a username and password for the master user, then record both in a secure location. You will need these credentials later to log in to Arundo Edge.

Click NEXT to continue.

Basic Install 4

Connection

Click NEXT to use the default ports for the Arundo Edge database and Arundo Edge service.

Basic Install 5

Overview

Review the installation details and click PREVIOUS to go back and make adjustments if necessary. Click INSTALL to start the installation. Click Yes to continue if prompted.

Basic Install 6

Finishing Up

Once the installation is complete, click OPEN EDGE and close the installer.

Basic Install 7

Advanced Configuration

Installation Method

Select Advanced install (highlighted below) and click NEXT.

Advanced Install 1

License Agreement

Accept the license agreement and click NEXT.

Advanced Install 2

Location

Select where to install Arundo Edge and click NEXT.

Advanced Install 3

Import

Select one of the following options:

  • To install as normal, click NEXT.
  • To install using a configuration file from a previous installation, select the configuration file and click NEXT.

Advanced Install 4

User

Select a username and password for the master user, then record both in a secure location. You will need these credentials later to log in to Arundo Edge.

Click NEXT to continue.

Advanced Install 5

Storage

Specify how many hours of data to store locally when Arundo Edge isn't connected to a cloud environment, or use the default settings.

  • The more data you store locally, the more hard disk space you need on the edge device.
  • The hard disk space total under the fields changes based on your selections, so you have an idea of how much free space you need.
  • When you use the default storage settings (shown below), 1 tag will use approximately 66 MB of disk space.

Click NEXT to continue.

Advanced Install 6

Connection

Select the ports to use for the Arundo Edge Database and Arundo Edge services, or use the default ports. Click NEXT to continue.

Advanced Install 7

HTTPS

Select one of the following options:

  • To secure transmitted data as normal, click NEXT.
  • To encrypt and secure transmitted data with SSL (Secure Sockets Layer), select Enable HTTPS, upload the files for your SSL certificate, and click NEXT.

Advanced Install 8

Overview

Review the installation details and click PREVIOUS to go back and make adjustments if necessary. Click INSTALL to start the installation. Click Yes or enter your password to continue if prompted.

Advanced Install 9

Finishing Up

Once the installation is complete, click OPEN EDGE and close the installer.

Advanced Install 10

5. Register Arundo Edge

The fifth step is to register Arundo Edge. Follow the instructions for your IoT provider.

Arundo Fabric

Register Arundo Edge and connect it to the Arundo Fabric cloud.

Prerequisites

  • Arundo Enterprise subscription

Instructions

  1. Log in to Arundo Edge as the master user.
  2. Select Fabric and click Next.
  3. Select your Arundo environment and click Next.
  4. Select Fabric Login.
  5. Click Authenticate.
  6. Enter your Arundo Fabric login credentials.
  7. Authorize Arundo Edge to access your Arundo environment.
  8. Complete one of the following:

    • If you have a license key, enter your license key and click Validate.

    • If you don't have a license key, click Request free trial, enter your details, agree to the terms, and click Request.

      • If the request is successful, click Next to continue. You will receive a welcome email momentarily with a copy of your trial license key.
      • If the request is unsuccessful, contact our Customer Support team.
  9. In Device id requested by edge, enter an identifying name for the edge device.

  10. Click Done.

    Arundo Edge opens and the Dashboard displays.

  11. Under Interfaces, enable the interface for your edge device.​

    Enable Edge Device

  12. Open the System menu and select Upload Configuration to Fabric.

    Upload Configuration

Microsoft Azure

Register Arundo Edge and connect it to the Microsoft Azure cloud.

Prerequisites

  • Microsoft Azure subscription

Instructions

  1. Log in to Arundo Edge as the master user.
  2. Select Azure and click Next.
  3. Enter details for the device and IoT hub (as shown in Azure) and click Next.
  4. Complete one of the following:

    • If you have a license key, enter your license key and click Validate.

    • If you don't have a license key, click Request free trial, enter your details, agree to the terms, and click Request.

      • If the request is successful, click Next to continue. You will receive a welcome email momentarily with a copy of your trial license key.
      • If the request is unsuccessful, contact our Customer Support team.
  5. Click Done.

    Arundo Edge opens and the Dashboard displays.

  6. Under Interfaces, enable the interface for your edge device.​

    Enable Edge Device

No IoT Provider

Register Arundo Edge without connecting it to a cloud environment.

Instructions

  1. Log in to Arundo Edge as the master user.
  2. Click Skip.
  3. Complete one of the following:

    • If you have a license key, enter your license key and click Validate.

    • If you don't have a license key, click Request free trial, enter your details, agree to the terms, and click Request.

      • If the request is successful, click Next to continue. You will receive a welcome email momentarily with a copy of your trial license key.
      • If the request is unsuccessful, contact our Customer Support team.
  4. Click Done.

    Arundo Edge opens and the Dashboard displays.

6. Connect to a Control System

The final step is to connect Arundo Edge to an industrial control system. Follow the instructions for the communication protocol you need to use.

OPC UA

Connect Arundo Edge to a control system using the OPC UA protocol.

  1. On the sidebar, select Interfaces | Add new.
  2. Select OPC UA.
  3. In Name, enter the name of the OPC server.
  4. In URL, enter the connection address (UA TCP) for the OPC server.
  5. Complete the remaining fields as necessary.
  6. Click Add interface.
  7. Click Add Tag.
  8. Complete one of the following to add tags:

    • Click Browse and select the tags you want to add.
    • Click File and upload a comma-separated values (CSV) file containing the tags you want to add.
  9. Click Add.

    The setup is complete and Arundo Edge is now ready to use.

Modbus TCP

Connect Arundo Edge to a control system using the Modbus TCP protocol.

  1. On the sidebar, select Interfaces | Add new.
  2. Select Modbus.
  3. In Name, enter the name of the control system.
  4. In Connection Type, select "TCP".
  5. In URL, enter the connection address for the control system.
  6. In Port, enter the port used for connections to the control system.
  7. Complete the remaining fields as necessary.
  8. Click Add interface.
  9. Click Add Function Call.
  10. In Function Type, select the Modbus register type to use.
  11. In Name, enter a name to describe the function call.
  12. Complete the remaining fields as necessary.
  13. Click Add.
  14. Click Browse in the Operation column for the function call.
  15. In Quantity, adjust the quantity of bits the tag value spans.
  16. Adjust the Select address space (browse) slider control and Raw Hex Output to locate the correct values.
  17. Under Viable types, select the value to use for the tag.
  18. Click Add Tag.
  19. Add additional function calls and tags as necessary.

    The setup is complete and Arundo Edge is now ready to use.

Arundo Edge Client

Already have Arundo Edge installed and want to manage it remotely? You can use the Arundo Edge Client to connect to your edge device using TCP/IP.

To install this app, follow the instructions for your operating system.

Windows
  1. Open Arundo Edge Download Center.
  2. Download the Arundo Edge Client for Windows.
  3. Save the file in a directory on the local device.
  4. Open the file.

macOS
  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge Client for macOS.
  3. Press Ctrl and click the installer.
  4. Select Open.

    The Arundo Edge Client application now displays.

  5. Copy the application file to the Applications folder.

  6. Open the file.

Linux

Linux Desktop

  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge Client for Linux.
  3. Save the file in a directory on the local device.
  4. Open the file.

Linux Server

Danger

You cannot install the Arundo Edge Client in a Linux Server environment.

Arundo Edge CLI

Running a headless Linux server? Or want to work through SSH or Telnet? You can use the Arundo Edge CLI and manage Arundo Edge from the command line.

To install this tool, follow the instructions for your operating system.

Windows
  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge CLI for Windows.
  3. Save the file in a directory on the local device.
  4. Open Command Prompt as an administrator.
  5. Browse to the directory where you saved the file.
  6. Run the arundo-edge-cli-win-x64 --help command.

macOS
  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge CLI for macOS.
  3. Save the file in the Applications folder.
  4. Open Terminal.
  5. Browse to the Applications folder.
  6. Run the chmod +x arundo-edge-client-mac-x64 command.
  7. Run the sudo ./arundo-edge-cli-mac-x64 --help command.

Linux

Linux Desktop

  1. Open the Arundo Edge Download Center.
  2. Download the Arundo Edge CLI for macOS.
  3. Save the file in a directory on the local device.
  4. Open Terminal.
  5. Browse to the directory where you saved the file.
  6. Run the chmod +x arundo-edge-client-linux-x64 command.
  7. Run the ./arundo-edge-cli-linux-x64 --help command.

Linux Server

  1. Open a terminal.
  2. Run the following command to download the Arundo Edge CLI:

    1
    curl https://arundoedge.blob.core.windows.net/arundo-edge-installer/v2/linux/arundo-edge-cli-linux-x64 --output /tmp/arundo-edge-cli-linux-x64
    
  3. Browse to the directory where you downloaded the Arundo Edge CLI file.

  4. Run the following command:

    1
    $ sudo ./arundo-edge-cli-linux-x64 install --skipUI --user [username] --password [password]
    
    • Replace [username] with a username for the master user.
    • Replace [password] with a password for the master user.
  5. Run the ./arundo-edge-cli-linux-x64 --help command.

Need Help?

Support icon Contact our Customer Support team