Conceitos iniciais

O ambiente Linux é diferente de outros sistemas operacionais como o Windows ou o Mac OS. É necessário entender alguns conceitos para conseguir fazer a configuração do Action.Net neste sistema operacional. Neste item, abordaremos alguns destes conceitos. Sinta-se à vontade para pular este item e retornar apenas quando tiver alguma dúvida.

A seguir seguem alguns conceitos:

Linux - Sistema operacional que utiliza o Kernel Linux, criado por Linus Torvald.

Initial concepts

The Linux environment is different from other operating systems like Windows or Mac OS. It is necessary to understand some concepts to be able to configure the Action.Net in this operating system. In this item, we will cover some of these concepts. Feel free to skip this item and return only when you have any questions.

Here are some concepts:

Linux - Operating system that uses the Linux Kernel, created by Linus Torvald.

Distributions- They are different implementations of the system running on top of the Linux kernel. We have distributions Major which are more stable distributions, with a good development team behind them, as well as Ubuntu, Debian, Slackware, Fedora (ex-formerly Red Hat), OpenSuse, CentOs, Arch, Alpine, Mint, Gentoo e and FreeBsd. Também temos distribuições Minor que podem ter equipes menores de desenvolvimento por trás e que derivam das distribuições major. Por exemplo, Kubuntu e Neon derivam do Ubuntu, Manjaro deriva do Arch, entre outras.Interface Gráfica - Cada distribuição, quando desenvolvida, pode utilizar uma ou outra variação de interfaces gráficas, que são desenvolvidas de forma modular para se adequar às distribuições. Entre as interfaces gráficas disponíves e de maior sucesso estão o KDE e o Gnome. O KDE é uma interface mais parecida com o Windows e o Gnome é uma interface criada mais recentemente e com elementos visuais diferentes. Entre outras interfaces, podemos citar o Unity (utilizada pelo We also have distributions Minor that may have smaller development teams behind them and that derive from the major distributions. For example, Kubuntu and Neon derive from Ubuntu, Manjaro derives from Arch, among others.

Graphical user interface- Each distribution, when developed, can use one or another variation of graphical interfaces, which are developed in a modular way to suit the distributions. Among the most successful and available graphical interfaces are KDE and Gnome. KDE is a more Windows-like interface and Gnome is a more recently created interface with different visual elements. Among other interfaces, we can mention Unity (used by Ubuntu), Mate, Cinnamon, Xfce, entre outrasamong others.

Terminal de comandos - O terminal de comandos do Linux é uma ferramenta poderosa e, muito utilizada pelos usuários. Tanto leigos quanto experts no sistema operacional acabam utilizando esta ferramenta para todas as suas necessidades. Nas buscas por dúvidas relacionadas a utilização das distros, a grande maioria de soluções envolve a utilização do terminal. Adicionalmente, inúmeras são as aplicações que utilizam apenas o terminal do Linux e sequer instalam uma interface gráfica. Esta é uma ferramenta que será muito utilizada neste artigo.

sudo - Refere-se ao super usuário (administrador) do sistema operacional. Este tem permissões ilimitadas dentro do sistema. Inúmeras distribuições Linux adicionam usuários ao sistema operacional sem permissões durante a instalação do sistema.

Gerenciamento de Pacotes - No Linux, a instalação de novos aplicativos ou módulos de sistema é feita, na grande maioria das vezes, a partir de um gerenciador de pacotes do sistema. Cada distribuição utiliza um gerenciador de pacotes específico. Por exemplo, no Debian e no Ubuntu é utilizado o apt, no Arch e Manjaro é utilizado o pacmac e no Fedora é utilizado o dnf.

Já existem inúmeros gerenciadores de pacotes visuais, pré-instalados pelas distribuições. Todavia, o mais comum é utilizar o terminal para fazer a instalação e a atualização de pacotes.

Configurando o ambiente

Criação de máquina virtual

Inicialmente, é necessário baixar uma imagem ISO de alguma distribuição Linux e criar uma máquina virtual utilizando esta imagem. É possível criar VMs linux em qualquer hiper-virtualizador capaz de executar o sistema operacional como o Command terminal - The Linux command terminal is a powerful tool and widely used by users. Both laymen and experts in the operating system end up using this tool for all their needs. In searches for questions related to the use of distros, the vast majority of solutions involve the use of the terminal. In addition, there are many applications that use only the Linux terminal and do not even install a graphical interface. This is a tool that will be used a lot in this article.

sudo - Refers to the super user (administrator) of the operating system. This one has unlimited permissions within the system. Numerous Linux distributions add users to the operating system without permissions during system installation.

Package Management - On Linux, the installation of new applications or system modules is done, most of the time, from a system package manager. Each distribution uses a specific package manager. For example, Debian and Ubuntu use the Apt, in Arch and Manjaro is used the pacmac and in Fedora the dnf.

There are already numerous visual package managers, pre-installed by distributions. However, the most common is to use the terminal to install and update packages.

Setting up the environment

Virtual machine creation

Initially, it is necessary to download an ISO image of some Linux distribution and create a virtual machine using this image. It is possible to create linux VMs on any hyper-virtualizer capable of running the operating system such as VirtualBox, Hyper-V, VmWare, ProxMox, Zen Server, etc…

Após baixar a imagem, configure uma nova VM de acordo com o manual de utilização do seu virtualizador. Para este artigo específico, criamos uma máquina virtual Debian, plataforma i386, com 8Gb de memória, 4 processadores virtuais e 100Gb de armazenamento (dinamicamente alocável). Outros testes também foram realizados utilizando Linux Ubuntu, plataforma x64 e com as mesmas especificações anteriores de recursos e com resultados idênticos.

Atribuir permissões ao usuário

Muitas distribuições Linux, por padrão, adicionam um usuário para acesso ao sistema sem as permissões de administração necessárias para instalação e atualização de pacotes de software e de sistema. Esta é uma política de segurança utilizada por estes sistemas operacionais.

Para adicionar um novo usuário ao grupo de administração sudo, abra o terminal de comandos do seu linux.

Para fazer o login no terminal com o superusuário, execute o comandoetc...

After downloading the image, configure a new VM according to your virtualizer's user manual. For this specific article, we created a Debian virtual machine, i386 platform, with 8Gb of memory, 4 virtual processors and 100Gb of storage (dynamically allotable). Other tests were also carried out using Linux Ubuntu, x64 platform and with the same previous feature specifications and with identical results.

Assign permissions to the user

Many Linux distributions, by default, add a user for system access without the administration permissions required to install and update software and system packages. This is a security policy used by these operating systems.

To add a new user to the administration group sudo, Open your Linux command terminal.

To log in to the terminal with the superuser, run the command:

su root

Em seguida execute o comando a seguir para atribuir ao usuário criado privilégios de super usuário, substituindo a entrada <usuario> pelo nome do usuário criado na instalaçãoThen run the following command to assign the created user super user privileges, replacing the entry <usuario> with the name of the user created in the installation:

sudo usermod -a -G sudo <usuario>

Em seguida, reinicie o sistema operacional para que as configurações sejam aplicadas.

Atualização do sistema operacional

Como boa prática, é necessário atualizar o sistema operacional e seus módulos antes de instalar um novo pacote, como o Mono ou o Net-Tools.

Execute os seguintes comandos em sequência e confirme a atualização caso o terminal peça confirmação (digitando “Y”Then, restart the operating system for the settings to be applied.

Operating system upgrade

As a best practice, it is necessary to update the operating system and its modules before installing a new package, such as Mono or Net-Tools.

Run the following commands in sequence and confirm the update if the terminal asks for confirmation (by typing "Y").

sudo apt update
sudo apt upgrade

Caso o Linux solicite a reinicialização do sistema, reinicie-o e depois execute os próximos passos.

Instalação do Net-tools

O pacote net-tools instala o comando ifconfig para visualização do endereço IP da máquina, entre outros comandos.

Execute o comando a seguir para instalar o If Linux prompts you to restart the system, restart it and then perform the next steps.

Net-tools Installation

The net-tools package installs the command ifconfig to view the IP address of the machine, among other commands.

Run the following command to install net-tools

sudo apt install net-tools

Caso o Linux solicite a reinicialização do sistema, reinicie-o e depois execute os próximos passos.

Instalação do Mono

O que é o Mono?

O pacote mono é o pacote que executa aplicativos .Net em várias plataformas.

Para explicar melhor o que é o Mono e qual sua participação dentro do ecosistema da plataforma .Net, o melhor é fazer uma diferenciação entre ele e as demais implementações do padrão .Net Standard. O padrão .Net Standard é um padrão open source criado pela Microsoft para implementar as funcionalidades da plataforma .Net. Qualquer desenvolvedor (ou time de desenvolvedores), pode implementar este padrão. Dentre as iniciativas que já tiveram este trabalho, temos o .Net Framework, o Mono e o .Net Core.

O .Net Framework é uma implementação da própria Microsoft de todo o .Net Standard que provê uma grande variedade de funcionalidades para operação em ambientes Windows em Workstations, Server e na nuvem. É a implementação original do .Net.

O Mono é uma implementação open source, multi-plataforma do .Net Standard com apenas o essencial para executar aplicações .Net em diferentes sistemas operacionais como Android, IOS e com boa aceitação para o Linux. É uma implementação mais antiga se comparada com o .Net Core.

O .Net Core é uma implementação recente (a partir de 2014) do .Net Standard. É open source e multi-plataforma assim como o Mono. Criada para a era da Nuvem e com uma maior compatibilidade com o .Net. É suportada em diferentes sistemas operacionais como o Linux, MacOs e Windows.

Instalação do mono no Debian

A seguir será mostrado como instalar o Mono na distribuição Debian. Todavia, o Mono é compatível com diversas distribuições Major como o Ubuntu, Fedora, Raspbian e CentOs. Para informações de como instalar o mono para estas distribuições, bem como de mais informações sobre este pacote, clique no link abaixo para visitar a página do projeto MonoIf Linux prompts you to restart the system, restart it and then perform the next steps.

Mono Installation

What is Mono?

The mono package is the package that runs .Net applications on multiple platforms.

To better explain what Mono is and what its participation within the ecosystem of the .Net platform, it is best to differentiate between it and the other implementations of the .Net Standard. The .Net Standard is an open source standard created by Microsoft to implement the functionalities of the .Net platform. Any developer (or team of developers) can implement this standard. Among the initiatives that have already had this work, we have the .Net Framework, Mono and .Net Core.

The .Net Framework is Microsoft's own implementation of the entire .Net Standard that provides a wide variety of functionality for operation in Windows environments on Workstations, Server, and in the cloud. It is the original implementation of .Net.

Mono is an open source, cross-platform implementation of .Net Standard with only the essentials to run .Net applications on different operating systems such as Android, IOS and with good acceptance for Linux. It is an older implementation compared to .Net Core.

.Net Core is a recent implementation (as of 2014) of the .Net Standard. It's open source and cross-platform just like Mono. Built for the Cloud era and with greater compatibility with .Net. It is supported on different operating systems like Linux, MacOs and Windows.

Installing mono on Debian

The following will show how to install Mono on the Debian distribution. However, Mono is compatible with several distributions Major such as Ubuntu, Fedora, Raspbian and CentOs. For information on how to install mono for these distributions, as well as more information about this package, click the link below to visit the Mono project page.

https://www.mono-project.com/download/stable/#download-lin

Para instalar o mono no debian, inicialmente é necessário adicionar seu repositório ao sistema operacional. Execute o seguinte comandoTo install mono on debian, you initially need to add your repository to the operating system. Run the following command:

sudo apt install apt-transport-https dirmngr gnupg ca-certificates
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb https://download.mono-project.com/repo/debian stable-buster main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
sudo apt update

Após a adição do repositório, é possível instalar o pacote executando o seguinte comandoAfter the repository is added, you can install the package by running the following command:

sudo apt-get install mono-complete

Após a instalação, é possível verificar se o Mono foi realmente instalado com o comando de verificação de versão do mesmoAfter installation, you can verify that Mono was actually installed with the Mono version check command:

mono --version

Este comando deve trazer a versão do mono recém instalada. Caso contrário, tente instalar novamente seguindo o passo a passo do site do projeto mono a partir do link acima.

Configuração da rede

No caso de uso de máquinas virtuais, é importante utilizar comutadores de rede em modo Bridge. Caso contrário, alguns erros ocorrem quanto a utilização do Action.Net em algumas portas específicas.

No VirtualBox, desligue a máquina virtual, clique no botão de configurações da máquina e, na seção Network, certifique-se que o adaptador de rede utilizado está conectado à placa de rede em modo Bridge.

Image Removed

Em seguida, inicie a máquina virtual novamente.

Instalação do OpenSSH

É necessário instalar o OpenSSH no Linux para fazer a transferência de arquivos do Action.Net do Windows para o Linux.

Execute o seguinte comando para instalar o This command should bring up the newly installed version of mono. Otherwise, try installing again by following the walkthrough of the mono project website from the link above.

Network Configuration

In the case of using virtual machines, it is important to use network switches in Bridge. Otherwise, some errors occur when using the Action.Net on some specific ports.

In VirtualBox, shut down the virtual machine, click the machine settings button, and in the Network section, make sure that the network adapter you are using is connected to the network card in mode Bridge.

Image Added

Then, start the virtual machine again.

OpenSSH Installation

You must install OpenSSH on Linux to transfer files from Windows Action.Net to Linux.

Run the following command to install OpenSSH:

sudo apt install openssh-server

Copy files from Action.Net

Compress IoT folder

Inicialmente, é necessário criar um arquivo tipo .zip contendo a pasta IoT da versão desejada do Action.Net. Esta pasta está localizada na pasta de instalação do produto no Windows (normalmente em Initially, you need to create a file type ..zip containing the IoT folder of the desired version of the Action.Net. This folder is located in the product installation folder in Windows (typically C:\Program Files (x86)\SPIN\Action.NET).

Em uma máquina Windows que tenha o On a Windows machine that has Action.Net instalado, abra o gerenciador de arquivos, procure a pasta IoT e a compacte em um arquivo tipo .zip. Caso queira, copie o arquivo para qualquer outra pasta desejada.

Copiar arquivo compactado para o Linux

Em seguida, abra o terminal do windows, navegue até a pasta onde está o arquivo .zip criado e execute o seguinte comando para copiar o arquivo do Windows para o Linux, substituindo os parâmetros descritos abaixoinstalled, open the File Manager, browse to the IoT folder and compress it into a file type ..zip. If you want, copy the file to any other folder you want.

Copy compressed file to Linux

Then open the windows terminal, navigate to the folder where the file is ..zip created and run the following command to copy the file from Windows to Linux, overriding the parameters described below:

scp Iot.zip <username>@<ip>:/<folder>

OndeWhere:

• <username> - usuário do linux com permissões superLinux user with super permissions;

• <ip> - ip da máquina linux; e<folder> - pasta no linux onde o arquivo será copiadoIP of the Linux machine; and

• <folder> - folder on Linux where the file will be copied.

Example:

scp Iot.zip leokporto@192.168.2.206:/home/leokporto

Movendo arquivos no Linux

Moving files on Linux

If you need to move a file on Linux, you can use the mv sourceFile DestinyFile.

ExemploExample:

mv /tmp/Iot.zip /home/leokporto/Iot.zip

Unzip files on Linux

Em seguida, é necessário descompactar o arquivo copiado. Para realizar esta operação no Linux, utiliza o seguinte comando unzip IotNext, you need to unzip the copied file. To perform this operation on Linux, use the following command iot unzip.zip.

Running Action.Net

applications on Linux

Para executar qualquer projeto no Linux, é necessário inicialmente criar um projeto do tipo Linux no Action.Net que está instalado no Windows e, em seguida, copiá-lo.

Na tela inicial do Action.Net, clique em New Project para abrir o Wizard de criação de projetos. Asim que o wizard abrir, escolha um nome e selecione a opção Linux / Mono no Target Framework.

Image Removed

Após criar o projeto e fazer todas as configurações necessárias no novo projeto, é necessário copiá-lo para o Linux. O Action.net faz esta cópia nativamente, no entanto, é necessário executar o tProjectServer no To run any project on Linux, you must first create a Linux-type project on the Action.Net that is installed on Windows, and then copy it.

On the Action.Net home screen, click New Project to open the Project Creation Wizard. As soon as the wizard opens, choose a name and select the option Linux / Mono in Target Framework.

Image Added

After you create the project and make all the necessary configurations in the new project, you need to copy it to Linux. The Action.net makes this copy natively, however, it is necessary to run tProjectServer on Linux.

TProjectServer.exe

Para executar o TProjectServer pelo terminal do Linux, primeiro navegue para dentro do diretório “Iot/ProjectServer” com o comando cd IoT/ProjectServer a partir da pasta inicial do usuário.

Em seguida, execute o comando mono para inicialização do TProjectServer utilizando permissões de super usuárioTo run TProjectServer from the Linux terminal, first navigate into the "Iot/ProjectServer" directory with the command cd IoT/ProjectServer from the user's home folder.

Next, run the mono command to initialize TProjectServer using super user permissions:

sudo mono TProjectServer.exe

Após a execução do comando, a tela do ProjectServer para Linux é mostrada e a mensagem “ProjectServer: Waiting client connections…” é mostrada no terminal.

Image Removed

Licenciando o Action.Net no linux

Para executar os aplicativos do Action.Net no linux, também é necessário licenciá-lo.

A partir do Project Server executando no linux, clique no botão Get, localizado ao fundo do aplicativo à esquerda, para gerar o Sitecode.

O processo de geração do licensekey é o mesmo para a instalação do Action.Net. Para dúvidas quanto a este processo, acione o suporte da SPIN pelo email do suporte SPIN.

Para aplicar o license key recebido, é possível fazer de duas formas:

1- Fazendo o download do arquivo no linux, clicando no botão Apply, localizado ao lado do botão Get mencionado anteriormente e selecionando o arquivo da licença; ou

2- A partir da tela inicial do Action.Net na máquina Windows, abrir a aba Server e informar o IP do linux. Em seguida, abrir a aba License e clicar no botão Load License key. O Action.Net irá aplicar a licença à máquina linux remota.

Copiando projetos para o Linux

O Action.Net tem uma funcionalidade de cópia de arquivos e projetos para o linux nativa da ferramenta. Esta funcionalidade pode ser acessada a partir da aba Server da tela inicial do produto.

Image Removed

Insira no campo Remote o endereço IP da máquina Linux e clique no botão Connect.

Após conectar, a tela apresenta os botões Update e Upload Project.

O botão Update faz a cópia de arquivos da pasta After running the command, the ProjectServer for Linux screen is shown and the message "ProjectServer: Waiting client connections..." is shown in the terminal.

Image Added

Licensing Action.Net on linux

To run Action.Net applications on linux, you also need to license it.

From the Project Server Running on Linux, click the Get located at the bottom of the application on the left, to generate the Sitecode.

The process of generating the licensekey is the same for the installation of Action.Net. For questions regarding this process, please contact SPIN support by email from SPIN support.

To apply the license key you received, you can do it in two ways:

1- Downloading the file on linux by clicking the button Apply, located next to the Get mentioned earlier and selecting the license file; or

2- From the home screen of the Action.Net on the Windows machine, open the tab Server and inform the linux IP. Then open the tab License and click the Load License key. The Action.Net will apply the license to the remote linux machine.

Copying projects to Linux

The Action.Net has a functionality of copying files and projects to the native linux of the tool. This functionality can be accessed from the Server from the product's home screen.

Image Added

Enter in the field Remote the IP address of the Linux machine and click the Connect.

After connecting, the screen displays the buttons Update and Upload Project.

The button Update copies files from the folder C:/InstallFolder/Action.Net/an-x.x/Iot/ para o Linux. É usado para atualizar arquivos do produto entre o Windows e o for Linux. It is used to update product files between Windows and Linux.

The button Upload Project Copies projects (.tproj) para o linux. Após clicar este botão, selecione o projeto que deseja enviar. Em seguida, a tela de confirmação de local a copiar é mostrada. Confirme o local e o Action.net irá copiar o projeto para a pasta.

Image Removed

Executando projetos

É possível executar projetos enviado ao linux a partir da tela do ProjectServer para o linux.

Inicialmente, clique no botão Projects… e selecione o projeto desejado. O projeto selecionado é mostrado no campo Project Startup Settings.

Em seguida, execute o projeto clicando no botão Run. O ProjectServer irá executar o tStartup e o tServer e executar todos os módulos configurados para execução do projeto.

Image Removed

Outros processos

TMQTTBroker.exe

Para executar o Mqtt Broker, no terminal do Linux, navegue para dentro do diretorio IoT/Runtime e rode o TMQTTBroker.exe com o mono usando o seguinte comandoto Linux. After clicking this button, select the project you want to submit. Then, the copy location confirmation screen is shown. Confirm the location and the Action.net will copy the project to the folder.

Image Added

Running projects

It is possible to run projects sent to linux from the ProjectServer for linux.

Initially, click the Projects... and select the desired project. The selected project is shown in the Project Startup Settings.

Then run the project by clicking the Run. Or ProjectServer will run the tStartup and tServer and run all modules configured for project execution.

Image Added

Other processes

TMQTTBroker.exe

To run Mqtt Broker, in the Linux terminal, navigate into the IoT/Runtime directory and run TMQTTBroker.exe with mono using the following command:

mono TMQTTBroker.exe