SOP-42Q-MES0095 AppGarden Quick Guide

42Q Home > Tools > App Garden Quick Guide

 

Tools App Garden Quick Guide Version MES15.3.3 Portal 1.0 Work Instruction 

 

This Work Instruction is 42Q's corporate standard.
This document is under revision control. The latest revision is located on Intranet.
Once printed it is an uncontrolled copy. All alterations to this work instruction require approval.
Contact the IT Global Education and Training Department to submit suggested alterations and or updates.

This edition applies to MES15 Portal 1.0 and all subsequent releases and modifications until otherwise indicated in new revisions.

Introduction

AppGarden is 42Q’s solution to manage and ensure compliance concerning the applications that may run on its Android tablets on the shop floor. This document explains the primary functions in AppGarden. It is assumed that the user has a tablet with AppGarden installed.

In order to control permissions for tablet users, stream updates and configure the installation to tablet applications, therefore, 42Q provides three solutions to manage tablet use on the factory floor, the tools should be used together.

• APK “Android Package Maintenance” (MES Portal) : Serves as a repository for Android tablet applications

Android Application Package (APK) is the format for the installation and distribution of application software implemented by Android’s operating system. The MES development team has provided a mobile data collection solution that allows for manufacturing execution at the shop floor level through the use of convenient tablets. These inexpensive tablets provide mobility, flexibility, and scalability to increase productivity while decreasing overhead costs.

• Android Device Maintenance (MES Portal) : Manages the tablets.

Android Device Maintenance is the primary module for managing the tablets to which the Package Maintenance applications are pushed.

• AppGarden (Installed on every tablet) : Allows installation and updates on Android mobile devices

AppGarden APK is an Android management tool, which is used to manage APK installation and uninstall and updates on android devices, access and system information collection; this APK should be the last install after installing all/any other MES Android Applications.

For more information on Android Package Maintenance, Android Device Maintenance, and/or AppGarden solutions visit https://42qrpt1.42-q.com/mes_wiki/index.php/SOP-5-I-42Q-MES0106-C_42Q_APK.

 

Installation on Device

To install APK package follow the following steps:

Use File Manager of your own device to Install;

Click File Explorer of your own device to locate your SD card or USB for AppGarden APK installation package and double click to install.

Figure 1: AppGarden Main Tablet Screen

Select the AppGarden APK, users could turn on the “Delete Installer Package” checkbox and click Install.

Figure 2: AppGarden Delete Installer Package

Click Confirm.

Figure 3: AppGarden App Installed

With AppGarden installed, users can click Done or Open on the AppGarden directly.

Figure 4: AppGarden Permissions

AppGarden Features

1. "Password Protection" which restricts anyone to exit this AppGarden unless a password has been entered.

Figure 5: Password Protection

2. Auto Starts when Android devices boot. Once booted, the devices will always go to AppGarden, just like an enterprise environment, unless click “Exit Appgarden”.

Figure 6: Exit AppGarden

3. Show the Asset No, Name, Group, Plant, Device Type, Sync-Time, Service Host, current IP address by clicking the “Information” tab.

Figure 7: App Information Icon

Selecting Information from the main menu displays the specifications for the tablet and its respective configuration with regards to 42Q. The information that is listed includes

• Asset No: The asset number of the device unique to the group

• Name: The name given to the device.

• Group: The group to which the device was added.

• Plant: The plant where the device operates.

• Device Type: Designates the type of device.

• Sync Time: Designates the Sync interval (in minutes) for the device.

• Service Host: Designates the Service Host IP.

• IP Address: Represents the IP used by the device.

 

Figure 8: App Information

Figure 9: App System Setting

4. Show the Android system settings by clicking the “System Setting” tab.

The main menu contains the following selections:

• Information
• System Setting
• Exit AppGarden
• Re-register Asset No.
• Delete Installation Files
• Close

NOTE: Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.

Figure 10: App Settings

5. Get Started register Asset NO. by clicking the “Re-register Asset No.” tab, e.g. portal-uat.42-q.com.

Figure 11: Re-Register Asset

Re-register Asset No.

This function allows the plant administrator to re-register the Asset Number for the device. This feature applies to when the plant administrator needs to connect the device to a different MES Portal server, or when the Asset Number that was previously registered is incorrect. To use this function, enter the Service Host in the initial field provided and select the arrow icon to the right of the field to confirm the entry. A new field appears directly below the Service Host field. In the new field enter the Asset Number. The user is then directed to the User Info screen where the status of the Asset Number is given, along with the Asset Number itself and its respective Name, Group, Plant, and Device Type.

Figure 12: Get Started

6. The APK Installation files could be deleted by clicking the “Delete Installation files” tab.

Figure 13: Delete Installation Files

In the process of air deployment there will be installation files that are downloaded to the table to be initialized at a scheduled time. It may be preferred, however, that these files be deleted in order to save space or because an error occurs during the download of the installation files. The Delete Installation Files function allows the user to delete these files. To perform this action, simply select Delete Installation Files from the AppGarden menu. The message, “Delete installation files completed!” appears at the bottom of the screen.

Figure 14: File Browser

There are some indicated shows on the Appgarden screen, such as the Service Host, Asset No., Latest network time, Latest heartbeat time, Download Task, Remove Task, Device Time, Submit Time, and the download status indicate: PSI download finished, please wait. For more details please refer to <a href="https://sanmina.atlassian.net/browse/PAR-1327">https://sanmina.atlassian.net/browse/PAR-1327</a>.

Figure 15: Indicators

AppGarden Login

1. Open the AppGarden application
2. First time users will enter the Service Host (i.e., MES Portal IP) to login into the field provided.

Note : Clicking the “H” button will show the latest 3 Host histories for returning users.

Figure 16: Get Started

NOTE: The new 2.05 version was updated to add a scanner and “H” host function.

Figure 17: Host Information

3. Select the arrow icon to continue to the next row to insert “Asset Number”.
4. Input the Register and Asset No. Fields, there is a scanner button beside that asset No. as well.

Figure 18: Enter Asset Number

5. We have added the Re-register Asset No. control on the Appgarden 2.05, if the tablet already registers an activated asset No v8., and when users try to register a new inactive asset No 92. it will pop up this message “Your device has already registered. Do you want to switch to a new asset No?“. Users can click ‘Register' to continue or click the 'back’ button to exit register a new asset No.

Figure 19 : Asset Already Exist Message

 

6. Click Register

Figure 20 : Register Page

7. Added below 6 indicated fields on the AppGarden home screen.

Figure 21: New Fields in the Home Screen

Note: Clicking the colorful icon located at the button right allows you to enter in a password to gain access into the application .

 

 

Login

To access AppGarden

1. Open the AppGarden application

2. First time users will enter the Service Host (i.e., MES Portal IP) to login into the field provided.

3. Select the arrow icon to continue to the next row.

 

Figure 1: Login

NOTE: The device asset number is added in the portal from the Android Device Maintenance sub-module, which is shown in the following image:

 

Figure 2: Android Device Maintenance (in Portal)

Upon logging into AppGarden, the user is directed to the AppGarden home screen.

 

Figure 3: AppGarden Home Screen

AppGarden Main Menu

When a user selects AppGarden from the AppGarden home screen, the AppGarden main menu appears. First time users may need to enter their AppGarden password.

 

Figure 4: Enter Password

 

The main menu contains the following selections:

• Information

• System Setting

• Exit AppGarden

• Re-register Asset No.

• Delete Installation Files

• Close

 

Figure 5: AppGarden Main Menu

Information

Selecting Information from the main menu displays the specifications for the tablet and its respective configuration with regards to 42Q. The information that is listed includes

• Asset No: The asset number of the device unique to the group

• Name: The name given to the device.

• Group: The group to which the device was added.

• Plant: The plant where the device operates.

• Device Type: Designates the type of device.

• Sync Time: Designates the Sync interval (in minutes) for the device.

• Service Host: Designates the Service Host IP.

• IP Address: Represents the IP used by the device.

 

Figure 6: Information

System Settings

Selecting System Settings directs the user to the device’s system settings hub, where, for example, options concerning network connectivity and accounts are selected.

 

Figure 7: System Settings

Exit AppGarden

Select this function to quit the AppGarden application.

 

Re-register Asset No.

This function allows the plant administrator to re-register the Asset Number for the device. This feature applies to when the plant administrator needs to connect the device to a different MES Portal server, or when the Asset Number that was previously registered is incorrect. To use this function

1. Enter the Service Host in the initial field provided and select the arrow icon to the right of the field to confirm the entry. A new field appears directly below the Service Host field.

2. In the new field enter the Asset Number. The user is then directed to the User Info screen where the status of the Asset Number is given, along with the Asset Number itself and its respective Name, Group, Plant, and Device Type.

 

Figure 8: Re-register Asset Number

Figure 9: Re-register Asset Number Information

 

Delete Installation Files

In the process of air deployment there will installation files that are downloaded to the tabled to be initialized at a scheduled time. It may be preferred, however, that these files be deleted in order to save space or because an error occurs during the download of the installation files. The Delete Installation Files function allows the user to delete these files. To perform this action, simply select Delete Installation Files from the AppGarden menu. The message, “Delete installation files completed!” appears at the bottom of the screen.

 

 

Document History

Date	Author	Title	Version	Change Reference
06/04/16	Dane Parker	Technical Writer	v 1.0	This is the first version of the AppGarden Quick Guide.
12/15/16	Martha Jordan	Technical Writer		42Q Format