Difference between revisions of "Deploying to LAN - Desktop and Web Clients"

From Lianjapedia
Jump to: navigation, search
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
−
''Under Construction''
 
−
 
 
A Guide to Sharing Lianja Apps and Data between Desktop clients and Web/Mobile clients on a LAN.
 
A Guide to Sharing Lianja Apps and Data between Desktop clients and Web/Mobile clients on a LAN.
  
 
==Server Setup==
 
==Server Setup==
  
−
[[{{ns:file}}:lan_server.png|450px|thumb|left|link={{filepath:lan_server.png}}|Server Setup: Drive]]
+
[[{{ns:file}}:lan_server_dir.png|450px|thumb|left|link={{filepath:lan_server_dir.png}}|Server Setup: Directory]]
  
  
Line 14: Line 12:
 
- Here it is installed on the E: drive of an XP Virtual Machine.
 
- Here it is installed on the E: drive of an XP Virtual Machine.
  
−
* Create a share point on your server to the drive on which you installed Lianja.
+
Note: if you only have Desktop Clients, install the Lianja App Center - the Lianja Cloud Server is not required.  Desktop Clients using ODBC access to Lianja databases (e.g. Virtual tables or [[SQLCONNECT()]]) will require the Lianja SQL Server.
  
−
<span style="color: blue;">- Here E: is shared as ''L''.</span>
+
* Create a share point on your server to the relevant tenancy directory.  The default tenancy for users is 'public'. This corresponds to the \lianja\cloudserver\tenants\public\ directory.
  
−
<br clear=all>
+
- Here E:\lianja\cloudserver\tenants\public is shared as ''public''.
−
 
+
−
[[{{ns:file}}:lan_server_dir.png|450px|thumb|left|link={{filepath:lan_server_dir.png}}|Server Setup: Directory]]
+
−
 
+
−
 
+
−
 
+
−
 
+
−
* Or create a share point on your server to a directory in the \lianja\cloudserver\tenants\public\ path.  (Supported from Lianja v1.4.2.)
+
−
 
+
−
<span style="color: green;">- Here E:\lianja\cloudserver is shared as ''cloud''.</span>
+
  
 
<br clear=all>
 
<br clear=all>
  
 
==Deploying to the Server==
 
==Deploying to the Server==
−
 
+
Note: For Lianja Web/Mobile Client 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 before deploying to the Server. For more information see [[Deploying to Local Directory|here]].
−
[[{{ns:file}}:lan_dev.png|450px|thumb|left|link={{filepath:lan_dev.png}}|Deploying from App Builder: Drive]]
+
 +
[[{{ns:file}}:lan_dev_dir.png|450px|thumb|left|link={{filepath:lan_dev_dir.png}}|Deploying from App Builder: Directory]]
  
  
Line 39: Line 29:
  
 
* In the '''Deploy''' workspace create a new deployment settings profile by clicking '''New''' and specifying a name.
 
* In the '''Deploy''' workspace create a new deployment settings profile by clicking '''New''' and specifying a name.
−
 
−
- Here it is ''MyLAN_settings''
 
−
 
−
* Change the '''Directory''' to point to \lianja\cloudserver\tenants\public\ on the Server.
 
−
 
−
<span style="color: blue;">- Here S: has been mapped to ''L'' on the Server, so '''Directory''' is ''S:\lianja\cloudserver\tenants\public\''</span>
 
−
 
−
<br clear=all>
 
−
 
−
[[{{ns:file}}:lan_dev_dir.png|450px|thumb|left|link={{filepath:lan_dev_dir.png}}|Deploying from App Builder: Directory]]
 
−
 
−
 
−
 
−
 
−
* Or, if you shared a directory rather than the drive on the Server, create a new deployment settings profile as follows.
 
  
 
- Here it is ''MyLAN_settings2''
 
- Here it is ''MyLAN_settings2''
Line 59: Line 34:
 
* Change the '''Directory''' to point to \lianja\cloudserver\tenants\public\ on the Server.
 
* Change the '''Directory''' to point to \lianja\cloudserver\tenants\public\ on the Server.
  
−
<span style="color: green;">- Here X: has been mapped to ''cloud'' on the Server, so '''Directory''' is ''X:\tenants\public\''</span>
+
- Here P: has been mapped to ''public'' on the Server, so '''Directory''' is ''P:\''
  
 
<br clear=all>
 
<br clear=all>
Line 73: Line 48:
  
 
<br clear=all>
 
<br clear=all>
 +
 +
===File Locations===
  
 
{| class="wikitable" width="100%"
 
{| class="wikitable" width="100%"
Line 92: Line 69:
  
 
Notice that '''data''' is shared between Desktop and Web/Mobile clients.
 
Notice that '''data''' is shared between Desktop and Web/Mobile clients.
−
 
−
[[{{ns:file}}:lan_deploy_indexhtml.png|450px|thumb|left|link={{filepath:lan_deploy_indexhtml.png}}|Deploy index.html]]
 
−
 
−
 
−
 
−
 
−
* This step is only required for versions 1.4.2 and earlier.  From 1.4.2 onwards it is handled as part of '''Deploy''' above when the App has been deployed in the Web App View.
 
−
 
−
* For Web Clients, the index.html file must also be copied to the ''\lianja\cloudserver\tenants\public\wwwroot\apps\<appname>\'' directory on the server.
 
−
 
−
- The index.html file is copied into your local ''\lianja\cloudserver\tenants\public\wwwroot\apps\<appname>\'' directory when you '''Deploy''' from the '''Web App View'''.
 
−
 
−
<br clear=all>
 
  
 
==Desktop Client==
 
==Desktop Client==
Line 133: Line 97:
 
<br clear=all>
 
<br clear=all>
  
−
[[{{ns:file}}:lan_desktop_client.png|450px|thumb|left|link={{filepath:lan_desktop_client.png}}|App Center Desktop Client: --runtimedir]]
 
−
 
−
 
−
 
−
 
−
<span style="color: blue;">* Map a drive on the client to the Lianja drive on the Server.</span>
 
−
 
−
<span style="color: green;">(See below for using a directory share point on the Server.)</span>
 
−
 
−
<span style="color: blue;">- Here Z: has been mapped to ''L'' (the Lianja drive) on the Server.</span>
 
−
 
−
<span style="color: blue;">(Pre v1.4.1, use the same letter as the server drive, e.g. map L: to ''L'' on the Server.)</span>
 
−
 
−
<span style="color: blue;">* Then, specify the '''--runtimedir <drive>''' switch on the App Center shortcut command.</span>
 
−
 
−
<span style="color: blue;">(Or set up the environment variable '''LIANJA_RUNTIMEDIR''' - see next screenshot below).</span>
 
−
 
−
<span style="color: blue;">- Here the command becomes: ''C:\lianja\bin\lianjaruntime.exe --runtimedir Z:''.</span>
 
−
 
−
<span style="color: blue;">(Pre 1.4.1, also add the '''--networkshare''' switch.  Turned on automatically from v1.4.1.)</span>
 
−
 
−
<br clear=all>
 
−
 
−
[[{{ns:file}}:lan_lianjaruntimedir.png|450px|thumb|left|link={{filepath:lan_lianjaruntimedir.png}}|App Center Desktop Client: LIANJA_RUNTIMEDIR]]
 
−
 
−
 
−
 
−
 
−
<span style="color: blue;">* As an alternative to using the '''--runtimedir''' switch above, the environment variable '''LIANJA_RUNTIMEDIR''' can be set to the mapped drive.</span>
 
−
 
−
<span style="color: blue;">- Here '''LIANJA_RUNTIMEDIR''' has been set to ''Z:'' and no command switches are required.</span>
 
−
 
−
<br clear=all>
 
  
−
[[{{ns:file}}:lan_desktop_client_dir.png|450px|thumb|left|link={{filepath:lan_desktop_client_dir.png}}|App Center Desktop Client: --runtimepath]]
+
[[{{ns:file}}:lan_desktop_client_tenancy.png|450px|thumb|left|link={{filepath:lan_desktop_client_tenancy.png}}|App Center Desktop Client: --tenancy]]
  
  
  
  
−
<span style="color: green;">* To use a directory share point on the Server, map a drive on the client to the share point.</span>
+
* Map a drive on the client to the share point.
  
−
<span style="color: green;">- Here T: has been mapped to ''cloud'' (the E:\lianja\cloudserver\ directory) on the Server.</span>
+
- Here P: has been mapped to ''public'' (the E:\lianja\cloudserver\tenants\public\ directory) on the Server.
  
−
<span style="color: green;">* Then, specify the '''--runtimepath <directory>''' switch on the App Center shortcut command to point to the \lianja\cloudserver\tenants\public\ directory on the Server.</span>
+
* Then, specify the '''--tenancy <drive>''' switch on the App Center shortcut command to point to the \lianja\cloudserver\tenants\public\ directory share point on the Server.
  
−
<span style="color: green;">(Or set up the environment variable '''LIANJA_RUNTIMEPATH''' - see next screenshot below).</span>
+
(Or set up the environment variable '''LIANJA_TENANCY''' - see next screenshot below).
  
−
<span style="color: green;">- Here the command becomes: ''C:\lianja\bin\lianjaruntime.exe --runtimepath T:\tenants\public\''.</span>
+
- Here the command becomes: ''C:\lianja\bin\lianjaruntime.exe --tenancy P:''
  
 
<br clear=all>
 
<br clear=all>
  
−
[[{{ns:file}}:lan_lianjaruntimepath.png|450px|thumb|left|link={{filepath:lan_lianjaruntimepath.png}}|App Center Desktop Client: LIANJA_RUNTIMEPATH]]
+
[[{{ns:file}}:lan_lianjatenancy.png|450px|thumb|left|link={{filepath:lan_lianjatenancy.png}}|App Center Desktop Client: LIANJA_TENANCY]]
  
  
  
  
−
<span style="color: green;">* As an alternative to using the '''--runtimepath''' switch above, the environment variable '''LIANJA_RUNTIMEPATH''' can be set to the mapped drive.</span>
+
* As an alternative to using the '''--tenancy''' switch above, the environment variable '''LIANJA_TENANCY''' can be set to the mapped drive.
  
−
<span style="color: green;">- Here '''LIANJA_RUNTIMEPATH''' has been set to ''T:\tenants\public\'' and no command switches are required.</span>
+
- Here '''LIANJA_TENANCY''' has been set to ''P:'' and no command switches are required.
  
 
<br clear=all>
 
<br clear=all>
Line 217: Line 148:
  
 
[[Category:Deployment]]
 
[[Category:Deployment]]
−
[[Category:SQL Server]]
+
[[Category:Lianja SQL Server]]
−
[[Category:Cloud Server]]
+
[[Category:Lianja Cloud Server]]
−
[[Category:Developers Guide]]
+

Latest revision as of 06:56, 9 January 2020

A Guide to Sharing Lianja Apps and Data between Desktop clients and Web/Mobile clients on a LAN.

Server Setup

Server Setup: Directory



  • Install the Lianja Cloud Server on the chosen server on your LAN.

- Here it is installed on the E: drive of an XP Virtual Machine.

Note: if you only have Desktop Clients, install the Lianja App Center - the Lianja Cloud Server is not required. Desktop Clients using ODBC access to Lianja databases (e.g. Virtual tables or SQLCONNECT()) will require the Lianja SQL Server.

  • Create a share point on your server to the relevant tenancy directory. The default tenancy for users is 'public'. This corresponds to the \lianja\cloudserver\tenants\public\ directory.

- Here E:\lianja\cloudserver\tenants\public is shared as public.


Deploying to the Server

Note: For Lianja Web/Mobile Client 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 before deploying to the Server. For more information see here.

Deploying from App Builder: Directory



  • In the Deploy workspace create a new deployment settings profile by clicking New and specifying a name.

- Here it is MyLAN_settings2

  • Change the Directory to point to \lianja\cloudserver\tenants\public\ on the Server.

- Here P: has been mapped to public on the Server, so Directory is P:\


Deployed to Server



  • Check the Server to see your deployed files.

- Remember to deploy your database and any additional Library script files as well as your Apps.


File Locations

Files Deployed Location
Desktop Apps \lianja\cloudserver\tenants\public\apps
Desktop Library \lianja\cloudserver\tenants\public\library
Desktop Data \lianja\cloudserver\tenants\public\data
Web/Mobile Apps \lianja\cloudserver\tenants\public\wwwroot\apps
Web/Mobile Library \lianja\cloudserver\tenants\public\wwwroot\library
Web/Mobile Data \lianja\cloudserver\tenants\public\data

Notice that data is shared between Desktop and Web/Mobile clients.

Desktop Client

To run your deployed Apps from the Desktop Client:

App Center Desktop Client: Installation



  • Install the App Center on the Client.

- The Shared files directory installation drive should be the same drive as the Installation Directory.

- Here the App Center has been installed on C:.


App Center Desktop Client: Installation



  • If you specify a different drive, the installer will install the runtime directory structure for the data, Apps etc. on that drive.

- Here the App Center program files have been installed on C: and the runtime directories on E:.



App Center Desktop Client: --tenancy



  • Map a drive on the client to the share point.

- Here P: has been mapped to public (the E:\lianja\cloudserver\tenants\public\ directory) on the Server.

  • Then, specify the --tenancy <drive> switch on the App Center shortcut command to point to the \lianja\cloudserver\tenants\public\ directory share point on the Server.

(Or set up the environment variable LIANJA_TENANCY - see next screenshot below).

- Here the command becomes: C:\lianja\bin\lianjaruntime.exe --tenancy P:


App Center Desktop Client: LIANJA_TENANCY



  • As an alternative to using the --tenancy switch above, the environment variable LIANJA_TENANCY can be set to the mapped drive.

- Here LIANJA_TENANCY has been set to P: and no command switches are required.


Web Client

Web Client


  • To run Web or Mobile Apps, just point your browser at the IP address of the server.

- If you are using the IIS extension or have port 80 enabled:

http://192.168.X.X/login.rsp

- If you are running without port 80 enabled.

http://192.168.X.X:8001


See Also

Command Line Switches, Deploying to Local Directory, Lianja Server Manager on Windows, License Management on Windows

Retrieved from "https://www.lianja.com/doc/index.php?title=Deploying_to_LAN_-_Desktop_and_Web_Clients&oldid=22622"