Difference between revisions of "Deploying to Local Directory"

From Lianjapedia
Redirect page
Jump to: navigation, search
(Redirected page to Deploying to Local Directory v6)
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This page explains how to Deploy your Lianja App, database and Library files to make them available to the Lianja App Center or Lianja SQL Server on the same machine.
+
#REDIRECT [[Deploying to Local Directory v6]]
 +
 
 +
'''This documentation is for an earlier version.  For the [[Deploying to Local Directory v6|latest version see here]].'''
 +
 
 +
This page explains how to Deploy your Lianja App, database and Library files to make them available to the Lianja App Center, Lianja Cloud Server or Lianja SQL Server on the same machine.
  
 
==Default Directories==
 
==Default Directories==
Line 5: Line 9:
  
 
===Lianja App Builder===
 
===Lianja App Builder===
 +
====Windows====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||C:\lianja\apps
 +
|-
 +
|valign="top"|Databases||C:\lianja\data
 +
|-
 +
|valign="top"|Library||C:\lianja\library
 +
|-
 +
|}
 +
====Linux====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/opt/lianja/apps
 +
|-
 +
|valign="top"|Databases||/opt/lianja/data
 +
|-
 +
|valign="top"|Library||/opt/lianja/library
 +
|-
 +
|}
 +
====macOS====
 +
Prior to v6.0:
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/Users/<username>/Library/Application Support/Lianja/apps
 +
|-
 +
|valign="top"|Databases|||/Users/<username>/Library/Application Support/Lianja/data
 +
|-
 +
|valign="top"|Library||/Users/<username>/Library/Application Support/Lianja/library
 +
|-
 +
|}
  
 +
From v6.0:
 
{| class="wikitable" width="100%"
 
{| class="wikitable" width="100%"
!width="20%"|Files||width="40%"|Windows||width="40%"|Linux
+
!width="20%"|Files||width="80%"|Location
 
|-
 
|-
|valign="top"|App||C:\Lianja\apps||/opt/lianja/apps
+
|valign="top"|App||/Users/Shared/Lianja/apps
 
|-
 
|-
|valign="top"|Databases||C:\Lianja\data||/opt/lianja/data
+
|valign="top"|Databases|||/Users/Shared/Lianja/data
 
|-
 
|-
|valign="top"|Library||C:\Lianja\library||/opt/lianja/library
+
|valign="top"|Library||/Users/Shared/Lianja/library
 
|-
 
|-
 
|}
 
|}
  
 
===Lianja App Center===
 
===Lianja App Center===
 +
====Windows====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||C:\lianja\cloudserver\tenants\public\apps
 +
|-
 +
|valign="top"|Databases||C:\lianja\cloudserver\tenants\public\data
 +
|-
 +
|valign="top"|Library||C:\lianja\cloudserver\tenants\public\library
 +
|-
 +
|}
 +
====Linux====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/opt/lianja/cloudserver/tenants/public/apps
 +
|-
 +
|valign="top"|Databases||/opt/lianja/cloudserver/tenants/public/data
 +
|-
 +
|valign="top"|Library||/opt/lianja/cloudserver/tenants/public/library
 +
|-
 +
|}
 +
====macOS====
 +
Prior to v6.0:
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/apps
 +
|-
 +
|valign="top"|Databases||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/data
 +
|-
 +
|valign="top"|Library||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/library
 +
|-
 +
|}
  
 +
From v6.0:
 
{| class="wikitable" width="100%"
 
{| class="wikitable" width="100%"
!width="20%"|Files||width="40%"|Windows||width="40%"|Linux
+
!width="20%"|Files||width="80%"|Location
 
|-
 
|-
|valign="top"|App||C:\Lianja\cloudserver\tenants\public\apps||/opt/lianja/cloudserver/tenants/public/apps
+
|valign="top"|App||/Users/Shared/Lianja/cloudserver/tenants/public/apps
 
|-
 
|-
|valign="top"|Databases||C:\Lianja\cloudserver\tenants\public\data||/opt/lianja/cloudserver/tenants/public/data
+
|valign="top"|Databases|||/Users/Shared/Lianja/cloudserver/tenants/public/data
 
|-
 
|-
|valign="top"|Library||C:\Lianja\cloudserver\tenants\public\library||/opt/lianja/cloudserver/tenants/public/library
+
|valign="top"|Library||/Users/Shared/Lianja/cloudserver/tenants/public/library
 +
|-
 +
|}
 +
 
 +
===Lianja Cloud Server===
 +
====Windows====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||C:\lianja\cloudserver\tenants\public\wwwroot\apps
 +
|-
 +
|valign="top"|Databases||C:\lianja\cloudserver\tenants\public\data
 +
|-
 +
|valign="top"|Library||C:\lianja\cloudserver\tenants\public\wwwroot\library
 +
|-
 +
|}
 +
====Linux====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/opt/lianja/cloudserver/tenants/public/wwwroot/apps
 +
|-
 +
|valign="top"|Databases||/opt/lianja/cloudserver/tenants/public/data
 +
|-
 +
|valign="top"|Library||/opt/lianja/cloudserver/tenants/public/wwwroot/library
 +
|-
 +
|}
 +
====macOS====
 +
Prior to v6.0:
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/wwwroot/apps<br>Note: /usr/local/lianja/cloudserver is a symbolic link to /Users/<username>/Library/Application Support/Lianja/cloudserver
 +
|-
 +
|valign="top"|Databases||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/data<br>Note: /usr/local/lianja/cloudserver is a symbolic link to /Users/<username>/Library/Application Support/Lianja/cloudserver
 +
|-
 +
|valign="top"|Library||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/wwwroot/library<br>Note: /usr/local/lianja/cloudserver is a symbolic link to /Users/<username>/Library/Application Support/Lianja/cloudserver
 +
|-
 +
|}
 +
 
 +
From v6.0:
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|App||/Users/Shared/Lianja/cloudserver/tenants/public/wwwroot/apps
 +
|-
 +
|valign="top"|Databases|||/Users/Shared/Lianja/cloudserver/tenants/public/data
 +
|-
 +
|valign="top"|Library||/Users/Shared/Lianja/cloudserver/tenants/public/wwwroot/library
 
|-
 
|-
 
|}
 
|}
  
 
===Lianja SQL Server===
 
===Lianja SQL Server===
 +
====Windows====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|Databases||C:\lianja\cloudserver\tenants\public\data
 +
|-
 +
|}
 +
====Linux====
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|Databases||/opt/lianja/cloudserver/tenants/public/data
 +
|-
 +
|}
 +
====macOS====
 +
Prior to v6.0:
 +
{| class="wikitable" width="100%"
 +
!width="20%"|Files||width="80%"|Location
 +
|-
 +
|valign="top"|Databases||/Users/<username>/Library/Application Support/Lianja/cloudserver/tenants/public/data<br>Note: /usr/local/lianja/cloudserver is a symbolic link to /Users/<username>/Library/Application Support/Lianja/cloudserver
 +
|-
 +
|}
  
 +
From v6.0:
 
{| class="wikitable" width="100%"
 
{| class="wikitable" width="100%"
!width="20%"|Files||width="40%"|Windows||width="40%"|Linux
+
!width="20%"|Files||width="80%"|Location
 
|-
 
|-
|valign="top"|Databases||C:\Lianja\cloudserver\tenants\public\data||/opt/lianja/cloudserver/tenants/public/data
+
|valign="top"|Databases|||/Users/Shared/Lianja/cloudserver/tenants/public/data
 
|-
 
|-
 
|}
 
|}
  
==Deploy Worksurface==
+
==Deploying Lianja Web/Mobile Client Apps==
Using the Deploy Worksurface, you can compare the files in the Lianja App Builder directories with those in the Lianja App Center / Lianja SQL Server directories and copy any missing or modified files.
+
'''Preview live in browser''' generates the index.html, tablet_index.html and phone_index.html files, deploys script files and opens the App in the default browser.
  
[[{{ns:file}}:preview.png|150px|thumb|left|Preview Changes]]
+
Note: from Lianja v5.5 the Web App View, Tablet App View and Phone App View headerbar buttons have been removed.  When using '''Preview live in browser''', current browsers offer the option to emulate different devices.
Simply click the checkbox next to the file group or individual filename in the '''Deployment files''' explorer for the files you want to deploy. You can then preview the changes that will be made by clicking the '''Preview changes''' button in the Headerbar. These are displayed in the '''Deployment Files Preview''' windowHere I'm deploying a new database created in the Lianja App Builder.  After deployment it will be available to Lianja SQL Server and the Lianja App Center.  You can deploy databases, Apps and Library files in a single operation - just select the files in the explorer.  Note that if you are deploying an App, it needs to be ''Published'' or it will not be visible in the Lianja App CenterPublish the App by checking the [http://www.lianja.com/images/stories/tutorials/tiles/app_settings.png Published attribute in Settings].
+
 
 +
Remember that you should deploy the data and any required Library files using the [[#Deploy Workspace|Deploy Workspace]].
 +
 
 +
Click '''Preview live in browser'''.  It will generate and deploy the files for the App.   
 +
 
 +
[[{{ns:file}}:l55_previewbrowser.png|800px|left|border|link={{filepath:l55_previewbrowser.png}}|Preview live in browser]]
 
<br clear=all>
 
<br clear=all>
[[{{ns:file}}:confirm.png|150px|thumb|left|Commit Changes]]
+
 
 +
The login page will be displayed in the browser if you are not already logged in.
 +
 
 +
[[{{ns:file}}:l55_previewbrowser2.png|800px|left|border|link={{filepath:l55_previewbrowser2.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
Once logged in, the Lianja App Center is displayed.  Click the tile for the App.
 +
 
 +
[[{{ns:file}}:l55_previewbrowser3.png|800px|left|border|link={{filepath:l55_previewbrowser3.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
The App will be opened.
 +
 
 +
[[{{ns:file}}:l55_previewbrowser4.png|800px|left|border|link={{filepath:l55_previewbrowser4.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
===Device Emulation===
 +
 
 +
Press Ctrl+shift+i or select from the browser menu to open the browser web console.
 +
 
 +
[[{{ns:file}}:l55_previewbrowser5.png|800px|left|border|link={{filepath:l55_previewbrowser5.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
<div style="height:100px;margin-bottom:5px;padding:5px;border:0px solid orange;border-left:5px solid orange;background:#fff8dc;vertical-align:middle;position:relative;">
 +
[[File:bm-noteicon.png|top|40px|link=]]<div style="position:absolute;top:3px;margin-bottom;bottom:5px;margin-left:50px;"><b> Pro Tip</b>
 +
The Console and Network tabs can be invaluable when you are testing web Apps.<br/>
 +
You can see the data queries that are being sent and any errors reported.<br>
 +
You can also test any JavaScript commands from the Console command line.<br/>
 +
</div>
 +
<span style="height:6px;"> </span>
 +
</div>
 +
 
 +
From the browser web console, the device emulator can be accessed.  Here Firefox:
 +
 
 +
[[{{ns:file}}:l55_previewbrowser6firefox.png|800px|left|border|link={{filepath:l55_previewbrowserfirefox6.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
Chrome:
 +
 
 +
[[{{ns:file}}:l55_previewbrowser6chrome.png|800px|left|border|link={{filepath:l55_previewbrowser6chrome.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
Edge:
 +
 
 +
[[{{ns:file}}:l55_previewbrowser6edge.png|800px|left|border|link={{filepath:l55_previewbrowser6edge.png}}|Preview live in browser]]
 +
<br clear=all>
 +
 
 +
==Deploying Lianja Web/Mobile Client Apps (Deprecated in v5.5)==
 +
Web App View, Tablet App View and Phone App View have been deprecated in v5.5.  Please see [[#Deploying Lianja Web/Mobile Client Apps|Deploying Lianja Web/Mobile Client Apps]] above for instructions.
 +
 
 +
The following instructions apply to versions prior to v5.5 only.
 +
 
 +
For Web, Tablet and Phone Apps, open the App in the appropriate ''App View'' in the Lianja App Builder and click the '''Deploy''' button to generate the HTML5 index file for each of your target devices. 
 +
 
 +
===Web Apps===
 +
[[{{ns:file}}:lp_web1.png|450px|thumb|left|link={{filepath:lp_web1.png}}|Web App View]]
 +
 
 +
 
 +
 
 +
With the App open in the App Builder, click on '''Web App View'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:lp_web1a.png|450px|thumb|left|link={{filepath:lp_web1a.png}}|Web App View: Deploy]]
 +
 
 +
 
 +
 
 +
Then click '''Deploy''' to create index.html.
 +
 
 +
 
 +
You can click '''Preview''' to preview your App live in your default browser.
 +
 
 +
<br clear=all>
 +
 
 +
===Tablet Apps===
 +
[[{{ns:file}}:lp_mobile1.png|450px|thumb|left|link={{filepath:lp_mobile1.png}}|Tablet App View]]
 +
 
 +
 
 +
 
 +
With the App open in the App Builder, click on '''Tablet App View'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:lp_mobile3.png|450px|thumb|left|link={{filepath:lp_mobile3.png}}|Tablet App View: Deploy]]
 +
 
 +
 
 +
 
 +
Then click '''Deploy''' to create tablet_index.html.
 +
 
 +
Clicking '''Preview''' allows you to run your App live in your default browser.
 +
 
 +
<br clear=all>
 +
 
 +
===Phone Apps===
 +
[[{{ns:file}}:lp_mobile2.png|450px|thumb|left|link={{filepath:lp_mobile2.png}}|Phone App View]]
 +
 
 +
 
 +
 
 +
With the App open in the App Builder, click on '''Phone App View'''.
 +
 
 +
<br clear=all>
 +
 
 +
[[{{ns:file}}:lp_mobile4.png|450px|thumb|left|link={{filepath:lp_mobile4.png}}|Phone App View: Deploy]]
 +
 
 +
 
 +
 
 +
Then click '''Deploy''' to create phone_index.html.
 +
 
 +
 
 +
Clicking '''Preview''' allows you to run your App live in your default browser.
 +
 
 +
<br clear=all>
 +
 
 +
==Deploy Workspace==
 +
Using the Deploy Workspace, you can compare the files in the Lianja App Builder directories with those in the Lianja App Center / Lianja Cloud/SQL Server directories and copy any missing or modified files.
 +
 
 +
[[{{ns:file}}:preview.png|150px|thumb|left|link={{filepath:preview.png}}|Preview Changes]]
 +
 
 +
 
 +
Simply click the checkbox next to the file group or individual filename in the '''Deployment files''' explorer for the files you want to deploy.  You can then preview the changes that will be made by clicking the '''Preview changes''' button in the Headerbar.  These are displayed in the '''Deployment Files Preview''' window.  Here I'm deploying a new database created in the Lianja App Builder.  After deployment it will be available to Lianja Cloud and SQL Servers and the Lianja App Center.  You can deploy databases, Apps and Library files in a single operation - just select the files in the explorer.
 +
 
 +
<br clear=all>
 +
 
 +
Note that if you are deploying an App, it needs to be ''Published'' or it will not be visible in the Lianja App Center.  Publish the App by checking the [http://www.lianja.com/images/stories/tutorials/tiles/app_settings.png Published attribute in Settings].
 +
 
 +
 
 +
[[{{ns:file}}:confirm.png|150px|thumb|left|link={{filepath:confirm.png}}|Commit Changes]]
 +
 
 +
 
 
Once you are happy with the selection of files to deploy, click the '''Commit changes''' button in the Headerbar and confirm the operation when prompted.
 
Once you are happy with the selection of files to deploy, click the '''Commit changes''' button in the Headerbar and confirm the operation when prompted.
 
<br clear=all>
 
<br clear=all>
[[{{ns:file}}:finished.png|150px|thumb|left|Finished]]
+
[[{{ns:file}}:finished.png|150px|thumb|left|link={{filepath:finished.png}}|Finished]]
 +
 
 +
 
 
The copy operation is carried out and the '''Deployment Transfer Log''' window logs the changes.
 
The copy operation is carried out and the '''Deployment Transfer Log''' window logs the changes.
<br clear=all>
+
On successful completion, your deployed data, Apps and Library scripts will be available to the Lianja App Center and Lianja Cloud and SQL Servers.
[[{{ns:file}}:recipes_DSN.png|150px|thumb|left|Recipes DSN]]
+
Now that deployment has completed successfully the ''recipes'' database is available to Lianja SQL Server (and the Lianja App Center) on my machine and I can create a DSN.  For more information on creating DSNs, please see the [[Lianja ODBC Manager]].
+
 
<br clear=all>
 
<br clear=all>
[[{{ns:file}}:Access_DSN.png|150px|thumb|left|Access DSN]]
+
 
 +
==Lianja SQL Server: ODBC DSN==
 +
[[{{ns:file}}:recipes_DSN.png|150px|thumb|left|link={{filepath:recipes_DSN.png}}|Recipes DSN]]
 +
 
 +
 
 +
Now that deployment has completed successfully and the ''recipes'' database is available to Lianja SQL Server on my machine, I can create a DSN.  For more information on creating DSNs, please see the [[Lianja ODBC Manager on Windows]] and [[Lianja ODBC Driver on Windows]] or [[Lianja Server Manager on Linux]] and [[Lianja ODBC Driver on Linux]].
 +
<br clear=all>
 +
[[{{ns:file}}:Access_DSN.png|150px|thumb|left|link={{filepath:access_DSN.png}}|Access DSN]]
 +
 
 +
 
 
Then access the DSN.  
 
Then access the DSN.  
 
[[Category:Deployment]]
 
[[Category:Deployment]]
[[Category:SQL Server]]
+
[[Category:Lianja SQL Server]]
 +
[[Category:Lianja Cloud Server]]
 +
[[Category:Lianja v5.5]]
 +
[[Category:Lianja v6.0]]

Latest revision as of 10:49, 11 May 2021