Configuring Web Apps
Basic Details
The Display Name field is used in Lifeboat to identify the Web App to both the user and internal services. Lifeboat will simplify the name leaving only alphanumeric characters (removing spaces!). This simplified name must be unique as it is used to name services on the server.
Select a domain that the Web App will respond to. All Web Apps must run at the root level of a domain, custom paths are not supported by Lifeboat. Selecting the "None" option will allow the app to run, but it will be unreachable externally.
Users with a Professional license can enable load balancing by changing the number of running instances to be greater than 1.
Changes are not applied until the Web App is staged. The "Stage" button is essentially "Save & Apply"
Live App Files
The Live App Files tab is visible when working with the configuration for a Web App that has been deployed. This view allows developers to see what files are currently live on the server.
Upload App
This tab is a drop zone for uploading files to the server. Drop the build folder Xojo creates inside of /Builds - MyApp/Linux 64 bit/ onto the drop zone to upload a new web app or update an existing one. After dropping a build folder Lifeboat will scan the contents and attempt to identify the executable.
The checkbox in the list indicates which file is the main executable. Please be sure the correct executable is selected.
When configuring a new web app the Upload App files list must not be empty. To update an existing app supply a new build before staging. When changing only the configuration of an existing app it is not necessary to supply a new build.
To ensure user data is retained through updates do not store user data files next to the executable. Best practice is to store user data in a unique child folder of SpecialFolder.ApplicationData. Using the bundle identifier is a good way to handle this.
var fData as FolderItem
fData = SpecialFolder.ApplicationData.Child("com.mycompany.myapp")
if not fData.Exists then
fData.CreateFolder
end
Advanced Options
To activate the Environment Variables and the Advanced Options tabs, select the "Enable advanced Web app options" checkbox from the Preferences window.