Getting Started (En) Date: 09/2019 Revision: V.1.0 Copyright and Disclaimer
Total Page:16
File Type:pdf, Size:1020Kb
Getting started (en) Date: 09/2019 Revision: v.1.0 Copyright and disclaimer All rights reserved. No parts of this manual may be reproduced in any form without the express written permission of Mobile Industrial Robots A/S (MiR). MiR makes no warranties, express or implied, in respect of this document or its contents. In addition, the contents of the document are subject to change without prior notice. Every precaution has been taken in the preparation of this manual. Nevertheless, MiR assumes no responsibility for errors or omissions or any damages resulting from the use of the information contained. Copyright © 20162019 by Mobile Industrial Robots A/S. Contact the manufacturer: Mobile Industrial Robots A/S Emil Neckelmanns Vej 15F DK-5220 Odense SØ www.mir-robots.com Phone: +45 20 377 577 Email: [email protected] CVR: 35251235 MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 2 Table of contents 1. About this document 5 1.1 Where to find more information 6 1.2 Document history 7 2. Host and network requirements 8 2.1 Network architecture 8 3. Installing Software 10 3.1 What you need 10 3.2 Installing Docker 11 3.3 Installing MiRFleet Server Solution (Ubuntu/Red Hat Enterprise Linux) 14 3.4 Configuring MiRFleet Server Solution 15 3.5 FAQs 18 4. Getting Started 19 4.1 Updating robot software 19 4.2 Export site file(s) 20 4.3 Install and activate your fleet 21 5. Commissioning 25 5.1 MiRFleet interface 25 5.2 Add robots to the fleet 26 5.3 Activate site 27 5.4 Set up schedules 28 5.5 Groups 29 5.6 Set up elevators 30 5.7 Set up fleet dashboards 32 MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 3 5.8 Set up the fleet robots for automatic charging and staging 33 5.9 Set up the fleet robots for collision avoidance 35 5.10 Evacuation zones 36 6. MiRFleet API 37 6.1 Authentication 38 7. Maintenance of MiRFleet Server Solution 40 7.1 Docker 40 7.2 MiRFleet 40 7.3 Updating robots 40 MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 4 1. About this document 1. About this document This guide describes how to set up MiRFleet Server Solution and get started with MiRFleet interface. As MiRFleet Server Solution user, you have received the following information to get started: • License ID and password • USB pen with MiRFleet software and this getting started guide. • Usernames and passwords for logging in to the fleet interface. MiRFleet Server Solution is an alternative to the physical MiRFleet PC. MiRFleet Server Solution makes it possible to run MiRFleet on your own hardware and server systems. The MiRFleet Server Solution runs using Docker, a lightweight, simpler alternative to a Virtual Machine, so the first step in this guide is to install Docker. MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 5 1. About this document 1.1 Where to find more information At www.mir-robots.com, several additional resources are available. To access more information, sign in to the Distributor site with your distributor account at http://www.mobile-industrial-robots.com/en/account/. The following relevant resources are available: • Distributor site > Manuals http://www.mobile-industrial-robots.com/en/account/manuals/ This page contains the following resources: - Robot Quick starts The short guide that lets you start operating the robot quickly. This document is in the box with the robot in the printed format. Available in multiple languages. - Robot User guides The user guide of the robot. Available in multiple languages. - MiRFleet Reference guide The reference guide that describes the elements of the MiRFleet interface. Available in multiple languages. - MiRFleet REST API reference. The REST API reference for MiR100/MiR200MiRFleet. • Distributor site > Download http://www.mobile-industrial-robots.com/en/account/download/ This page contains the following resources: - CAD drawings. Select Show CAD-files to see the list of available CAD drawings. - Certificates. Select Show Certificates to see the list of certificates for the robot. • Distributor site > How to http://www.mobile-industrial-robots.com/en/account/how-to/ This page contains how-to articles that describe how to perform specific tasks with MiR products. • Distributor site > Troubleshooting https://www.mobile-industrial-robots.com/en/account/troubleshooting/ This page contains troubleshooting guides to solve common issues with MiR products. • MiRFleet Server Solution product page https://www.mobile-industrial-robots.com/en/products/mir-add-ons/mirfleet/ This page contains specifications, pictures, and brochures for MiRFleet Server Solution. MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 6 1. About this document • Universal Robots: http://www.universal-robots.com/support 1.2 Document history This table shows latest and previous versions of this document and their interrelations with product software releases. Revision Release Date Description SW HW 1.0 2019-30-07 First edition 2.5.0 1.0 and higher MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 7 2. Host and network requirements 2. Host and network requirements The specifications and requirements for running MiRFleet Server Solution are: • Installation file size: 3 GB • MiRFleet update file size: ~300 MB • Server requirements: Dual core processor with minimum 2.1 GHz clock • RAM: Minimum 4 GB (8 GB recommended) • HDD: 30 GB • Virtualization software: Docker CE/EE 18.09 Network requirements for the MiRFleet correspond to those of the MiR robots. See the network requirements guide on our website under Fleet manuals: MiR_network_ requirements_03.pdf 2.1 Network architecture MiRFleet is able to communicate to MiR robots, existing computer devices and WISE modules once connected to the network. Within the network it is still also possible for other computer devices to connect directly to the MiR robots through their robot interface. The WISE modules enable MiRFleet to control existing PLCs. 2.1. MiRFleet network architecture MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 8 2. Host and network requirements NOTICE Avoid using the robot interface to control robots that are active in MiRFleet. MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 9 3. Installing Software 3. Installing Software This section describes how to correctly install Docker and MiRFleet Server Solution to your computer system, and how to configure MiRFleet Server Solution to your preferences. 3.1 What you need MiRFleet Server Solution is supported on the following operating systems: • Red Hat Enterprise Linux RHEL 64-bit 7.4 or higher. • Ubuntu 18.04 • Ubuntu 18.04 Core Server • Debian 9 • CentOS Host minimum hardware requirements: • CPU: Dual-Core, 2.1 GHz • RAM: 8 GB • Disk: 100 GB Software: • Docker EE or CE version 18.09.01 or higher • bash • dpkg (Ubuntu) or yum (Red Hat Enterprise Linux) • Unzip or similar (Optional) NOTICE When MiRFleet starts, it will load data from persistent storage on the host. This persistent storage also functions as a backup for the MiRFleet con- figuration. The default path to the persistent storage folder is /mir_persistence. This path can be changed, but it must be done before the installation. See Configuring MiRFleet Server Solution on page 15 MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 10 3. Installing Software 3.2 Installing Docker Docker is a tool for creating a contained Operating System (OS), similar to a Virtual Machine (VM). Docker uses the host resources directly, whereas a VM either simulates hardware or lock resources for each VM. Because of the direct use of the host resources, Docker is a quick and easy way to make a fast-running contained OS environment inside an existing Operating System. Instead of running in their own virtual machine environment, each application runs inside a lightweight container. MiR has chosen to provide the MiRFleet Server Solution as a Docker file instead of a VM image because: • Docker utilizes the host resources better. • Docker files are lightweight, so MiR can therefore more easily distribute security patches and update packages. • Docker containers are easy to configure and set up. • Docker containers are very isolated and therefore very secure and robust. Using Docker makes distribution of security patches for the underlying Ubuntu 16.04 easier than with a virtual machine image. When a new security patch is released, the customer will down- load a new MiRFleet Docker file and overwrite their original installation with this file. This will replace the containers running MiRFleet in Docker, but their configuration of the Docker containers and MiRFleet will not be overwritten. MiRFleet Server Solution Getting started (en) 09/2019 - v.1.0 ©Copyright 2019: Mobile Industrial Robots A/S. 11 3. Installing Software • No conflicting dependencies. Because Docker containers are very isolated, there is no risk of conflicting dependencies between MiRFleet Server and other applications you as a cus- tomer might need to run. • Better backups. All data from MiRFleet will be stored in a folder on the host system (the customers server). This is what is called a persistent storage. Which Docker version should I choose? The Docker version must be 18.09.01 or higher. Docker is available in two editions: Community Edition (CE) and Enterprise Edition (EE). Docker recommends Docker EE for business-critical applications in large scale production, and MiR also recommends Docker EE for running MiRFleet.