Skip to end of metadata
Go to start of metadata

The eDCA (Envision 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
Usernameit
Initial methodpassword
Password

< Contact your Sales Rep, or Beet Support >

Initial IP Address

Port NameEthernet PortIP AddressCIDR SubnetDescription (Propose)
Up-Linkenp1s0DHCP

PLCenp0s31f610.0.0.2/24 (255.255.255.0)Used if only one NIC port being used.


The user root, does not have a password (for security reasons), but if you have the eDCA Master private key, you can use that to access via root user.


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


Everything can be execute 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 period lapses you will be propted 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

LAN2 - PLC

10.0.0.2/24
enp1s0

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

  


Once IP settings are set as desired, you must reboot

Type: sudo reboot <enter>

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

You will lose connection as eDCA reboots.

Adding a Proxy Setting to EDCA Transfer

eDCA Transfer version 2.6 and above ONLY.


  1. Go to directory : cd /opt/beet/edca-transfer <enter>
  2. sudo vi config.properties <enter>
  3. Edit the following lines for Proxy

  4. <esc> :wq! <enter>

Verify Config Changes

Type: cat config.properties <enter>

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





CIDR SubNet Conversion Cheat Sheet

Netmask              Netmask (binary)                 CIDR     Notes    
_____________________________________________________________________________
255.255.255.255  11111111.11111111.11111111.11111111  /32  Host (single addr)
255.255.255.254  11111111.11111111.11111111.11111110  /31  Unuseable
255.255.255.252  11111111.11111111.11111111.11111100  /30    2  useable
255.255.255.248  11111111.11111111.11111111.11111000  /29    6  useable
255.255.255.240  11111111.11111111.11111111.11110000  /28   14  useable
255.255.255.224  11111111.11111111.11111111.11100000  /27   30  useable
255.255.255.192  11111111.11111111.11111111.11000000  /26   62  useable
255.255.255.128  11111111.11111111.11111111.10000000  /25  126  useable
255.255.255.0    11111111.11111111.11111111.00000000  /24 "Class C" 254 useable

255.255.254.0    11111111.11111111.11111110.00000000  /23    2  Class C's
255.255.252.0    11111111.11111111.11111100.00000000  /22    4  Class C's
255.255.248.0    11111111.11111111.11111000.00000000  /21    8  Class C's
255.255.240.0    11111111.11111111.11110000.00000000  /20   16  Class C's
255.255.224.0    11111111.11111111.11100000.00000000  /19   32  Class C's
255.255.192.0    11111111.11111111.11000000.00000000  /18   64  Class C's
255.255.128.0    11111111.11111111.10000000.00000000  /17  128  Class C's
255.255.0.0      11111111.11111111.00000000.00000000  /16  "Class B"
     
255.254.0.0      11111111.11111110.00000000.00000000  /15    2  Class B's
255.252.0.0      11111111.11111100.00000000.00000000  /14    4  Class B's
255.248.0.0      11111111.11111000.00000000.00000000  /13    8  Class B's
255.240.0.0      11111111.11110000.00000000.00000000  /12   16  Class B's
255.224.0.0      11111111.11100000.00000000.00000000  /11   32  Class B's
255.192.0.0      11111111.11000000.00000000.00000000  /10   64  Class B's
255.128.0.0      11111111.10000000.00000000.00000000  /9   128  Class B's
255.0.0.0        11111111.00000000.00000000.00000000  /8   "Class A"
  
254.0.0.0        11111110.00000000.00000000.00000000  /7
252.0.0.0        11111100.00000000.00000000.00000000  /6
248.0.0.0        11111000.00000000.00000000.00000000  /5
240.0.0.0        11110000.00000000.00000000.00000000  /4
224.0.0.0        11100000.00000000.00000000.00000000  /3
192.0.0.0        11000000.00000000.00000000.00000000  /2
128.0.0.0        10000000.00000000.00000000.00000000  /1
0.0.0.0          00000000.00000000.00000000.00000000  /0   IP space

Change eDCA Service UID

(info) You will be editing files see VI Cheat Sheet below for basic commands.

At the SSH Console prompt, Type:  cd /opt/beet/edca-transfer/ <enter>

it@edca-xid-000000:~ $ cd /opt/beet/edca-transfer/
it@edca-xid-000000:/opt/beet/edca-transfer $ ls
bin                lib                         logs                       messageQueue
config.properties  logbackSettings.properties  messageCounter.properties
it@edca-xid-000000:/opt/beet/edca-transfer $


Edit the config.properties file using VI editor.

Type:  sudo vi config.properties


Change the line  edcaId=localhost.localdomain to appropriate UID as defined in EAS.

(info) **Please note when you are in the editor "vi" you must first type "i" for insert mode then you can modify config.

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


Save and exit VI

(info) **Please note when you are exiting the editor "vi" you must first type "esc"  then type " :wq! " then hit "enter" this will save and exit the "vi" editor

(warning) After changing configurations, you must restart the transfer agent.

Restart the Transfer Agent

Type: sudo systemctl restart edcatransfer <enter>

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


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. 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. tar xzf package-edca-transfer-2.6.tgz <enter>
  4. cd package-edca-transfer <enter>
  5. Run Upgrade/Update Script as root
    1. sudo ./update_edca-transfer.sh <enter>

Update is complete and service has restarted.








  • No labels