Getting Started (En) Date: 01/2021 Revision: V.1.6 Copyright and Disclaimer
Total Page:16
File Type:pdf, Size:1020Kb
Getting Started (en) Date: 01/2021 Revision: v.1.6 Copyright and disclaimer All rights reserved. No parts of this document may be reproduced in any form without the express written permission of Mobile Industrial Robots A/S (MiR). MiR makes no warranties, expressed 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 document. Nevertheless, MiR assumes no responsibility for errors or omissions or any damages resulting from the use of the information contained. Copyright © 2019-2021 by Mobile Industrial Robots A/S. Contact the manufacturer: Mobile Industrial Robots A/S Emil Neckelmanns Vej 15F DK-5220 Odense SØ www.mobile-industrial-robots.com Phone: +45 20 377 577 Email: [email protected] CVR: 35251235 MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 2 Table of contents 1. About this document 5 1.1 Where to find more information 5 1.2 Version history 6 2. Warranty 8 3. Host and network requirements 9 3.1 Network architecture 9 3.2 Network requirements 10 4. Installing Software 12 4.1 What you need 12 4.2 Installing Docker 13 4.3 Configuring MiR Fleet Server Solution 16 4.4 Installing MiR Fleet Server Solution (Ubuntu/Red Hat Enterprise Linux) 19 4.5 FAQs 20 5. Getting Started 22 5.1 Updating robot software 22 5.2 Exporting a site file 24 5.3 Installing and activating your fleet 24 6. Commissioning 29 6.1 MiR Fleet interface 29 6.2 Adding robots to the fleet 30 6.3 Removing robots from the fleet 35 6.4 Importing a site file 36 6.5 Activating a site 37 MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 3 6.6 Setting up mission schedules 38 6.7 Creating groups 39 6.8 Setting up elevators 47 6.9 Setting up fleet dashboards 50 6.10 Enabling automatic charging and staging 52 6.11 Enabling Collision avoidance 55 6.12 Using Limit-robots zones 56 6.13 Using Evacuation zones 57 6.14 Resource handling 59 7. MiR Fleet API 66 7.1 Authentication 67 8. Maintenance of MiR Fleet Server Solution 69 8.1 Updating MiR Fleet 69 8.2 Updating robots 69 8.3 Docker maintenance 69 MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 4 1. About this document 1. About this document This guide describes how to set up MiR Fleet Server Solution and get started with the MiR Fleet interface. MiR Fleet is used to organize the operation of multiple robots, ensuring that they are all executing missions. As a MiR Fleet Server Solution user, you have received the following information to get started: • License ID and password • USB pen with MiR Fleet software and this getting started guide • Usernames and passwords for signing in to the fleet interface MiR Fleet Server Solution is an alternative to the physical MiR Fleet PC. MiR Fleet Server Solution makes it possible to run MiR Fleet on your own hardware and server systems. MiR Fleet Server Solution runs using Docker, a lightweight, simpler alternative to a virtual machine, so the first step in this guide is to install Docker. NOTICE Save this manual. It contains important setup and operating instructions. 1.1 Where to find more information At the MiR website, you can find the following resources under the Manuals tab on each product page: • Quick starts describe how you start operating MiR robots quickly. It comes in print in the box with the robots. Quick starts are available in multiple languages. • User guides provide all the information you need to operate and maintain MiR robots and how to set up and use top modules and accessories, such as charging stations, hooks, shelf lifts, and pallet lifts. User guides are available in multiple languages. • Operating guides describe how to set up and use MiR accessories or supported functions that are mainly hardware-based, such as charging stations and shelf functions. • Getting started guides describe how to set up MiR accessories that are mainly software- based, such as MiR Fleet. MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 5 1. About this document • Reference guides contain descriptions of all the elements of the robot interface and MiR Fleet interface. Reference guides are available in multiple languages. • Best practice guides specify how much space MiR robots need to execute common maneuvers. • REST API references for MiR robots, MiR hooks, and MiR Fleet. HTTP requests can be used to control robots, hooks, and MiR Fleet. • MiR network and WiFi guide specifies the performance requirements of your network and how you must configure it for MiR robots and MiR Fleet to operate successfully. 1.2 Version history This table shows current and previous versions of this document. Revision Release Date Description SW 1.0 2019-30-07 First edition 2.5.0 and higher 1.1 2019-20-12 Second edition 2.7.9 and higher 1.2 2020-01-12 Small corrections and modifications 2.8.0 and higher 1.3 2020-01-31 New network requirements section and small 2.8.0 and corrections higher 1.4 2020-08-05 Updated for 2.10.0 software 2.10.0 and higher 1.5 2021-01-15 Added sections: Removing robots from the 2.10.3.1 fleet and Using Limit-robots zones and higher Updated section: Using Evacuation zones General improvements throughout the document 1.6 2021-01-26 Docker Enterprise Edition replaced by 2.10.3.1 Mirantis Container Runtime. MiR now and recommends using Docker Community higher MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 6 1. About this document Revision Release Date Description SW Edition (CE). MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 7 2. Warranty 2. Warranty Mobile Industrial Robots offers a standard warranty on all products. Contact your distributor to see the terms and extent of product coverage. NOTICE Mobile Industrial Robots disclaims any and all liability if MiR Fleet Server Solution or its accessories are damaged, changed, or modified in any way. Mobile Industrial Robots cannot be held responsible for any damages caused to MiR Fleet Server Solution, accessories, or any other equipment due to programming errors or malfunctioning of MiR Fleet Server Solution. MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 8 3. Host and network requirements 3. Host and network requirements The specifications and requirements for running MiR Fleet Server Solution are: • Installation file size: 3 GB • MiR Fleet update file size: ~300 MB • Server requirements: Dual core processor with minimum 2.1 GHz clock • RAM: Minimum 8 GB • HDD: 80 GB • Virtualization software: Docker CE/EE 18.09.01 3.1 Network architecture MiR Fleet is able to communicate with MiR robots and with other devices once connected to the network. Within the network, it is also possible for other devices to connect directly to the MiR robots through their robot interface. All devices that need to communicate with MiR Fleet must be on the same network as MiR Fleet. Figure 3.1. MiR Fleet network architecture. MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 9 3. Host and network requirements NOTICE We discourage using the robot interface to control robots connected to MiR Fleet. You should only use the robot interface in the following situations: • The first time you add a robot to MiR Fleet. Use the robot interface to activate the correct site and to position the robot correctly on the map. • When adding markers or mapping. Use the robot interface to generate new maps or to detect markers. 3.2 Network requirements This section describes the network requirements for MiR Fleet Server Solution. For more details on network requirements, contact your distributor the MiR Network and WiFi Guide . MiR robots require a constant, stable network connection for MiR Fleet Server Solution to function. An unstable connection can lead to missions and resources not being assigned to robots, causing deadlocks and idle robots. MiR Fleet Server Solution must be connected to the network through Ethernet and must be in the same physical location as the connected robots. Geographical distance will cause delay between the fleet and the robots. The network should be capable of containing all robots, the fleet, and required devices. If there are enough IP addresses available for all devices, the network can be used. Wireless LAN The requirements for the WLAN are: • Minimum bandwidth of 1 Mb per robot with a maximum latency of 150 ms. The network should be monitored over time to see how the bandwidth is affected during normal working hours. MiR Fleet Server Solution Getting Started (en) 01/2021 - v.1.6 ©Copyright 2019-2021: Mobile Industrial Robots A/S. 10 3. Host and network requirements • Signal strength not less than -75 dBm and a signal to noise ratio of 20 dB measured from the robot's perspective. If you experience issues, the signal strength can be measured using specialized instruments. Any network consultant company will be able to help with this.