SES imagotag E00001 digital network transceiver User Manual Quick Start Guide

imagotag GmbH digital network transceiver Quick Start Guide

Contents

Quick start guide

1.1 System requirements ................................................................................................................................. 8 1.2 Installation process .................................................................................................................................... 8 2.1 Starting ESL Server ................................................................................................................................... 10 2.1.1 Example articles ....................................................................................................................................... 10 2.2 Starting ESL Client .................................................................................................................................... 11 2.2.1 ESL Client Login ........................................................................................................................................ 12 2.3 Starting Template Editor .......................................................................................................................... 12 3.1 Connect and configure ............................................................................................................................. 13 3.1.1 Discover the Access Point ........................................................................................................................ 13 3.2 Necessary configuration over the web-GUI ............................................................................................. 14 3.3 Necessary configuration at the ESL Client ................................................................................................ 15 3.4 Selecting channels .................................................................................................................................... 15 3.5 The Status LED .......................................................................................................................................... 16 4.1 General encryption features and how does it work ................................................................................ 17 4.2 Set the key ................................................................................................................................................ 18 5.1 General procedure ................................................................................................................................... 19 5.2 What's on the label? ................................................................................................................................ 19 5.2.1 Labels before and after registration ........................................................................................................ 20 5.3 Handheld terminals, USB barcode scanner and iOS-App ......................................................................... 21 5.4 Encryption status ...................................................................................................................................... 21 5.5 Unlocking labels ....................................................................................................................................... 22 6.1 What can I do now? ................................................................................................................................. 23
6.2 Sending pictures to labels ........................................................................................................................ 23 6.3 Article management ................................................................................................................................. 24 6.3.1 Import articles .......................................................................................................................................... 24 6.4 Matchings ................................................................................................................................................. 27 6.5 Templates ................................................................................................................................................. 29 6.5.1 General information about templates ..................................................................................................... 29 6.5.2 Template Editor ........................................................................................................................................ 29 6.6 Integration ................................................................................................................................................ 32 6.6.1 Webservice integration ............................................................................................................................ 32 6.6.2 CSV/XML import ....................................................................................................................................... 32 6.6.3 Custom integration .................................................................................................................................. 32 1.1 Running the ESL Server as a background service ..................................................................................... 34 1.2 Deleting the demo articles ....................................................................................................................... 34 1.3 Establish a network configuration when no DHCP is available – Step by step ........................................ 34 1.4 AP discovering with Bonjour Services ...................................................................................................... 35 1.5 What can I do if the Status LED of the AP-2010 access point doesn’t turn blue? ................................... 35 1.6 Labels don’t come online ......................................................................................................................... 35 1.7 The encryption does not work ................................................................................................................. 35 1.8 Unlocking labels ....................................................................................................................................... 35
An electronic shelf label is a device that shows article data and price information on its display. In comparison to printed labels the information is automatically updated if price or article data changes. Figure 1 - Electronic Shelf Labelling Cost reduction through elimination of manual price changes Fully automatic price updates from the headquarters to the branch stores within seconds Process security and price integrity – 100% correlation between cash point and shelf Increased flexibility in price design and immediate reaction to market situation Image gain due to use of highly modern technology Simplified processes for store personnel Enhanced sales & price profitability maximize price performance and profit opportunities The imago G1 electronic shelf label family offers high-quality display options, operating with a replaceable battery and thus working with any external power supply. The current line-up has display sizes from 2 inch to 7.4 inch. They may be used in landscape and portrait mode and can be customized with changeable front covers. Caption Label-ID Display resolution DPIs Display colors Useable Pages imago G1 2.0 A1xxxxxx 200 × 96 111 dpi Monochrom (1 bit) 8 imago G1 2.7 B3xxxxxx 264 × 176 117 dpi Monochrom (1 bit) 8 imago G1 4.4 C1xxxxxx 400 x 300 113 dpi Monochrom (1 bit) 12 imago G1 7.4 D1xxxxxx 480 x 800 126 dpi Monochrom (1 bit) 12
Figure 2 - Smart Box Outside The imago G1 electronic shelf label family offers high-quality display options, operating with a replaceable battery and thus working with any external power supply. Thanks to the perfect readability of the e-Ink displays and our outstanding wireless data transmission technology you can implement all your sales, marketing, and logistic strategies. The AP-2010 by imagotag is the communication center in the store that transmits price information to the labels. Up to 10 000 labels can be managed per access point and the self-organizing network allows automatic roaming of labels without manual handling. The high transmission rate of the 2.4 GHz wireless technology and the intelligent task scheduling enables fast and secure updates on imago G1 labels of all sizes. The access point communicates with the electronic shelf labels with radio frequency on the 2.4 GHz ISM band with a proprietary protocol developed by imagotag. It supports 11 selectable channels. : The ESL server is a Java software that is required to manage the imagotag access points and electronic shelf labels. The ESL server may be executed as a background service on a Windows or Linux machine in the store and does not provide a graphical user interface. : The ESL client is also Java based software. It’s a graphical user interface (GUI) for monitoring and for the configuration of the ESL server. The ESL client connects to the ESL server. The server may be installed on the same machine or any other machine that is accessible over the network. : To render images from article records on the ESL server, the layout must be predefined in a template file. During the rendering process the data will be inserted into the fields reserved to hold this data. Templates are based on web standards (XML, XSL, XPath, CSS) and an proprietary XML based markup language. Therefor an editor to create and edit template files with live preview based on example records is also on the imagotag USB stick.
: Developer Reference, Image Rendering Reference and CSV/XML Import Plugin Metal Mounting Plate for Mounting the AP-2010 on Walls, Ceilings or other Mounting-Rails. With our flexible system you’re able to mount your labels almost wherever you want. Power Plug to supply power for the AP-2010 (Power over Ethernet is also available). Figure 3 - Smart Box Inside
As described above, the USB stick contains several software, so you’ll have to install (you’ll just have to unpack 3 archives) the following: (1) ESL Server <server.zip> (2) ESL Client <client.zip> (3) Template Editor <template.zip> Server hardware: Pentium 4 (2 GHz or higher), 2 GB RAM Java Runtime Environment Version 6, Update 36 Windows XP, Windows 7, Windows Server 2008 (R2), Suse Enterprise Linux 11, Ubuntu 12 (all 32/64-bit versions) imagotag Server/Client applications (2x .zip archives) imagotag AP-2010 imagotag Labels and license files Please unpack the zip-archives <server.zip>, <client.zip> and <template.zip> on your machine - e.g. under C:\imagotag\. : To unpack the zip-files you can either use the windows internal archive-unpacker (see screenshots) or an unpack tool of your choice (e.g. the free tool 7zip – www.7zip.org). Figure 4 - Unpack/Install imagotag Software #1 Figure 5 - Unpack/Install imagotag Software #2
After unpacking all 3 archives, your folder should look something like this: Figure 6 - Unpacked imagotag software folder That’s it, the imagotag software is now installed and you can step forward to point 2 - Start Server and Client.
In order to start the ESL Service with the default configuration, just execute the jar file “server.jar” as described in [Troubleshooting] 2 - Starting Java applications and wait for the small service GUI to show up (if the window doesn’t show up after all, make sure your Java installation and configuration is correct). Figure 7 - ESL Service GUI The service will listen to TCP connections on Port 8000 and 8001 and UDP connections on Port 8000. Please make sure that there is no firewall issue and/or interference with other systems. After start of the service you can check the web-GUI of the server: URL: http://<IP-address>:8000/ Login: admin/admin During the first start the ESL Server will automatically create a Derby1 database. If another database connection is needed or preferred, the connection parameters should be validated by imagotag. : As you can see there are several level numbers, by default the server instance will start in level 3. You can find the description of the different levels in the Developer Reference (which is also included on the USB stick) under “Integration Levels”. For easier usage some example articles will be preloaded at the time you start the ESL Server. You can find them here: C:\imagotag\server\data\fixtures\. : The article records are based on the XML-standard. 1 Apache Derby, an Apache DB subproject, is an open source relational database implemented entirely in Java
Navigate to the unpacked client directory (see point 1.2 on how to unpack the software package) and execute the “client.jar” file (see [Troubleshooting] point 2 on how to start a jar file). Figure 8 - Starting ESL Client The client is configured to connect to a server on the local machine per default. In order to change this to a remote machine in a network you have to start the client with an additional parameter: Windows Create a shortcut/Edit existing short cut Append “ --host hostnameOrIPAddress” at the end of the “Target” field. ( : The text to append starts with an space and there are 2 hyphens to add!) Linux Append “ --host hostnameOrIPAddress” at the end of command (e.g. “java -jar client.jar --host 192.168.1.100” : The text to append starts with an space and there are 2 hyphens to add!) Figure 9 - Starting ESL Client with parameter
Username: admin Password: admin Figure 10 - ESL Client Login Navigate to the unpacked template directory (see point 1.2 on how to unpack the software package) and execute the “template.jar” file (see [Troubleshooting] point 2 on how to start a jar file). Figure 11 - Starting the Template Editor
The AP-2010 by imagotag is the communication center in the store that transmits price information to the labels. In order to ensure the communication between ESL server, access point AP-2010 and the labels the access point has to be configured at the start of the ESL Server. One way to configure the access point is on the client. Figure 12 - ESL Client Access Point Configuration Before labels are able to communication with the server at least one access point needs to be configured. In standard configuration the AP-2010 should get an IP-address via DHCP (recommended) and is accessible via web-GUI: URL: http://<DHCP-IP-address> Login: admin/admin : In this part of the Quick Start Guide it is assumed that a DHCP server is present (you can find the steps to discover the access point without DHCP in the [Troubleshooting] section at points 1.3 and 1.4). Before you can configure the access point it’s necessary that the server will discover it. The following points have to be observed:
Connect your machine to the same network as the AP Plug in the power supply of the access point During the boot process of the access point, start the ESL server software on the computer (see point 2.1) When the access point is booted up, the server will discovery it with an IP address ( : The discovering process may take up to 2 minutes) Use the ESL client to connect to your ESL server Under System – Access Point Status – the AP should be listed as discovered (after successful boot sequence) One Column of the AP should show now the IP address Now you’re able to configure the access point via web-GUI under http://<DHCP-IP-address> or a right click on the discovered AP –> Open in browser… In the status overview you get some details about the AP-2010: Figure 13 - AP-2010 Status overview It’s recommended for the demo installation not to use the “Auto-Config” feature and configure the AP manually. The following actions need to be performed over the web-GUI (1) Deactivate Auto-Config: Administration -> Auto-Config (2) Set up network details (or leave DHCP): Administration -> Network (3) Set up a wireless channel: Administration -> Wireless The AP-2010 supports 11 wireless channels. It’s recommended to choose one of the recommended channels: 3, 5, 8, 9 or 10. These channels do not interfere
with standard Wi-Fi channels 1, 6, 11 and are scanned by the labels more often For further information about selecting channels see point 3.4. After the configuration in the web-GUI it’s necessary to add this AP via the ESL Client: System -> Access Point Configuration -> New … Figure 14 - ESL Client AP configuration - System -> Access Pont Configuration -> New Choose “Manual Configuration” if you don’t use Auto-Config and enter Access Point ID (AP ID) and IP address (Host). : After the basic configuration in the web-GUI, it is also possible to fill in AP-ID and AP-IP-Address automatically. For this choose "Create Configuration..." under System - Access Point Status - Right click on the discovered and configured Access Point. After saving the AP configuration you should see the AP under System -> Access Point Status as ONLINE. In addition the AP status LED should turn . For a working installation a channel must be selected on each access point in the network. There are 11 non overlapping ESL channels reserved for the communication with the labels. Five of these channels do not interfere with typical Wi-Fi installations and should therefore be favored. These are
the ESL channels 3, 5, 8, 9 and 10 and they should be selected if there is a Wi-Fi installation on the Wi-Fi channels 1, 6 and 11. Figure 15 - Visualization of used channels of the imagotag AP-2010 If there is a Wi-Fi installation operating at 2.4 GHz (IEEE 802.11b/g/n) or any other radio frequency (RF) technology that uses the 2.4 GHz ISM band make sure to select the ESL channels that are least overlapping with the existing installation. If there is no ESL channel without any overlapping both the ESL and existing installation should still work but there might be a reduced overall speed in both installations. Warning: Do not select the same channel on two access points within one area. This will cause interferences and avoids labels from joining the network. The same channel may only be selected on two access points if it can be guaranteed that every label is within the range of only one of these access points. There are several LED colors that indicates the main status of the access point. Color Description Note Red Boot process Can take about 2 minutes, if it takes much longer, the device is defective and there is a need for service. Blue Normal mode --- Yellow Operational, but not connected to any server or no channel selected --- Red (blinking) Running Firmware Update During this time there is no connection to the electronic label If there are any problems regarding the access point please see point 1.5 in [Troubleshooting] section.
The security concept is based on individual registration codes for each label. Not only that the new concept simplifies installations, it also provides stronger encryption and a secure key exchange with individual communication key derived from a user defined network key. Solid improved safety Encrypted data type AES128 (Advanced Encryption Standard) User defined 128 bit network key for each installation Key is distributed to labels automatically The new system requires a user defined 128 bit network key for each installation. The key is derived from a passphrase that is defined by the customer and stored in the imago gateway and used by all access points connected to that gateway to encrypt data communication to the labels. A per-label communication key is transmitted to the labels during the registration of them. Each label is assigned an individual registration code (it combines label ID and PIN code and it’s an alphanumeric case-sensitive code with 11 characters). The imago gateway will than automatically start the key exchange with the label secured by the PIN extracted from the registration code.
First step is to set the parameter “encryptionPassphrase“ under System – Configuration (you can choose the encryption Passphrase on your own). Figure 16 - Set encryption key : Do not change encryption passphrase if labels are already connected and encrypted (if you want to change the encryption passphrase you’ll first have to unlock all labels – see [Troubleshooting] point 1.8).
In order that labels can join the network it is necessary to register them first. Via the ESL Client under File -> Register Labels it’s possible to register your labels manually with the registration code shown on each single label or you could import a CSV file with your registration codes. In order to refresh the entries press the refresh button shown in Figure 17. : After the registration it could last a certain time until all registered labels are joined to the network (from 30 minutes up to two hours, depending on configured access point channels). After this you can send images to each label (see Start tagging). Figure 17 - Add/Delete Label and refresh entries All labels will arrive with its registration code shown on the display of the label. The code is printed as a 2D QR code, as a 1D Code128 barcode and as human readable text. The registration process for the customer is easy – he has only to scan one of this barcodes. The imago gateway will than automatically start the key exchange with the label secured by the PIN extracted from the registration code.
Imago G1 2.7 Imago G1 4.4 Before registration Successful registration (key set, active encryption) Here you can see the registration dialog in the ESL Client where one single label has been entered with the registration code and the other one with the label ID (for old label versions < 3.0.0). Figure 18 - Register labels dialog (registered with registration code and label ID)
: New versions of the imago gateway, client and access point (≥ 1.3.0) will also support old labels that do not come with a pre-programmed PIN code. New labels (≥ 3.0.0) will also work in old installations together with old labels but the gateway will not accept registration codes during the registration process. To register the labels it is required to scan the barcode with the label ID from the backside or the bottom edge of the label. As the gateway will not start the key exchange all data is transmitted unencrypted to the labels. It’s also possible to register labels with a commercial USB barcode scanner (2D/1D). You can also use our iOS-App (for iPhone and iPod touch, only available on request). Handheld terminals are mobile devices that are used to manage the ESL installation. If the handheld provides a barcode scanner, it may be used easily to link articles and labels by scanning the article barcode (usually EAN, UPC or GTIN) and the unique ID of the label. Here you can see some screenshots of our iOS-App: Figure 19: ESL-App Home-Screen Figure 20: ESL-App Registration Page Figure 21: ESL-App Matching Page Here are the encryption status a label could have: AES: Communication with label is encrypted with 128 bit AES No PIN: Could not set encryption key as no PIN (registration code) was provided o Solution: Re-register label with registration code Key unset: Communication is NOT yet encrypted o Solution: Set encryption key as described in section 4 - Set encryption key Unsupported: Encryption is not supported by label firmware Unknown: Security status is not determined yet
Figure 22 – Encryption status If the label was registered and a communication key was set it will no longer work in other networks using a different network key passphrase. To unlock this labels for other networks an unlock code is required. The unlock code is similar to the registration code - it is a combination of the label ID and a 128 bit PUK code. Via ESL Client select File – Unlock labels and enter the unlock key. Figure 23 - Unlock Labels Dialog : The unlock-code for the specific labels is enclosed in the Smart Box (in an envelope).
As soon as labels are online you can do several things: Send image to label Assign tags Show the current image Ping label Reset label (reset display to show label ID and label ID barcode) Refresh display Switch to a preloaded page Create a new matching … 1) Right click on one or more labels -> Send image… 2) Select a picture ( : Display size must match the resolution of the image – see imago G1 label family on page 5) a. In the right pane, a priority (currently not relevant) could be set for the task, as well as the Page to which the image should be sent and whether the image is preloaded. b. When preloading, the image is placed in the memory of the label, but not yet displayed. The image change will only be performed after the change to the relevant page. This allows for each label that images are cached on the various pages and be accessed quickly by switching to the relevant page. 3) By clicking on “open” the corresponding task(s) for the label(s) will be created and the transfer begins. Figure 24: Send image to label
For complete management of your articles select Articles – All Articles in the ESL Client. Here you’re able to create/delete and edit your articles. The Smart Box comes with 4 predefined articles which you can see here. You can add some more demo articles, edit the existing ones or just step further to the next point Matchings. Figure 25 - Article management There’s also the possibility to import articles from a *.CSV-file. For this, there are a few points to consider: The CSV file should always be written with UTF-8 encoding. Depending on the configuration in “../server/config/articles.config” the CSV to import should look like this: o articleNumber;gtin1,gtin2,gtin3..;name=<name>;price=<price>;field1=<field1>;field2=<field2>;field3=<field3>;… Where the last 3 fields (field1, field2, field3) are custom fields specified in the “../server/config/articles.config” and every line the CSV file corresponds to one article.
Figure 26 - How the article.config looks like in the Smart Box installation The article number field is mandatory, every other field is optional an can be left empty (e.g. 100000;;;;;;). o : If you add an article via ESL Client, price and name will be mandatory The order of the first 2 fields articleNumber and gtin in the CSV file is essential. The order of the other fields is not essential since they are identified by their fieldname (e.g. name=<name>, price=<price>). Figure 27 - Example for an article import CSV-file Finally, to import the created CSV-file select Import – Import articles in your ESL Client.
Figure 28 - Importing articles via ESL Client : In order to refresh the entries press the refresh button or F5 Figure 29 - Imported demo articles
6.3.1.1 Field description Name Description articleNumber Unique id of the article. This field is mandatory. gtin1,gtin2,gtin3.. GTIN is the global trade item number of an article. For an article there can be multiple GTINs specified. The numbers must be valid GTIN codes (for more information see http://en.wikipedia.org/wiki/Global_Trade_Item_Number) name The name field of the article price The article’s price with “.” (dot) as decimal separator. field1;field2;field3… A list of custom specified fields. The logical link between an article and the label that shows the article information and price of this article is called matching. With a matching the layout of the image rendered for the label is also defined by specifying the name of a template. In a more technical way a matching is the triple of: Label ID Article number or GTIN Name of the template file : Only one matching per label is allowed but a single article may be matched to more than one label.
Select File – New matchings to open the dialog where you can select the desired data records and create a number of matchings at the same time. Figure 30 - New matchings dialog Another way to create/edit matchings is under “Matchings – All Matchings”: - Select the desired data records (Label ID, Article Number) in the following window “New Matching Record“ (either manually or with the magnifying glass symbol). Select an appropriate template via “Template” that should be used to generate the image. - Confirm your choice by clicking Save. After that, the generated image is sent to the selected label. Figure 31: Create a matching
It’s also possible to create Matchings with ESL Client under Labels and Articles, for this just select the desired article or label, right-click on it and select “New matching…” (the new matching dialog will be pre-filled with the article or label information). The template is used to specify the fields, which should be rendered into the image. The ESL Server can handle multiple templates. The image rendering process is based on XSL (EXtensible Stylesheet Language) templates. The individual image for the label is then generated by applying the template to a XML, which is based on the properties of the label and is expanded by a custom XML from the user. The following steps are executed when processing a template: - Generating a record XML based on the label/task information and custom information provided by the user - Applying the template (XSL) on the generated record XML. This results in a document containing the fields, specified in this reference and values referenced from the XML - Rendering the image (*.PNG) based on the previous output ...<!-- Name--><text font-weight="bold" font-size="14"> <xsl:value-of select="Article/Name"/></text>...<!-- Price --><text align="right" font-size="60"> <xsl:value-of select="Article/Price"/></text>...<Article articleNumber="9002490100070"> <Name>Red Bull<Name/> <Description>Dose 250 ml</Description> <Unit>1 l</Unit> <Price>1.39</Price> <PricePerUnit>5.56“</PricePerUnit></Article>TemplateArticle (XML document)Rendered Image+ = Figure 32: Input and result of the rendering process In order to use our rendering engine you must know our template language which is basically XSL. We do also have a template editor with live preview, but you need a little bit time to setup everything and get familiar with it. Therefore we suggest to send pre-rendered images to labels (right-click on a label -> send image) which you can create with every image manipulation software you want (e.g. Gimp, Photoshop, Paint, …). You can even take some pre-rendered images from us for each label type with the correct resolution as a template – you’ll find some in the client’s directory under data/images. 6.5.2.1 Open default template-file and load records from server: Open the Template Editor by clicking the “template.jar” file located in the template-directory (In our example it should be C:\imagotag\teamplate\). Next step is to create a new template file or to open an existing one (The default.xsl template file is located in the server-directory under C:\imagotag\server\data\template\).
To get a live preview you’ll have to load some records, in our case we load the demo article records from our running server, see the following figure. Figure 33 - Load Records from Server After these steps your Template Editor window should look something like this: Figure 34 - Template Editor with loaded records from server and default.xsl template file 6.5.2.2 Design Mode You can enable the graphical template editor by selecting Settings – Configuration – tick Enable Design Mode and finally the Save-button.
Figure 35 - Enable Design Mode in Template Editor After enabling the Design Mode a new tab will show up. Figure 36 - Template Editor Design Tab
6.5.2.3 Help Content There’s a link to the Help content for the template editor, open it by clicking Help – Help Content in the Template Editor or open the file index.html located in C:\imagotag\template\help\. Also you can find further information on the USB Stick under Documentation - Image Rendering Reference. The ESL server provides access to its interfaces methods through a RESTful web service API. The web service is designed according to the “Representational State Transfer” (REST) architectural pattern. The ESL server listens for incoming HTTP web service requests on the TCP port 8001 by default. You can find further information about Webservice Integration on the USB Stick under Documentation - Developer Reference. We provide a CSV/XML plugin that is used for importing article information into the ESL Server. You can find further information about Webservice Integration on the USB Stick under Documentation – CSV/XML Import Plugin. For custom integration we provide a Plugin-Interface. Software development service is available from imagotag software development team or third-party integration partners. For pricing get in touch with our sales agents (sales@imagotag.com).
If you run into any errors during connecting or sending images to labels, please refer to the documentation included in the server. This documentation can be found in the web-GUI of the server under “Documentation”. - For problems updating the labels (error code column in labels window) refer to “Update Error Codes” or (task status column in labels window) refer to “Task Status” - For connection status problems refer to “Connection Status” - For label hardware errors (label error column in labels window) refer to “Label Error Codes” Code Problem Solution 1 Label not licensed The label is not licensed. Import the proper license file for the label or check for typos in the label id. 3 Label not registered The label may have been deleted or has never been registered at all. Register label. 10 Image does not match display size The size of the image does not match the label’s display size. Please check the width and height of your image and look up the display size in pixels for the label. These sizes have to be equal. 11 Error during image rendering Check template (wrong or faulty) 12 Error during image conversion Change format of the image to standard format (e.g. PNG or BMP) 13 Invalid page Page not supported by label type, choose a different page 14 Could not process task because there are unfinished tasks waiting for this label Abort task or wait until unfinished tasks are finished 20 Template not found Check template directory for missing template file 21 Error during template parsing Correct template file (Invalid content found) 22 Error during content document creation Check server and article record configuration 30 Could not send update because label has insufficient power to perform the update The power status of the label is “Bad”, which means it is very low on battery that in may not accomplish the display update. Replace the battery of the label. 62 HTTP communication error with the access point The server was not able to send the task to the Access Point. Please make sure that the Access Point is not offline (System -> Access Point Status) and there is an established network connection between Access Point and Server. 80 Error while writing task to database Check database connection 92 Task type not supported Upgrade AP software to process this kind of task
The ESL server may be started as a normal application, but on a productive system it is usually required to have it automatically started without a user logged in. To achieve this the ESL server can be registered as a Windows service. It is than started automatically without any graphics user interface. To install the ESL server as a Windows service the batch file install_service.bat is provided. If this file is executed with administrator privileges (Right click – Run as Administrator) it will install the ESL server installation from the same directory as a Windows service with the name ESL_SERVICE. The file uninstall_service.bat will remove the Windows service if executed with administrator privileges. In order to prevent the example articles from being re-added to the server, remove the file “server/data/fixtures/article.xml”. You’ll also have to delete the demo articles shown in the Articles-section at the ESL Client. 1. Set a laptops Ethernet adapter to DHCP 2. Turn off all other network adapters (Wi-Fi) 3. Connect to the same network as the AP-2010 (use a common Ethernet cable to connect your device directly with the AP-2010) 4. Start local ESL Server on laptop 5. Use the ESL client to connect to your local server 6. Under System – Access Point Status – the AP should be listed as discovered (after successful boot sequence – may take up to 2 minutes) o Press F5 on your keyboard or the refresh button in the ESL client to refresh the access point status (the Client doesn’t refresh the status automatically!) 7. One Column of the AP should now show the IP address 8. Open a browser, type in http://<discovered-ip>:8080 or o at the ESL client perform a right click on the discovered access point – Open in browser – Maintenance – Status : Restart your access point if discovering process takes more than 2 minutes. Figure 37 - Reset/restart button
You still got problems to find your AP in your network? There's another workaround: You can use Apple's "Bonjour Print Services". Download and install “Bonjour Print Services“ for Windows (pre-installed under OSX): http://support.apple.com/kb/DL999 : After installation there’s no reboot required. If the access point is connected directly to the system where the “Bonjour Service” is installed (or on a network with running “Bonjour Service”) you can find the access point by typing the following in the browser of your choice: http://ap-<ID>.local:8080 (e.g. http://ap-12724.local:8080) : You can reach older versions of the AP with http://imagotag-ap.local:8080 (custom hostnames are only available on newer versions of the access point)  Check the AP status  Check AP configuration o No Channel set  Check network reachability of AP  AP registered to Server?  Reboot AP After the registration it could last a certain time until all registered labels are joined to the network (up to two hours, depending on number of access points and the channels used). Warning: A label must not be registered to multiple ESL server installations at the same time. It will only connect to one of this installations. Check the encryption passphrase in Server Configuration (System – Configuration). If label was already registered with a different passphrase you’ll have to unlock the label first in order to register it on the server. If the label was registered and a communication key was set it will no longer work in other networks using a different network key passphrase. To unlock this labels for other networks an unlock code is required. Select File – Unlock labels and enter the unlock key.
The unlock-code for the specific labels is enclosed in the Smart Box (in an envelope). If you have any further problems please contact the imagotag support (support@imagotag.com). Before starting a Java application, make sure you have Java Runtime Environment Version 6 or higher installed and you have set the necessary environment variables. If the .jar file extension is known and associated with Java, just double-click the jar file to start the application. Otherwise if the extension is not recognized: Windows: Create a shortcut of the jar file, right-click on it and open properties. Prepend “javaw.exe –jar“ to the path in the “Target” field. Double-click the shortcut. Linux: Navigate via command line to the directory where the jar file lies and execute “java –jar <filename>.jar” In case your environment variables are not set properly (e.g. javaw.exe/java command could not be found) do the following steps: 1. Locate your installation directory of your Java Runtime Environment 2. Set JAVA_HOME Variable Under Windows: - Right-click on “My Computer” and select “Properties” - Click the advanced tab - Click the “Environment Variables” button - Under “System Variables”, click New. - Enter the variable name as JAVA_HOME - Enter the variable value as the installation directory of your Java Runtime Environment - Click OK - Look for the Path variable in “System Variables” and edit it - Append a semicolon (;) and %JAVA_HOME%\bin to it - Click OK - Apply Changes Under Linux: - Use the “export” command to set your variables - export JAVA_HOME=<pathToJRE> - export PATH=$PATH:<pathToJRE>/bin - In order to make these changes persistent, write them into your .bash_profile file and use “source ~/.bash_profile” to apply the changes Please contact the support for further documentation: - Developer Reference (Web Service) - Image Rendering Reference - CSV/XML Import Plugin - FAQ

Navigation menu