Versions Compared

Old Version 19

changes.mady.by.user Anders Axelsson

Saved on

compared with

New Version Current

changes.mady.by.user Anders Axelsson

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
Info

All information related to the product can be found from products.technia.com

Panel
panelIconId1f449
panelIcon:point_right:
panelIconText👉
bgColor#F4F5F7

  1. Go to https://products.technia.com

  2. Login

    1. Customers receive login details separately

    2. TECHNIA employees use domain credentials

  3. Go to the Light My Way tab

  4. View the page content, links to documentation, support, extension etc

Client installation

Info

The client is distributed as a web extension, this means that it is not actually installed to the target environment but rather in selected client browsers. This have several benefits such as making it possible to add guides to inaccessible cloud platforms but also ensuring a minimal footprint and retaining 'OOTB'. On top of that you are not dependent on server deployment to get the guides in either.

Manual client installation is primarily used for trial or authoring. For enterprise distribution and proper rollouts on numerous clients registry is preferred and normally pushed by IT.

Panel
panelIconId1f449
panelIcon:point_right:
panelIconText👉
bgColor#F4F5F7

Exercise 2 - Manual client installation

  1. Open Chrome or Edge

  2. Find and click the chrome store consumer link from products.technia.com (Chrome store extensions also works on Edge but you might have to enable chrome extensions by clicking the blue ribbon)

  3. Click “Add to Chrome” or “Get” (depends browser)

  4. In the browser menu find “Extensions” → “Manage extensions” and go into the details of the “Light My Way Consumer Extension”

    1. Find the version info (the client will automatically update on browser restart as new versions are released to the store)

    2. Apply a “site access” pattern so that the client tabs only shows for target platform URLs

      1. To ensure data access make sure that “*://lmw.technia.cloud” is added

      2. Verify that the extension activates for target platforms only

    3. Manually disable the consumer extension to prevent conflict with author

Note

Note that manual client installation is not recommended (easy to make configuration mistakes e.g. site access list)

Panel
panelIconId1f449
panelIcon:point_right:
panelIconText👉
bgColor#F4F5F7

Exercise 3 - Installing client by registry

  1. Find the “current release” on products.technia.com

  2. Download “sample-author.reg”

  3. Edit the “.reg” file in a text editor and consider its content

  4. Modify “runtime_allowed_hosts” to include your desired target platform URL (be careful on the syntax)

  5. Execute / install the “.reg” file

  6. Find the registry entry

  7. Restart browser

  8. Find the author extension in your browser extensions list

    1. Note the source “Added by your organisation”

    2. Note that “runtime_allowed_hosts” is not displayed in the site access list

  9. (OPTIONAL) Find the accessToken and give yourself a top secret and unique key (use password generator?)

    1. Execute / install the “.reg” file

    2. Find the key in registry

    entry

  10. (OPTIONAL) add “-” before the key in .reg to remove it. Then add it back.

    1. Restart browser

    Find the author extension in your browser extensions list

    1. Note the source “Added by your organisation”

    2. Note that “runtime_allowed_hosts” is not displayed in the site access listAdd it back

Note

The reg file is normally distributed to selected clients by customer IT

Repository setup

Info

A repository is where the guide data is stored. The target environment is not directly tied to a specific repo but the client could connect to different repos to present different guides. Normally customers have one repo for production use and other repos for authoring of new guides.

A repo can also hold specific configurations such as extensions to the built in definition for new targets or custom app states.

Panel
panelIconId1f449
panelIcon:point_right:
panelIconText👉
bgColor#F4F5F7

Exercise 4 - Create a repository

  1. Go to https://lmw.technia.cloud/admin and login

  2. From the top bar select “Add +” → “Create New Repository”

  3. Fill out repo detail and press add

    1. Author keys will be you passkey for authoring

Note

Admin activities is normally done by TECHNIA or specially trained customer administrators.

Panel
panelIconId1f449
panelIcon:point_right:
panelIconText👉
bgColor#F4F5F7

Exercise 5 - Connecting

  1. Navigate to the target platform environment (URL)

  2. Find the author extension in the browser menu and click the green

    Status
    colourGreen
    title'L'
    icon

  3. Enter https://lmw.technia.cloud/<account>/<repo>

  4. Press tab and you should see “Connected successfully”

  5. “LIGHT MY WAY“ and “AUTHOR“ panel tabs should now be visible to the right

  6. Click the “AUTHOR“ tab and enter your author passkey

Note

Auto connect is normally setup for end user convenience