Some data lives where FINBOURNE's cloud can't reach it: a file share in your office, a database behind your firewall, a spreadsheet tool on your desktop. Luminesce reaches it through provider hosts and drivers you run yourself, and LumiCode can download them, install the ones that are .NET tools, and fetch the client certificate a provider host needs to connect to your domain, all from one prompt.
Prerequisites
LumiCode installed and signed in. See How do I install LumiCode?
A licence and entitlements for each binary you want. LumiCode can list a binary that you can't download.
To install a .NET tool from LumiCode, the .NET SDK on your computer. Type
dotnet --versionin a terminal to check.
Methods
Method 1: Download a binary
Type
/binariesand press Enter.Choose the binary. See Appendix: The binaries.
Choose the version. The latest is selected.
Browse to the folder to download it to, and choose ✔ use this folder.
For a .NET tool, LumiCode asks Install it now? Choose yes to install it with
dotnet tool install, or no to see the command to run later. Either way, LumiCode tells you the command that starts the tool, which is not always the same as its name.
Anything that isn't a .NET tool, such as an .msi installer or a .jar file, is downloaded only. Install it the way that binary documents.
Updating LumiCode itself
LumiCode appears in the list too, with your version marked (yours) and any newer one (newer). /update is the quicker way to update it, and /whats-new shows what a newer version brings first.
Method 2: Download a client certificate
A provider host running outside FINBOURNE's cloud uses a client certificate to authenticate to your domain. It needs both halves: the public certificate and the private key.
Type
/certificatesand press Enter. LumiCode lists your certificates, each with its validity dates and whether it's valid, expired or revoked.Choose download public pem.
Browse to a folder and name the file. LumiCode suggests
client_cert.pem. Replacing an existing file asks first.Type
/certificatesagain and choose download private pem. LumiCode suggestsclient_key.pem.
On macOS and Linux, LumiCode makes the private key readable only by you.
Keep the private key private
Anyone with the private key can connect to your domain as you. Store it only on the machine that runs the provider host, and don't email it or put it in a shared folder.
mint (dry run) shows what creating a certificate would do, and changes nothing.
Troubleshooting
The download fails
The download service isn't held to the same availability as the rest of the platform. If it looks like an outage, try again later. If a binary is refused, check that you have its licence and entitlements.
Installing says the tool is already installed
dotnet tool install doesn't overwrite a tool that's already there. LumiCode shows the dotnet tool update command to run instead.
No certificates are listed
LumiCode shows No client certificates exist for this user/domain yet. LumiCode doesn't create certificates. See Managing certificates for Luminesce providers for how to create and manage certificates.
Appendix: The binaries
Binary | What it is | Installs as |
|---|---|---|
| LumiCode itself | .NET tool |
| The Luminesce CLI (deprecated for most purposes, use LumiCode instead) | .NET tool |
| Providers for local and network (NAS) file systems | .NET tool |
| Email providers, for example for a mail server behind an IP restriction | .NET tool |
| The C# part of Python providers (not generally for standalone downloads, but required by lumipy to run providers) | .NET tool |
| Cloud storage providers, for example for storage behind an IP restriction | .NET tool |
|
| .NET tool |
| A generic JDBC driver |
|
| The Power BI connector |
|
| The ODBC driver for 64-bit Windows |
|