Skip to main content

Install on site

Site install uses one Setup file: OptimLight-Setup-<version>-unsigned.exe when unsigned, or OptimLight-Setup-<version>.exe when signed. Copy that file to the site host and double-click it. Setup asks for administrator approval. A small window unpacks the setup files, then the graphical wizard opens. Cancel or finish the wizard, and Setup deletes that temporary unpack.

Before you install​

  1. Confirm the host meets Requirements. Leave roughly as much free space as the Setup file itself for the temporary unpack.
  2. Choose the product root you intend to keep. The default is C:\Program Files\OptimLight. When you browse a parent folder, the wizard appends OptimLight; you can still edit the full path. If that folder already has files and is not an installed product tree, the wizard asks before continuing. Do not move that directory after install.
  3. Leave the product database connection at the product default. The configuration page does not ask about the time-series store; the next page chooses a local test instance or an existing store.

Run setup​

Double-click the Setup file and approve the administrator prompt. Wait for the unpack window, then in the wizard read the license, choose the product root, and review the product database and browser entry. Nginx and MySQL each have their own card: Setup installs them when this product copy is not already present at this path, and the port is editable; when it is already present, Setup keeps that instance and the port is read-only. Nginx listens on all interfaces at 0.0.0.0; MySQL stays at 127.0.0.1. The browser entry defaults to port 80, so the URL needs no extra port. The product database defaults to 3306. If either port is in use, remove unused programs occupying it and run setup again so the product can be used in the default way, or specify another port for that product role. Other product service ports cannot be changed; if another program is using them, stop that program or restart the computer before setup. The folder box defaults to a registered product root when one is still present. Expand OptimLight on the configuration page to see the other Windows services this package will register. If the host has no Visual C++ x64 runtime or JDK 17, the wizard installs them silently first. The GPU driver stays site-provided; the wizard only checks and reports. After configuration, a Timeseries database page shows two items that stay expanded; at least one must stay checked. The first item is checked by default and installs a test store under the product root; its boxes are disabled. The second item is also checked by default: enter the address, port, user, and password of an existing store. Continue stays disabled when the second item is checked and those fields are incomplete. If only the first item is checked, Next does not run a login check and does not change the time-series address, port, user, or password in the site file; the product default connection stays. When the second item stays checked, Next runs a login check now; it cannot use the local instance that has not been installed yet. If the second-item login succeeds, product processes use that address. If both items are checked, Setup still installs the local test instance, and product processes still use the second-item address.

When the wizard finishes, the folder you chose is the product tree. The finish page lists each registered service as running, installed but start failed, or installed with start not requested. Open the site file conf/sites/site.yml in the product configuration directory. Replace the key used to sign sign-in sessions. Set the cross-origin list to the browser entry you will open, for example http://<lan-address> when the port is 80, or http://<lan-address>:<port> for another port. Do not keep the placeholder secret from the package.

If the wizard stops on the failure page, Details shows the reason written by Setup. When a precheck fails, the folder you chose is not created.

Open the entry​

After Nginx is installed and started, open the browser entry. The default port is 80, so use http://<host>; if the wizard chose another port, add :<port>. Do not open http://0.0.0.0. See First launch.

After install​

install\ is only for install and uninstall. You may delete it afterwards. Registered services and runtime directories keep running. Do not hand-edit program directories under bin\. The Apps list shows OptimLight; the publisher is WWEI. To uninstall, choose OptimLight in Apps, or run uninstall.exe in the product root (Start menu: Uninstall OptimLight). Do not treat install\uninstall-all.bat as the user entry.