Edge Linux Installation Guide V 4.5

Transcription

1 Edge Linux Installation Guide V 4.5

2 Table of Contents 1. About this Guide Pre-Requisites Installation Getting Started Licensing Online Activation Offline Activation Updating License Uninstallation Troubleshooting Stop the Tomcat service manually Start the Tomcat service manually Restart the Tomcat service manually... 14

3 1. About this Guide This document provides instructions on how to install, configure, and uninstall the Edge web application in Linux environment. 2. Pre-Requisites TerraGo Edge installation requires: Java To install the latest version of Java, run: yum install java openjdk. This will install Java Installation 1. To install the TerraGo Edge application, upload the installer at /root. 2. Go to /root 3. Run: chmod 777 TerraGo_Edge_Linux_Installer_v4.1.bin 4. Run the installation script:./terrago_edge_linux_installer_v4.1.bin 5. If you do not have Java in your system, you will be prompted to install Java. 6. To install the latest version of Java, run: yum install java openjdk. 7. Java is now installed.

4 8. Now, run the installation script:./terrago_edge_linux_installer_v4.5.bin 9. Enter 1 if you want to enable HTTP or 2 for HTTPS. Press Enter if you want to continue with the default selection. 10. In the Directory Name section, enter the name of the directory. The name that you give here will be displayed in the application s URL address. For example, if the directory name that you gave is edgeserver, then the application is launched with the following server URL:

5 Name}:8080/edgeServer. If the Directory Name is left empty, the application s URL address will be as: Name}:8080/ 11. Once the installation process is complete, TerraGo Edge application will be installed successfully. 4. Getting Started 1. Double click the Edge application icon in the desktop. 2. The Edge application is launched with the following server url: Name}:8080/directoryname/, where PC Name is the name of your computer, 8080 is the default port number, and directory name is the name that you gave during installation such as edgeserver. If the directory name was left empy during installation, the application will launch with the following URL: Name}:8080/ The ios devices (ipad/iphone) will access the Edge application through this server URL: Name}:8080/directoryname/ 3. Once the application opens, the first screen enables you to set the password for the Edge application with the default username admin. 4. Click the Next button to proceed.

6 Figure 1: Set your password 5. On this screen, you can configure the and server settings. 6. Enter your ID and Password, and click the Test button. Once your credentials are approved, the Next button is enabled. 7. You can now view the server connectivity details: Name}:8080/edgeServer/. You can edit it in the Setup your server URL field. 8. Click the Next button. Figure 2: and server settings 9. You can view and edit the and server settings by clicking the Settings icon on the menu bar.

7 Sever Settings: You can view and edit the server connectivity details on the Server Settings tab and click the Save Changes button. Figure 3: Server settings Settings: You can configure the settings on the settings tab. Enter the ID and Password. Click the Test button for approval of your credentials. Click the Save Changes button. Figure 4: Settings

8 10. The License status screen opens as shown below: Figure 5: License Status 11. To add a user, enter the following details on the User Management tab: First Name, Last Name, User Name, Address, Password, and Confirm Password. 12. In the Group Access field, select the groups to which you want to add the user. To add the user to all the groups, select the Select all option. 13. Select the Enable Mobile Access checkbox if you want to provide mobile access to the user. 14. Click the Add User button. An is sent to the user with the password and server URL to access the application. Figure 6: Add New User

9 15. To add a new group, on the Group Management tab, enter the group name and click the Create button. 16. To add or remove users to the group, click the gear icon corresponding to the group that you want to modify and select the Edit option. 17. You can modify the group name and in the Users field, select the users that you want to add to the group. To add all the users to the group, select the Select all option. 18. To save the changes that you made, click the check mark button. 19. To delete a group, click the gear icon corresponding to the group and select the Delete option. Figure 7: Edit group 20. Once you add the user, the User information & devices window opens as shown below: Figure 8: Add device to user 21. To add the devices that will be used by the user, click the Add device button. 22. Select the Device type and enter the Device name. 23. Select the Enable user locator checkbox if you want to track the location of the user. To disable the locator settings for the user, deselect the checkbox. 24. Click the Save Changes button. A licensing mail is sent to the registered mail ID with instructions for opening the Edge application in the ios devices (iphone, ipad).

10 25. To edit the user details, click the Settings icon corresponding to the user whose details you want to modify. Figure 9: Modify User and Device Settings 26. To add devices to the user, click the icon corresponding to the user to whom you want to add devices. 27. The User information & devices window opens displaying the Server URL, Username, Authorization code, Device type, and Device name as shown below: 28. The (Number of) devices remaining indicates the number of devices that you can still add to the particular user. 29. Click the Add device button to add a device to the user. 30. The Authorization code, Server URL, and Username will enable the user to access the mobile devices offline. Figure 10: Add device 5. Licensing You must purchase and update the license within the trial period for uninterrupted usage of the Edge application. To update your license and enter your product key, click the Settings icon on the tab bar and select the License and user admin option. You can do online or offline activation.

11 For any licensing issues, please contact TerraGo Support at or call Online Activation 1. Click the Purchase License button to purchase the product through the TerraGo Online Store. 2. After successful purchase of the product, the product key will be sent to the ID that you registered during the purchase. Figure 11: License Status 3. Click the Activate/Renew button and enter the product key that you received. 4. Now click the Update License button. The license is now activated. Figure 12: Online Activation

12 5.2. Offline Activation You can activate TerraGo Edge by calling TerraGo Support when you have connection restrictions limiting you from accessing the TerraGo Online Licensing Service. Please call us at with the lock code to obtain a license key. 1. Click the Go to Offline Activation link. 2. Call TerraGo Support at with the lock code to obtain a license key. 3. Enter the licence key that you received and click the Update License button. The license is now activated. Figure 13: Offline Activation 5.3. Updating License When you update the license information, an is sent to all the users with updated authcodes. 1. Once you update the update, a dialog box indicating that an with the updated authcode will be sent as shown below. 2. Click the Submit button.

13 6. Uninstallation To uninstall the TerraGo Edge application completely, you must uninstall both the TerraGo Edge setup and the PostgreSQL setup. 1. To uninstall TerraGoEdge, go to, cd /apps/edge 2. Now run,./terrago\ Edge\ Uninstaller 7. Troubleshooting 7.1. Stop the Tomcat service manually To stop the Tomcat service manually, use the following commands: To stop the Tomcat service: service tomcat7 stop To stop the Tomcat service: service tomcatwfs stop

14 7.2. Start the Tomcat service manually To start the Tomcat service manually, use the following commands by locating to the below directory: Locate to the directory: cd /apps/edge/terragoedgeserver/bin To start the Tomcat service:./startserver.sh Locate to the directory: cd /apps/edge/edgewfs/bin To start the Tomcat service:./startserver.sh 7.3. Restart the Tomcat service manually To restart the Tomcat service manually, use the following commands by locating to the below directory: To stop the Tomcat service: service tomcat7 stop To stop the Tomcat service: service tomcatwfs stop Locate to the directory: cd /apps/edge/ TerragoEdgeServer/bin To start the Tomcat service:./startserver.sh Locate to the directory: cd /apps/edge/edgewfs/bin To start the Tomcat service:./startserver.sh