Skip to end of metadata
Go to start of metadata

Images

Front

Back

The eDCA (ePVS Data Collection Appliance) is a standard hardware Dynics platform running Linux CentOS 7 x64.


Software Required

You will need an SSH client, Bitvise SSH Client is recommended. Click here and download and install.

HostIP Address of eDCA
Port5522  –  Images v34 and greater
    22  –  All other Images
Usernameit
Initial methodpassword
Password

< Contact your Sales Rep, or Beet Support >

Initial IP Address

Port NameEthernet PortIP AddressCIDR SubnetDescription (Purpose)
Up-Linkenp1s0DHCP
Used if required.
PLCenp0s31f610.0.0.2/24 (255.255.255.0)Default Port that should be used.


The user root, does not have a password (for security reasons).

After Login you will get a SSH FTP Window and a SSH Console.

Everything can be executed via this SSH Console.

Change IP Address

Linux network management uses CIDR format for subnet masks See below for cheat sheet for conversion.

Most Common CIDR's are:

Netmask

CIDR

255.255.252.0/22

255.255.255.0

/24

255.255.255.128

/25

255.255.255.192

/26

Network Manager Text UI

As it user, you must execute all privileged commands with sudo.  First time you use this command you will prompted for your password.  If an extended time period lapses you will be prompted again for password.  You will not see characters when typing password.


Type: sudo nmtui <enter>

it@edca-xid-000000:~ $ sudo nmtui
[sudo] password for it:


A Text User Interface will appear.  Mouse will not work; you use cursors to move between buttons and fields.

Cursor and select "Edit a connection" press Enter.

You should see two interfaces

Ethernet PortLabel - DescriptionDefault IP
enp0s31f6

PLC

10.0.0.2/24
enp1s0

Up-Link (OA or Internet)

DHCP


Configuration Type

Configuration TypePurpose - Description

Disabled

Disable Network Interface
AutomaticDHCP - Get IP settings automatically from a DHCP server on network.
ManualSet IP settings Manually

Manually Setting IP Settings

Enter IP address using CIDR format.   Add Gateway, and DNS IPs as required.  Repeat for all interfaces.

  


Activate IP Changes

This is required, in order the changes to IP network configuration to take effect.

Option 1 - Bounce Interfaces

Type: sudo nmcli con down enp1s0 && sudo nmcli con up enp1s0 <enter>

Type: sudo nmcli con down enp0s31f6 && sudo nmcli con up enp0s31f6 <enter>

it@edca-xid-000000:~ $ sudo nmcli con down enp1s0 && sudo nmcli con up enp1s0
Connection 'enp1s0' successfully deactivated
Connection successfully activated

it@edca-xid-000000:~ $ sudo nmcli con down enp0s31f6 && sudo nmcli con up enp0s31f6
Connection 'enp0s31f6' successfully deactivated
Connection successfully activated

This will apply new network changes, if you changed the IP address of how you are connected remotely, you will be disconnected and need to reconnect using the new IP address.

Option 2 - Reboot

Type: sudo reboot <enter>

it@edca-xid-000000:~ $ sudo reboot

You will lose connection as eDCA reboots.

Adding Proxy Settings to eDCA Transfer

Reference "VI Commands Cheat Sheet", in Appendix below.

eDCA Transfer version 2.6 and above ONLY.

  1. Change directory: cd /opt/beet/edca-transfer <enter>
  2. Type: sudo vi config.properties <enter>
  3. Edit the following lines for Proxy configuration.  Note you may need to remove "#"; these are commented line in configuration.

  4. Save and exit VI

Verify Config Changes

Type: cat config.properties <enter>

*** This will print out the current configuration for "config.properties"

Change eDCA Service UID

Reference "VI Commands Cheat Sheet", in Appendix below.

  1. Change directory: cd /opt/beet/edca-transfer <enter>
  2. Type: sudo vi config.properties <enter>
  3. Change the line  edcaId=localhost.localdomain to appropriate UID as defined from EAS
  4. Save and exit VI

Service UID Example

Example:  edcaId=f352a35e-4e25-11e8-9c2d-fa7ae01bbebc


After changing configurations, you must restart the transfer agent.

Restart the Transfer Agent

Type: sudo systemctl restart edcatransfer <enter>


Upgrade eDCA Transfer Service


We don't allow directory browsing on download site.  Therefore you will need to know the specific version you which to download.  Reference Release Notes.

  1. Log-In to eDCA via SSH client (see above)
  2. Download latest edca-transfer package (Please note URL will change with version updates)
    1. Type:  curl -LO https://commondatastorage.googleapis.com/beet-package-installs/edca-packages/package-edca-transfer-2.6.tgz <enter>
  3. Extract package contents (Note: File name will change with version updates)
    1. Type:  tar xzf package-edca-transfer-2.6.tgz <enter>
  4. Type:  cd package-edca-transfer <enter>
  5. Run Upgrade/Update Script as root
    1. Type:  sudo ./update_edca-transfer.sh <enter>

Update is complete and service has restarted.


Appendix

VI Commands Cheat Sheet

Keyboard Commands (Case is very important)Purpose - Description
sudo vi <fileToEdit>

Example: sudo vi config.properties

Open file to edit.
:q!<enter>

Quit VI editor without saving changes.

:wq<enter>Save all changes, and quit VI editor.

i


You must exit edit mode to enter other commands.

Enter Insert edit mode.

Cursor around and make changes as required.

<esc>Exit edit mode


Related articles