InstaLOD Pipeline Service Functionality

About this document

InstaLOD Pipeline can be set up as a 'Windows Service' meaning that InstaLOD operations can be executed automatically when booting a system.

Prerequisites

For the service functionality to work, the user account requires the 'log on as a service' Windows user rights. Once this is provided, everything is ready for take-off.

Registering a service

A service can be registered with the command line by invoking InstaLOD Pipeline with the following arguments '-service register <servicename> <username> <password> ..<InstaLOD operation>..'. If your arguments are valid, the service will start right away. If an error message appears, please react accordingly as described by the error message. 

NOTE: The '-service register' command must be specified before loading a file or profile.

 

Example:

InstaLODCmd -service register InstaLODOptimizeService DESKTOP-A1B2C4D\john password1234 -profile "C:\InstaLOD\Optimize.json" -file "C:\InstaLOD\TestModel.fbx" "C:\InstaLOD\OutputModel.fbx" OptimizeDemo 

_________________________________________________________________________________

In case you receive a user login error message, please make sure that the service Log on details are correct. This can be edited and updated using the following steps:

1. Press Windows key + R to open the Run elevated command line.
2. Type services.msc and press Enter.
3. Locate the Application Identity service, right-click on it, and open Properties.
4. Click Log On tab and enter your correct user login details. 
5. Click Apply

NOTE: to register a service start the command line with elevated access (admin) rights.

 

Unregistering a service

To unregister a service, invoke InstaLOD Pipeline with the arguments '-service unregister <servicename>'. If your service name is valid and the command line is executed with elevated rights, the service will be unregistered. If the service is still running, it will be stopped and closed.

 

Listing all registered services

To list all services, invoke Pipeline with the arguments '-service list'. This will list all registered services by name and display name. If the command line is executed with elevated rights, the service will have its arguments listed.

Change user password

In case the user account changes its password the service will not be notified about this, on the next start of the service it will fail and write an Error to Windows 'Event Viewer'. You can change the user account password for the service by invoking InstaLOD Pipeline with the arguments: '-service updatepassword <servicename> <username> <newpassword>'. If everything worked, no error message will be displayed. To use this functionality again, elevated user rights are necessary for the console.