Skip to content

Installation

clock

 

Here's how to install Arundo Edge.


Prerequisites

Make sure your device meets the system requirements​


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. Click Send.

    Info

    An Arundo representative will contact you shortly to provide you with a license key.

  4. 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.

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

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:

    curl https://downloads.edge.arundo.com/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.

  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.
  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.

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.

Linux Server

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

    $ 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.

  1. Deselect Advanced install and click NEXT.
  2. Accept the license agreement and click NEXT.
  3. Select a username and password for the master user, then record both in a secure location.

    Tip

    You will need these credentials later to log in to Arundo Edge.

  4. Click NEXT.

  5. Click NEXT to use the default ports for the Arundo Edge database and Arundo Edge service.
  6. Review the installation details and click PREVIOUS to go back and make adjustments if necessary.
  7. Click INSTALL to start the installation.

    Tip

    Click Yes to continue if prompted.

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

  1. Select Advanced install and click NEXT.
  2. Accept the license agreement and click NEXT.
  3. Specify where to install Arundo Edge and click NEXT.
  4. 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.
  5. Select a username and password for the master user, then record both in a secure location.

    Tip

    You will need these credentials later to log in to Arundo Edge.

  6. Click NEXT.

  7. 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.
  8. Click NEXT.

  9. Select the ports to use for the Arundo Edge Database and Arundo Edge services, or use the default ports.
  10. Click NEXT.
  11. 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.
  12. Select one of the following options:

    • Select Enable Warm Storage to set up a warm storage database on your edge device.
    • Deselect Enable Warm Storage if you don't want to set up a warm storage database.
  13. Click NEXT.

  14. Review the installation details and click PREVIOUS to go back and make adjustments if necessary.
  15. Click INSTALL to start the installation.

    Tip

    Click Yes to continue if prompted.

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

5. Register Arundo Edge

The fifth step is to register Arundo Edge.

Here's how to register Arundo Edge and connect it to the Microsoft Azure cloud.

Prerequisite

Microsoft Azure subscription

  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

Here's how to 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.

Here's how to 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.

Here's how to 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 Manager

Contact Arundo Customer Support if you want to install Arundo Edge Manager.


Arundo Edge Client

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

Here's how to install the Arundo Edge Client.

  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.

  1. Open 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 Desktop

  1. Open 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.

Here's how to install the Arundo Edge CLI.

  1. Open 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.

  1. Open 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-cli-mac-x64 command.
  7. Run the sudo ./arundo-edge-cli-mac-x64 --help command.

Linux Desktop

  1. Open 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-cli-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:

    curl https://downloads.edge.arundo.com/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:

    $ 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.


Last update: June 15, 2020