<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>services &#8211; Blue Lance</title>
	<atom:link href="https://bluelance.com/docs-tag/services/feed/" rel="self" type="application/rss+xml" />
	<link>https://bluelance.com</link>
	<description></description>
	<lastBuildDate>Thu, 04 Jun 2026 23:13:56 +0000</lastBuildDate>
	<language>en-US</language>
	<sy:updatePeriod>
	hourly	</sy:updatePeriod>
	<sy:updateFrequency>
	1	</sy:updateFrequency>
	<generator>https://wordpress.org/?v=7.0</generator>

<image>
	<url>https://bluelance.com/wp-content/uploads/2025/11/fevicon-ic-1.png</url>
	<title>services &#8211; Blue Lance</title>
	<link>https://bluelance.com</link>
	<width>32</width>
	<height>32</height>
</image> 
	<item>
		<title>Managing the NSS Audit Service</title>
		<link>https://bluelance.com/docs/managing-the-nss-audit-service/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:24:19 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15918</guid>

					<description><![CDATA[Once the NSS Audit Agent is installed and configured on an OES server, day-to-day management of the ltaudit service is straightforward. This article covers how to start, stop, restart, and check the status of the NSS Audit Agent service using both systemctl and the built-in control script, and when to use each management action. Understanding [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Once the NSS Audit Agent is installed and configured on an OES server, day-to-day management of the ltaudit service is straightforward. This article covers how to start, stop, restart, and check the status of the NSS Audit Agent service using both systemctl and the built-in control script, and when to use each management action.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Understanding the ltaudit service:</strong></p>



<p class="wp-block-paragraph">The ltaudit service is the NSS Audit Agent daemon that runs continuously on each OES server, collecting NSS file activity and forwarding it to the LT Auditor <sup>MP</sup> server via syslog. It is registered with systemd during installation and can be managed using standard systemctl commands or the agent&#8217;s built-in control script located at /opt/bluelance/bin/ltaudit.rc.</p>



<p class="wp-block-paragraph">Both management methods produce the same result — use whichever is more familiar or appropriate for your environment.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>When you need to manage the service:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Situation</strong></td><td><strong>Action Required</strong></td></tr><tr><td>Agent not forwarding events to LT Auditor <sup>MP</sup></td><td>Check status, restart if stopped</td></tr><tr><td>Configuration changes made via update_syslog_config.sh</td><td>Restart to apply new settings</td></tr><tr><td>OES server maintenance or reboot</td><td>Stop before maintenance, confirm restart after</td></tr><tr><td>Agent upgrade or package update</td><td>Stop before upgrade, start after</td></tr><tr><td>Troubleshooting forwarding or connectivity issues</td><td>Stop and restart to reset connections</td></tr><tr><td>Confirming agent is healthy after a server reboot</td><td>Check status</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Checking service status:</strong></p>



<p class="wp-block-paragraph">Always check the service status first before taking any other management action — it tells you whether the service is running, stopped, or in an error state.</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc status</p>



<p class="wp-block-paragraph"><strong>Interpreting the status output:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Status</strong></td><td><strong>Description</strong></td><td><strong>Action Required</strong></td></tr><tr><td>active (running)</td><td>Service is running normally</td><td>None</td></tr><tr><td>inactive (dead)</td><td>Service is stopped</td><td>Start the service</td></tr><tr><td>failed</td><td>Service encountered an error and stopped</td><td>Review logs and restart</td></tr><tr><td>activating</td><td>Service is in the process of starting</td><td>Wait and check again</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Starting the service:</strong></p>



<p class="wp-block-paragraph">If the service is stopped and needs to be started:</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph">systemctl start ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc start</p>



<p class="wp-block-paragraph">After starting, confirm the service is running:</p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Stopping the service:</strong></p>



<p class="wp-block-paragraph">If the service needs to be stopped for maintenance, configuration changes, or troubleshooting:</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph">systemctl stop ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc stop</p>



<p class="wp-block-paragraph">Stopping the service suspends NSS file activity collection on that server. Any events that occur while the service is stopped will not be captured. Stop the service only when necessary and restart it as soon as possible to minimize monitoring gaps.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Restarting the service:</strong></p>



<p class="wp-block-paragraph">Restart the service to apply configuration changes or reset connections to the LT Auditor <sup>MP</sup> server:</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph">systemctl restart ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc stop</p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc start</p>



<p class="wp-block-paragraph">After restarting, confirm the service returns to an active (running) state:</p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Enabling automatic startup on boot:</strong></p>



<p class="wp-block-paragraph">To ensure the ltaudit service starts automatically when the OES server reboots, enable it with systemctl:</p>



<p class="wp-block-paragraph">systemctl enable ltaudit.service</p>



<p class="wp-block-paragraph">Confirm the service is enabled:</p>



<p class="wp-block-paragraph">systemctl is-enabled ltaudit.service</p>



<p class="wp-block-paragraph">The output should return enabled. If it returns disabled, run the enable command again.</p>



<p class="wp-block-paragraph">Enabling automatic startup is strongly recommended for all production OES servers. Without it, NSS audit collection will not resume after a server reboot until an administrator manually starts the service — potentially leaving a significant monitoring gap.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Disabling automatic startup on boot:</strong></p>



<p class="wp-block-paragraph">If automatic startup needs to be disabled (e.g., for a server being decommissioned):</p>



<p class="wp-block-paragraph">systemctl disable ltaudit.service</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Reviewing service logs:</strong></p>



<p class="wp-block-paragraph">If the service fails to start or is behaving unexpectedly, review the agent logs for error details:</p>



<p class="wp-block-paragraph"><strong>General application logs:</strong></p>



<p class="wp-block-paragraph">ls /opt/bluelance/logs/</p>



<p class="wp-block-paragraph"><strong>NSS audit status log:</strong></p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/nssstatus.log</p>



<p class="wp-block-paragraph"><strong>Syslog forwarding log:</strong></p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/syslog_send.log</p>



<p class="wp-block-paragraph"><strong>systemd journal (for service startup errors):</strong></p>



<p class="wp-block-paragraph">journalctl -u ltaudit.service -n 50</p>



<p class="wp-block-paragraph">The -n 50 flag returns the last 50 log entries. Increase this number if you need to look further back.</p>



<p class="wp-block-paragraph">Common errors to look for:</p>



<ul class="wp-block-list">
<li>Connection refused — firewall blocking syslog port</li>



<li>Certificate errors — TLS configuration issue</li>



<li>Permission denied — agent lacks required access to NSS volumes</li>



<li>Failed to open live vigil file — NSS audit subsystem not available</li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Service management after a configuration change:</strong></p>



<p class="wp-block-paragraph">Whenever the syslog forwarding configuration is updated using update_syslog_config.sh, restart the service to apply the new settings:</p>



<p class="wp-block-paragraph">systemctl restart ltaudit.service</p>



<p class="wp-block-paragraph">Confirm the service is running after the restart, then verify that events are appearing in LT Auditor <sup>MP</sup> to confirm the new configuration is working correctly.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Best practices:</strong></p>



<ul class="wp-block-list">
<li>Always check the service status before investigating log collection issues — a stopped service is the most common cause of missing NSS audit data</li>



<li>Enable automatic startup on boot on every production OES server to prevent monitoring gaps after reboots</li>



<li>Restart rather than stop-and-start when applying configuration changes — it is faster and reduces the monitoring gap</li>



<li>Review the nssstatus.log and syslog_send.log as the first step when troubleshooting collection or forwarding issues</li>



<li>Include systemctl status ltaudit.service in your regular OES server health check routine alongside other service checks</li>



<li>Document any planned service interruptions (maintenance windows, upgrades) so the security team is aware of expected monitoring gaps</li>
</ul>



<p class="wp-block-paragraph"><em>[Your administrator should include </em><em>ltaudit</em><em> service status in any OES server monitoring dashboards or health check scripts used in your environment.]</em></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Verifying Audit Log Collection</title>
		<link>https://bluelance.com/docs/verifying-audit-log-collection/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:24:16 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15920</guid>

					<description><![CDATA[After installing and configuring the NSS Audit Agent, and after any significant changes to your eDirectory or NSS auditing configuration, it is important to verify that audit log collection is working end-to-end. This means confirming that events are being generated on your OpenText systems, forwarded to the LT Auditor MP server, and appearing correctly in [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">After installing and configuring the NSS Audit Agent, and after any significant changes to your eDirectory or NSS auditing configuration, it is important to verify that audit log collection is working end-to-end. This means confirming that events are being generated on your OpenText systems, forwarded to the LT Auditor <sup>MP</sup> server, and appearing correctly in the Web UI. This article covers a complete verification workflow for both eDirectory and NSS audit collection.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>When to run a verification check:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Situation</strong></td><td><strong>Verification Needed</strong></td></tr><tr><td>Initial installation of eDirectory or NSS auditing</td><td>Full end-to-end verification for every configured server</td></tr><tr><td>After changing the syslog port or protocol</td><td>Confirm events are still flowing after the change</td></tr><tr><td>After a LT Auditor <sup>MP</sup> server IP address change</td><td>Confirm all OpenText servers are forwarding to the new address</td></tr><tr><td>After an OES server reboot</td><td>Confirm the ltaudit service restarted and is collecting</td></tr><tr><td>After an eDirectory server restart</td><td>Confirm the CEF audit daemon restarted and is forwarding</td></tr><tr><td>Missing events suspected during an investigation</td><td>Targeted verification to identify collection gaps</td></tr><tr><td>Routine health check</td><td>Periodic confirmation that all sources are active</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 1 — Verify the LT Auditor <sup>MP</sup> transformation rules are active:</strong></p>



<p class="wp-block-paragraph">Before checking the OpenText systems, confirm that LT Auditor <sup>MP</sup> is ready to receive data on the correct ports.</p>



<ol class="wp-block-list">
<li>Log in to the LT Auditor <sup>MP</sup> Web UI</li>



<li>Navigate to <strong>Configure</strong></li>



<li>Locate the eDirectory transformation rule (default port 5014) and the NSS transformation rule (default port 5015)</li>



<li>Confirm both rules show a status of <strong>Active</strong></li>



<li>If either rule is inactive, click the <strong>three vertical action buttons</strong> and select <strong>Enable</strong></li>
</ol>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 2 — Verify firewall connectivity from OpenText servers:</strong></p>



<p class="wp-block-paragraph">Confirm that each eDirectory and OES server can reach the LT Auditor <sup>MP</sup> server on the configured syslog ports.</p>



<p class="wp-block-paragraph">Run the following from each OpenText server:</p>



<p class="wp-block-paragraph"><strong>For eDirectory servers (port 5014):</strong></p>



<p class="wp-block-paragraph">nc -zv &lt;LT_AuditorMP_Host&gt; 5014</p>



<p class="wp-block-paragraph"><strong>For OES NSS servers (port 5015):</strong></p>



<p class="wp-block-paragraph">nc -zv &lt;LT_AuditorMP_Host&gt; 5015</p>



<p class="wp-block-paragraph">A successful response confirms connectivity is open. If the connection fails:</p>



<ul class="wp-block-list">
<li>Review firewall rules between the OpenText server and the LT Auditor <sup>MP</sup> server</li>



<li>Confirm the LT Auditor <sup>MP</sup> server is running and the transformation rules are active</li>



<li>Confirm the correct IP address is being used</li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 3 — Verify the eDirectory CEF audit daemon is running:</strong></p>



<p class="wp-block-paragraph">On each eDirectory server, confirm the CEF audit daemon is loaded and active:</p>



<p class="wp-block-paragraph">ndstrace –c &#8220;modules&#8221; | grep cefauditds</p>



<p class="wp-block-paragraph">The output should show cefauditds as a loaded module. If it does not appear:</p>



<p class="wp-block-paragraph">Manually load the daemon:</p>



<p class="wp-block-paragraph">ndstrace –c &#8220;load cefauditds&#8221;</p>



<p class="wp-block-paragraph">Confirm it loads successfully, then check again:</p>



<p class="wp-block-paragraph">ndstrace –c &#8220;modules&#8221; | grep cefauditds</p>



<p class="wp-block-paragraph">Also confirm the audit configuration file is correctly set up:</p>



<p class="wp-block-paragraph">cat /etc/opt/novell/eDirectory/conf/auditlogconfig.properties</p>



<p class="wp-block-paragraph">Verify the host, port, and protocol values match your LT Auditor <sup>MP</sup> transformation rule settings.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 4 — Verify the NSS Audit Agent service is running:</strong></p>



<p class="wp-block-paragraph">On each OES server, confirm the ltaudit service is running:</p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<p class="wp-block-paragraph">The service should show as active (running). If it is stopped or failed:</p>



<p class="wp-block-paragraph">systemctl start ltaudit.service</p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<p class="wp-block-paragraph">Confirm the service returns to active (running) before proceeding.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 5 — Check the NSS audit status log:</strong></p>



<p class="wp-block-paragraph">On each OES server, confirm the NSS Audit Agent has successfully connected to the NSS audit subsystem:</p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/nssstatus.log</p>



<p class="wp-block-paragraph">Confirm the log contains:</p>



<p class="wp-block-paragraph">Successfully opened live vigil file</p>



<p class="wp-block-paragraph">If this message is not present:</p>



<ul class="wp-block-list">
<li>The agent may not have access to the NSS audit subsystem</li>



<li>NSS may not be running or volumes may not be mounted</li>
</ul>



<p class="wp-block-paragraph">Review the general application logs for more detail:<br>ls /opt/bluelance/logs/</p>



<ul class="wp-block-list">
<li></li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 6 — Check the syslog forwarding log:</strong></p>



<p class="wp-block-paragraph">On each OES server, confirm that events are being successfully forwarded to LT Auditor <sup>MP</sup>:</p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/syslog_send.log</p>



<p class="wp-block-paragraph">Look for:</p>



<ul class="wp-block-list">
<li>Successful forwarding messages confirming events are reaching the LT Auditor <sup>MP</sup> server</li>



<li>Any connection errors, timeout messages, or TLS certificate errors that may indicate a forwarding problem</li>
</ul>



<p class="wp-block-paragraph">If forwarding errors are present:</p>



<ul class="wp-block-list">
<li>Confirm network connectivity using the nc test in Step 2</li>



<li>Confirm the port and protocol in the agent configuration match the LT Auditor <sup>MP</sup> transformation rule</li>



<li>If using TLS, confirm certificate configuration is correct on both ends</li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 7 — Generate test events on OpenText systems:</strong></p>



<p class="wp-block-paragraph">To confirm the full end-to-end pipeline is working, generate known test events on your OpenText systems and verify they appear in LT Auditor <sup>MP</sup>.</p>



<p class="wp-block-paragraph"><strong>Generating a test eDirectory event:</strong></p>



<p class="wp-block-paragraph">Perform a simple directory operation that eDirectory auditing is configured to capture — for example, modify an attribute on a test user object in iManager or via an LDAP command:</p>



<p class="wp-block-paragraph">ldapmodify -H ldap://&lt;eDirectory_Host&gt; -D &#8220;&lt;admin_DN&gt;&#8221; -W &lt;&lt;EOF</p>



<p class="wp-block-paragraph">dn: cn=testuser,ou=users,o=yourorg</p>



<p class="wp-block-paragraph">changetype: modify</p>



<p class="wp-block-paragraph">replace: description</p>



<p class="wp-block-paragraph">description: Audit verification test</p>



<p class="wp-block-paragraph">EOF</p>



<p class="wp-block-paragraph"><strong>Generating a test NSS file event:</strong></p>



<p class="wp-block-paragraph">Perform a simple file operation on an NSS volume on the OES server — for example, create and then delete a test file:</p>



<p class="wp-block-paragraph">touch /media/nss/&lt;VolumeName&gt;/audit_verification_test.txt</p>



<p class="wp-block-paragraph">rm /media/nss/&lt;VolumeName&gt;/audit_verification_test.txt</p>



<p class="wp-block-paragraph">Replace &lt;VolumeName&gt; with the name of an NSS volume on the server.</p>



<p class="wp-block-paragraph"><em>[Your administrator should confirm the correct NSS volume mount path used in your environment.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 8 — Verify test events appear in LT Auditor <sup>MP</sup>:</strong></p>



<p class="wp-block-paragraph">After generating test events, confirm they appear in LT Auditor <sup>MP</sup>:</p>



<ol class="wp-block-list">
<li>Log in to the LT Auditor <sup>MP</sup> Web UI</li>



<li>Navigate to <strong>View</strong></li>



<li>Select the relevant environment and category:
<ul class="wp-block-list">
<li>For eDirectory events: eDirectory environment → Object Events or Attribute Events category</li>



<li>For NSS events: NSS environment → File Activity category</li>
</ul>
</li>



<li>Set the date range to <strong>Last 15 minutes</strong></li>



<li>Look for the test events you just generated</li>



<li>Click on a test event row to view full details and confirm the event data is correctly structured and normalized</li>
</ol>



<p class="wp-block-paragraph">If test events do not appear within a few minutes:</p>



<ul class="wp-block-list">
<li>Confirm the relevant daemon or service is running (Steps 3 and 4)<br></li>



<li>Confirm firewall connectivity is open (Step 2)<br></li>



<li>Confirm the transformation rule is active (Step 1)<br></li>



<li>Review the syslog forwarding log for errors (Step 6)<br></li>
</ul>



<p class="wp-block-paragraph">Check the LT Auditor <sup>MP</sup> server logs for any ingestion errors:<br><br>On Linux:<br><br>cd /opt/bluelance/lcollector/logs/general/</p>



<p class="wp-block-paragraph">&nbsp;On Windows:<br><br>\Program Files\Blue Lance 2-0\Collector\Logs\General\</p>



<ul class="wp-block-list">
<li></li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 9 — Confirm all servers are represented as sources:</strong></p>



<p class="wp-block-paragraph">After verifying individual servers, confirm that all configured eDirectory and OES servers are appearing as active sources in LT Auditor <sup>MP</sup>:</p>



<ol class="wp-block-list">
<li>Navigate to <strong>View</strong> in the LT Auditor <sup>MP</sup> Web UI</li>



<li>Select the eDirectory or NSS environment</li>



<li>Set the date range to cover the last 24 hours</li>



<li>Filter by <strong>Source</strong> or <strong>Host</strong> and review the list of servers generating events</li>



<li>Cross-reference against your list of configured servers</li>



<li>If any server is missing from the source list:
<ul class="wp-block-list">
<li>Confirm the CEF audit daemon or ltaudit service is running on that server</li>



<li>Confirm syslog forwarding is configured correctly on that server</li>



<li>Revisit the relevant configuration article for that server type</li>
</ul>
</li>
</ol>



<p class="wp-block-paragraph"><em>[Your administrator should maintain a reference list of all eDirectory and OES servers that should be appearing as sources in LT Auditor <sup>MP</sup>, and use it during routine verification checks to quickly identify any gaps.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Routine verification schedule:</strong></p>



<p class="wp-block-paragraph">Rather than verifying collection only after problems occur, incorporate collection verification into your regular operational routine:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Frequency</strong></td><td><strong>Verification Actions</strong></td></tr><tr><td>Daily</td><td>Check LT Auditor <sup>MP</sup> View for recent eDirectory and NSS events — confirm data is flowing from all sources</td></tr><tr><td>Weekly</td><td>Review the source list to confirm all configured servers are represented</td></tr><tr><td>Monthly</td><td>Run the full end-to-end verification workflow above for a sample of servers</td></tr><tr><td>After any change</td><td>Run targeted verification for any server or configuration that was modified</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><em>[Your administrator should assign ownership of routine verification checks to a specific team member and document the results so the verification history is available for compliance audits.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Common issues and resolutions:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Symptom</strong></td><td><strong>Likely Cause</strong></td><td><strong>Resolution</strong></td></tr><tr><td>No eDirectory events in LT Auditor <sup>MP</sup></td><td>CEF audit daemon not loaded</td><td>Load cefauditds using ndstrace</td></tr><tr><td>No eDirectory events from a specific server</td><td>Syslog forwarding misconfigured</td><td>Review auditlogconfig.properties on that server</td></tr><tr><td>No NSS events in LT Auditor <sup>MP</sup></td><td>ltaudit service stopped</td><td>Start the ltaudit service</td></tr><tr><td>NSS events missing from a specific volume</td><td>Agent lacks access to NSS volume</td><td>Review agent permissions and NSS volume mount</td></tr><tr><td>nssstatus.log missing success message</td><td>NSS audit subsystem unavailable</td><td>Confirm NSS is running and volumes are mounted</td></tr><tr><td>Syslog forwarding errors in log</td><td>Firewall blocking port</td><td>Open the required port between the OES server and LT Auditor <sup>MP</sup></td></tr><tr><td>TLS errors in forwarding log</td><td>Certificate mismatch or expiry</td><td>Review TLS configuration and certificate validity</td></tr><tr><td>Events appearing with incorrect structure</td><td>Transformation rule misconfigured</td><td>Review and update the transformation rule in LT Auditor <sup>MP</sup></td></tr><tr><td>Events delayed or intermittent</td><td>Network congestion or high volume</td><td>Review network path and buffer settings</td></tr><tr><td>Events missing after server reboot</td><td>Service not enabled for auto-start</td><td>Run systemctl enable ltaudit.service</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Best practices:</strong></p>



<ul class="wp-block-list">
<li>Run the full end-to-end verification workflow immediately after initial installation — do not assume the deployment is working without confirming test events appear in LT Auditor <sup>MP</sup></li>



<li>Incorporate routine verification checks into your regular operational schedule rather than waiting for problems to be reported</li>



<li>Maintain a reference list of all configured eDirectory and OES servers and use it during verification to quickly identify any gaps</li>



<li>Generate and retain verification records as evidence of your audit program&#8217;s ongoing effectiveness for compliance audits</li>



<li>Address any identified collection gaps promptly — unmonitored servers represent both a security monitoring gap and a potential compliance violation</li>



<li>Include collection verification in your change management process for any changes to OpenText systems, network infrastructure, or the LT Auditor <sup>MP</sup> server</li>
</ul>



<p class="wp-block-paragraph"><em>[Your administrator should document the results of each verification cycle and retain them as part of your organization&#8217;s compliance evidence library.]</em></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Installing &#038; Configuring the NSS Audit Agent (OES Servers)</title>
		<link>https://bluelance.com/docs/installing-configuring-the-nss-audit-agent-oes-servers/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:23:33 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15916</guid>

					<description><![CDATA[NSS file activity auditing requires a dedicated agent installed on every SLES OES server that hosts NSS volumes you want to monitor. The NSS Audit Agent collects file system activity from NSS volumes and forwards it to the LT Auditor MP server via syslog on port 5015 (or your configured port). This article covers the [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">NSS file activity auditing requires a dedicated agent installed on every SLES OES server that hosts NSS volumes you want to monitor. The NSS Audit Agent collects file system activity from NSS volumes and forwards it to the LT Auditor <sup>MP</sup> server via syslog on port 5015 (or your configured port). This article covers the complete installation and configuration process for the NSS Audit Agent.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Understanding the NSS Audit Agent:</strong></p>



<p class="wp-block-paragraph">Unlike eDirectory auditing which is configured directly within eDirectory itself, NSS file activity auditing requires a separate agent component — the LT Auditor <sup>MP</sup> OES module — to be installed on each OES server hosting NSS volumes. The agent:</p>



<ul class="wp-block-list">
<li>Monitors file system activity on NSS volumes in real time</li>



<li>Captures file reads, writes, deletions, renames, and permission changes</li>



<li>Forwards collected activity to LT Auditor <sup>MP</sup> via syslog</li>



<li>Caches audit streams locally if the LT Auditor <sup>MP</sup> server is temporarily unavailable and automatically resends once connectivity is restored — no audit data is lost during outages</li>
</ul>



<p class="wp-block-paragraph">The agent must be installed individually on each OES server you want to monitor. Missing even one server results in a gap in your NSS file activity audit data.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Prerequisites:</strong></p>



<p class="wp-block-paragraph">Before installing the NSS Audit Agent, confirm the following on each target OES server:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Requirement</strong></td><td><strong>Details</strong></td></tr><tr><td>Operating System</td><td>SLES OES Linux</td></tr><tr><td>Privileges</td><td>Root access required</td></tr><tr><td>NSS Volumes</td><td>At least one NSS volume must be present on the server</td></tr><tr><td>Network Access</td><td>Outbound syslog traffic to the LT Auditor <sup>MP</sup> server on port 5015 must be permitted</td></tr><tr><td>LT Auditor <sup>MP</sup></td><td>Server must be installed and running with the NSS transformation rule configured on port 5015</td></tr><tr><td>Agent Package</td><td>LTAuditorMP-OES-xx.x.x.x-x.x86_64.rpm — obtain from your administrator or Blue Lance</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><em>[Your administrator should confirm the current version of the agent package and where to obtain it for your environment.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 1 — Copy the agent package to the OES server:</strong></p>



<p class="wp-block-paragraph">Copy the agent RPM package to the target OES server. The package filename follows the format:</p>



<p class="wp-block-paragraph">LTAuditorMP-OES-25.0.0.0-0.x86_64.rpm</p>



<p class="wp-block-paragraph"><em>[Your administrator should note the current package filename and version used in your environment here.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 2 — Switch to root:</strong></p>



<p class="wp-block-paragraph">Open a terminal on the OES server and switch to root:</p>



<p class="wp-block-paragraph">su</p>



<p class="wp-block-paragraph">Enter the root password when prompted.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 3 — Install the agent package:</strong></p>



<p class="wp-block-paragraph">Install the RPM package using the following command:</p>



<p class="wp-block-paragraph">rpm -ivh LTAuditorMP-OES-25.0.0.0-0.x86_64.rpm</p>



<p class="wp-block-paragraph">The agent installs to:</p>



<p class="wp-block-paragraph">/opt/bluelance/</p>



<p class="wp-block-paragraph">The installation process:</p>



<ul class="wp-block-list">
<li>Installs the agent binaries and configuration files to /opt/bluelance/</li>



<li>Registers the ltaudit service with systemd</li>



<li>Does not start the service automatically — configuration must be completed first</li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 4 — Configure syslog forwarding:</strong></p>



<p class="wp-block-paragraph">Navigate to the agent bin directory and run the configuration script:</p>



<p class="wp-block-paragraph">cd /opt/bluelance/bin</p>



<p class="wp-block-paragraph">./update_syslog_config.sh</p>



<p class="wp-block-paragraph">The script will prompt you for the following information:</p>



<p class="wp-block-paragraph"><strong>Host/IP of the LT Auditor <sup>MP</sup> server:</strong> Enter the IP address or hostname of your LT Auditor <sup>MP</sup> server:</p>



<p class="wp-block-paragraph">Enter LT Auditor <sup>MP</sup> host: &lt;LT_AuditorMP_IP_or_Hostname></p>



<p class="wp-block-paragraph"><strong>Port:</strong> Enter the port configured in the LT Auditor <sup>MP</sup> NSS transformation rule (default: 5015):</p>



<p class="wp-block-paragraph">Enter port [default: 5015]: 5015</p>



<p class="wp-block-paragraph"><strong>Protocol:</strong> Select the communication protocol to match your LT Auditor <sup>MP</sup> NSS transformation rule:</p>



<p class="wp-block-paragraph">Enter protocol [UDP/TCP/TLS, default: TCP]: TCP</p>



<p class="wp-block-paragraph"><strong>If TLS is selected</strong>, you will be prompted for additional settings:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Prompt</strong></td><td><strong>Description</strong></td><td><strong>Default</strong></td></tr><tr><td>CA Certificate Path</td><td>Path to the CA certificate file for server verification</td><td>None</td></tr><tr><td>Enable Mutual TLS</td><td>Require the agent to present a client certificate</td><td>No</td></tr><tr><td>Verify Server Certificate</td><td>Validate the LT Auditor <sup>MP</sup> server certificate</td><td>Yes</td></tr><tr><td>Server Name</td><td>SNI hostname for certificate validation</td><td>syslog.example.com</td></tr></tbody></table></figure>



<p class="wp-block-paragraph"><em>[Your administrator should update the TLS defaults above with the actual values used in your environment if TLS is selected.]</em></p>



<p class="wp-block-paragraph">Once all prompts are completed, the configuration script automatically saves the settings and starts the required daemons.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 5 — Configure the firewall:</strong></p>



<p class="wp-block-paragraph">Ensure no firewall is blocking outbound traffic from the OES server to the LT Auditor <sup>MP</sup> server on the configured syslog port.</p>



<p class="wp-block-paragraph">Test connectivity from the OES server:</p>



<p class="wp-block-paragraph">nc -zv &lt;LT_AuditorMP_Host&gt; &lt;Port&gt;</p>



<p class="wp-block-paragraph">A successful response confirms the connection is open. If the connection fails, review your firewall rules to permit outbound traffic on the configured port.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 6 — Verify the agent service is running:</strong></p>



<p class="wp-block-paragraph">After the configuration script completes, confirm the ltaudit service is running:</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc status</p>



<p class="wp-block-paragraph">The service should show as <strong>active (running)</strong>. If the service is not running, check the agent logs for errors before proceeding.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 7 — Verify audit log collection:</strong></p>



<p class="wp-block-paragraph">After confirming the service is running, verify that NSS audit data is being collected and forwarded to LT Auditor <sup>MP</sup>:</p>



<p class="wp-block-paragraph"><strong>Check NSS audit status:</strong></p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/nssstatus.log</p>



<p class="wp-block-paragraph">Confirm the file contains:</p>



<p class="wp-block-paragraph">Successfully opened live vigil file</p>



<p class="wp-block-paragraph">This message confirms the agent has successfully connected to the NSS audit subsystem and is collecting file activity data.</p>



<p class="wp-block-paragraph"><strong>Review general application logs:</strong></p>



<p class="wp-block-paragraph">ls /opt/bluelance/logs/</p>



<p class="wp-block-paragraph"><strong>Check for forwarding failures:</strong></p>



<p class="wp-block-paragraph">cat /opt/bluelance/log/syslog_send.log</p>



<p class="wp-block-paragraph">Review this log for any errors related to forwarding data to the LT Auditor <sup>MP</sup> server.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Step 8 — Verify data in LT Auditor <sup>MP</sup>:</strong></p>



<p class="wp-block-paragraph">Confirm that NSS file activity data is appearing in LT Auditor <sup>MP</sup>:</p>



<ol class="wp-block-list">
<li>Log in to the LT Auditor <sup>MP</sup> Web UI</li>



<li>Navigate to <strong>View</strong></li>



<li>Select the NSS environment and category</li>



<li>Set the date range to <strong>Last 15–30 minutes</strong></li>



<li>Perform a file operation on an NSS volume on the configured server (e.g., create or modify a file)</li>



<li>Confirm the event appears in the LT Auditor <sup>MP</sup> event list within a short period</li>
</ol>



<p class="wp-block-paragraph">If no events appear:</p>



<ul class="wp-block-list">
<li>Confirm the ltaudit service is running on the OES server</li>



<li>Confirm the nssstatus.log shows Successfully opened live vigil file</li>



<li>Confirm no firewall is blocking traffic on the configured syslog port</li>



<li>Confirm the port and protocol in the agent configuration match the LT Auditor <sup>MP</sup> NSS transformation rule settings</li>



<li>Review the syslog_send.log for forwarding errors</li>
</ul>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Managing the NSS Audit Agent service:</strong></p>



<p class="wp-block-paragraph">Use the following commands to manage the ltaudit service after installation:</p>



<p class="wp-block-paragraph"><strong>Using systemctl:</strong></p>



<p class="wp-block-paragraph"># Start the service</p>



<p class="wp-block-paragraph">systemctl start ltaudit.service</p>



<p class="wp-block-paragraph"># Stop the service</p>



<p class="wp-block-paragraph">systemctl stop ltaudit.service</p>



<p class="wp-block-paragraph"># Restart the service</p>



<p class="wp-block-paragraph">systemctl restart ltaudit.service</p>



<p class="wp-block-paragraph"># Check service status</p>



<p class="wp-block-paragraph">systemctl status ltaudit.service</p>



<p class="wp-block-paragraph"># Enable the service to start automatically on boot</p>



<p class="wp-block-paragraph">systemctl enable ltaudit.service</p>



<p class="wp-block-paragraph"><strong>Using the control script:</strong></p>



<p class="wp-block-paragraph"># Start the service</p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc start</p>



<p class="wp-block-paragraph"># Stop the service</p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc stop</p>



<p class="wp-block-paragraph"># Check service status</p>



<p class="wp-block-paragraph">/opt/bluelance/bin/ltaudit.rc status</p>



<p class="wp-block-paragraph">Enable the service to start automatically on boot using systemctl enable ltaudit.service to ensure NSS audit collection resumes automatically after a server reboot without manual intervention.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Caching behavior during LT Auditor <sup>MP</sup> outages:</strong></p>



<p class="wp-block-paragraph">If the LT Auditor <sup>MP</sup> server is temporarily unavailable, the NSS Audit Agent automatically caches audit streams locally on the OES server. Once connectivity to the LT Auditor <sup>MP</sup> server is restored, the cached data is automatically forwarded — no NSS audit events are lost during outages.</p>



<p class="wp-block-paragraph">This behavior is built into the agent and requires no additional configuration.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Repeating installation across all OES servers:</strong></p>



<p class="wp-block-paragraph">Repeat all steps in this article for every OES server in your environment that hosts NSS volumes you want to monitor. Each server must have the agent installed and configured individually.</p>



<p class="wp-block-paragraph">To confirm all servers are forwarding:</p>



<ol class="wp-block-list">
<li>Navigate to <strong>View</strong> in the LT Auditor <sup>MP</sup> Web UI</li>



<li>Filter by <strong>Source</strong> or <strong>Host</strong></li>



<li>Confirm NSS file activity events are appearing from each OES server</li>



<li>If any server is not appearing as a source, revisit the installation and configuration on that server</li>
</ol>



<p class="wp-block-paragraph"><em>[Your administrator should maintain a list of all OES servers in the environment, confirm each one has been installed and verified, and document the agent version, configuration date, and protocol used for each server.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Uninstalling the NSS Audit Agent:</strong></p>



<p class="wp-block-paragraph">If the agent needs to be removed from an OES server:</p>



<ol class="wp-block-list">
<li>Stop the service:</li>
</ol>



<p class="wp-block-paragraph">systemctl stop ltaudit.service</p>



<ol start="2" class="wp-block-list">
<li>Remove the RPM package:</li>
</ol>



<p class="wp-block-paragraph">rpm -e LTAuditorMP-OES</p>



<ol start="3" class="wp-block-list">
<li>Confirm the package has been removed:</li>
</ol>



<p class="wp-block-paragraph">rpm -qa | grep LTAuditorMP</p>



<p class="wp-block-paragraph">No output confirms the package has been successfully removed.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Best practices:</strong></p>



<ul class="wp-block-list">
<li>Install the agent on all OES servers hosting NSS volumes before considering the deployment complete — a single unmonitored server is a gap in your audit coverage</li>



<li>Always verify the nssstatus.log after installation to confirm the agent has successfully connected to the NSS audit subsystem</li>



<li>Enable the ltaudit service to start automatically on boot on every OES server to prevent monitoring gaps after reboots</li>



<li>Use TCP or TLS in production environments for reliable log delivery</li>



<li>Test firewall connectivity before running the configuration script to catch network issues early</li>



<li>Document the agent version, configuration date, port, and protocol for each OES server</li>



<li>Include NSS Audit Agent installation in your OES server provisioning checklist so new servers are automatically configured for monitoring when they are deployed</li>
</ul>



<p class="wp-block-paragraph"><em>[Your administrator should revisit agent installations whenever the LT Auditor <sup>MP</sup> server IP address or NSS syslog port changes, as the agent configuration will need to be updated on every OES server to reflect the new values.]</em></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Installing PowerShell Orchestrator</title>
		<link>https://bluelance.com/docs/installing-powershell-orchestrator/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:20:59 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15868</guid>

					<description><![CDATA[PowerShell Orchestrator is installed on a Windows machine that has network access to your Active Directory domain controllers and Microsoft Entra ID tenant. The installation package is available as a zip file from the Blue Lance download portal. Complete the LT Auditor MP server installation before deploying PowerShell Orchestrator. Prerequisites: Before installing, confirm the following: [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">PowerShell Orchestrator is installed on a Windows machine that has network access to your Active Directory domain controllers and Microsoft Entra ID tenant. The installation package is available as a zip file from the Blue Lance download portal. Complete the LT Auditor <sup>MP</sup> server installation before deploying PowerShell Orchestrator.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Prerequisites:</strong></p>



<p class="wp-block-paragraph">Before installing, confirm the following:</p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Requirement</strong></td><td><strong>Details</strong></td></tr><tr><td>LT Auditor <sup>MP</sup> Server</td><td>Must be installed and running before deploying PowerShell Orchestrator</td></tr><tr><td>Operating System</td><td>Windows Server 2019 or newer</td></tr><tr><td>PowerShell Version</td><td>PowerShell 5.1 or PowerShell 7+</td></tr><tr><td>WinRM</td><td>Must be enabled on the machine running the orchestrator and all target endpoints</td></tr><tr><td>Service Account</td><td>A dedicated service account with read permissions across Active Directory and Entra ID</td></tr><tr><td>Network Access</td><td>Must be able to reach domain controllers, Entra ID, and the LT Auditor <sup>MP</sup> server</td></tr><tr><td>Privileges</td><td>Administrator privileges required on the installation machine</td></tr><tr><td>Download Package</td><td>lta-mp-orchestrator.zip obtained from the Blue Lance download portal</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">Download the PowerShell Orchestrator package:</p>



<p class="wp-block-paragraph"><em>[Your administrator should confirm whether packages are distributed internally or downloaded directly from the portal in your environment.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Enabling WinRM on the installation machine:</strong></p>



<p class="wp-block-paragraph">If WinRM is not already enabled, run the following in PowerShell as Administrator:</p>



<p class="wp-block-paragraph">Enable-PSRemoting -Force</p>



<p class="wp-block-paragraph">Confirm WinRM is running:</p>



<p class="wp-block-paragraph">Get-Service WinRM</p>



<p class="wp-block-paragraph">The service should show as <strong>Running</strong>.</p>



<p class="wp-block-paragraph"><em>[Your administrator should confirm whether WinRM is managed via Group Policy in your environment before enabling it manually.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Installation steps:</strong></p>



<ol class="wp-block-list">
<li>Copy the lta-mp-orchestrator.zip package to the target Windows machine<br></li>



<li>Extract the zip file to a working directory<br></li>



<li>Open <strong>PowerShell as Administrator</strong> and navigate to the extracted directory:<br></li>
</ol>



<p class="wp-block-paragraph">cd C:\path\to\extracted\orchestrator</p>



<ol start="4" class="wp-block-list">
<li>If not already done, allow PowerShell scripts to run:</li>
</ol>



<p class="wp-block-paragraph">Set-ExecutionPolicy Unrestricted</p>



<ol start="5" class="wp-block-list">
<li>Run the installation script:</li>
</ol>



<p class="wp-block-paragraph">.\Install.ps1</p>



<ol start="6" class="wp-block-list">
<li>Follow any on-screen prompts during installation, including:<br>
<ul class="wp-block-list">
<li>Entering the LT Auditor <sup>MP</sup> server IP address or hostname</li>



<li>Confirming the syslog port (default: 514)</li>



<li>Selecting the communication protocol (UDP, TCP, or TLS)</li>



<li>Entering the service account credentials to be used for Active Directory and Entra ID assessments</li>
</ul>
</li>



<li>Once installation is complete, reset the PowerShell execution policy:<br></li>
</ol>



<p class="wp-block-paragraph">Set-ExecutionPolicy Restricted</p>



<p class="wp-block-paragraph"><em>[Your administrator should fill in the exact installer prompts and any environment-specific options that appear during installation.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Post-installation verification:</strong></p>



<p class="wp-block-paragraph">After installation completes, confirm that PowerShell Orchestrator is running and communicating with the LT Auditor <sup>MP</sup> server.</p>



<ol class="wp-block-list">
<li>Check the service status:</li>
</ol>



<p class="wp-block-paragraph">sc query PowerShellOrchestrator</p>



<p class="wp-block-paragraph">The service should show as <strong>Running</strong>.</p>



<ol start="2" class="wp-block-list">
<li>In the LT Auditor <sup>MP</sup> Web UI, navigate to <strong>Admin → Modules</strong> and confirm the PowerShell Orchestrator instance appears with a status of <strong>Connected<br></strong></li>



<li>Check the PowerShell Orchestrator logs for any errors:<br></li>
</ol>



<p class="wp-block-paragraph">\Program Files\Blue Lance 2-0\PowerShellOrchestrator\Logs\</p>



<ol start="4" class="wp-block-list">
<li>Verify that assessment data is appearing in the LT Auditor <sup>MP</sup> <strong>View</strong> module by navigating to <strong>View</strong> and selecting the Active Directory environment</li>
</ol>



<p class="wp-block-paragraph">If the module does not appear as connected in the Web UI, confirm that no firewall is blocking communication between the installation machine and the LT Auditor <sup>MP</sup> server on the configured syslog port.</p>



<p class="wp-block-paragraph"><em>[Your administrator should note the specific port, protocol, and service account used in your environment, and document which machine PowerShell Orchestrator is installed on.]</em></p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Verifying service account permissions:</strong></p>



<p class="wp-block-paragraph">The service account used by PowerShell Orchestrator requires the following minimum permissions:</p>



<p class="wp-block-paragraph"><strong>Active Directory:</strong></p>



<ul class="wp-block-list">
<li>Read access to all user, group, and computer objects in the monitored domains</li>



<li>Read access to Group Policy Objects (GPOs)</li>



<li>Read access to Active Directory Sites and Services</li>
</ul>



<p class="wp-block-paragraph"><strong>Microsoft Entra ID:</strong></p>



<ul class="wp-block-list">
<li>Directory.Read.All — read access to directory objects</li>



<li>AuditLog.Read.All — read access to audit logs</li>



<li>Policy.Read.All — read access to conditional access and other policies</li>
</ul>



<p class="wp-block-paragraph"><em>[Your administrator should confirm the exact permissions required in your environment and ensure the service account is configured accordingly before running the first assessment.]</em></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Troubleshooting</title>
		<link>https://bluelance.com/docs/troubleshooting-log-collection/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:20:08 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15864</guid>

					<description><![CDATA[This article covers the most common issues encountered with EventLogCentral and EventLogAgent and how to resolve them. Work through the relevant section below based on the type of issue you are experiencing. Login issues: Problem Resolution Cannot log in with credentials Verify username and password — passwords are case-sensitive. Check if the account is locked [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">This article covers the most common issues encountered with EventLogCentral and EventLogAgent and how to resolve them. Work through the relevant section below based on the type of issue you are experiencing.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Login issues:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Problem</strong></td><td><strong>Resolution</strong></td></tr><tr><td>Cannot log in with credentials</td><td>Verify username and password — passwords are case-sensitive. Check if the account is locked and wait 15 minutes if so. Ensure you are using the correct URL (HTTP vs HTTPS). Clear browser cookies and try again.</td></tr><tr><td>Account locked</td><td>After 5 failed login attempts accounts are locked for 15 minutes. Wait 15 minutes or contact an administrator to unlock the account.</td></tr><tr><td>Session expires too quickly</td><td>Sessions expire after 60 minutes of inactivity. Keep the browser tab active. Contact your administrator to adjust the session timeout if needed.</td></tr><tr><td>Login page not accessible</td><td>Confirm the LT Auditor <sup>MP</sup> Event Log Server Service is running on the EventLogCentral server. Confirm no firewall is blocking port 52966.</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Client issues:</strong></p>



<p class="wp-block-paragraph"><strong>Client not appearing in the client list:</strong></p>



<ol class="wp-block-list">
<li>Verify the EventLogAgent service is installed and running on the client machine:</li>
</ol>



<p class="wp-block-paragraph">sc query LTA_EventLogAgent</p>



<ol start="2" class="wp-block-list">
<li>Confirm the appsettings.json on the agent machine points to the correct EventLogCentral server address and port</li>



<li>Check for network connectivity issues between the client and the EventLogCentral server</li>



<li>If using self-signed certificates, confirm the ltaeventlog.cer file has been installed on the client machine via Install-Rootcert.ps1</li>



<li>Review the agent logs for errors:</li>
</ol>



<p class="wp-block-paragraph">C:\Program Files\Blue Lance 2-0\LTA_EventLogAgent\logs</p>



<p class="wp-block-paragraph"><strong>Client showing as Offline:</strong></p>



<ol class="wp-block-list">
<li>Confirm the EventLogAgent service is running on the client:</li>
</ol>



<p class="wp-block-paragraph">sc query LTA_EventLogAgent</p>



<ol start="2" class="wp-block-list">
<li>Verify the agent configuration points to the correct EventLogCentral server address</li>



<li>Check for network connectivity or firewall issues between the agent and the server on port 52966</li>



<li>Review agent logs for connectivity or authentication errors</li>
</ol>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Configuration issues:</strong></p>



<p class="wp-block-paragraph"><strong>Configuration changes not applying to clients:</strong></p>



<ol class="wp-block-list">
<li>Wait for the next heartbeat cycle — agents retrieve configuration updates every 5 minutes by default</li>



<li>Check the client&#8217;s <strong>Last Heartbeat</strong> timestamp in the Clients page to confirm the agent is checking in</li>



<li>Use <strong>Force Configuration Sync</strong> from the client actions menu to trigger an immediate update</li>



<li>Restart the EventLogAgent service on the client if Force Configuration Sync does not resolve the issue:</li>
</ol>



<p class="wp-block-paragraph">Restart-Service LTA_EventLogAgent</p>



<ol start="5" class="wp-block-list">
<li>Verify the client is assigned to the correct group</li>
</ol>



<p class="wp-block-paragraph"><strong>Events not being forwarded:</strong></p>



<ol class="wp-block-list">
<li>Verify the syslog target is configured correctly in the <strong>Targets</strong> section</li>



<li>Confirm a sender is assigned to the client&#8217;s group in the <strong>Sender</strong> configuration</li>



<li>Test network connectivity to the syslog target using <strong>Test Connection</strong> in the Targets page</li>



<li>Check if Windows auditing is enabled on the client for the relevant event categories — EventLogAgent can only collect events that Windows is generating</li>



<li>Review the Event Log configuration for the group — confirm the relevant log channels and Event IDs are enabled</li>



<li>Review audit policies for the group — confirm no DENY policy is suppressing the expected events</li>



<li>Review agent logs for forwarding errors:</li>
</ol>



<p class="wp-block-paragraph">C:\Program Files\Blue Lance 2-0\LTA_EventLogAgent\logs</p>



<p class="wp-block-paragraph"><strong>File audit not working:</strong></p>



<ol class="wp-block-list">
<li>Confirm Windows Object Access auditing is enabled on the client machine via Group Policy:</li>
</ol>



<p class="wp-block-paragraph">Computer Configuration → Policies → Windows Settings →</p>



<p class="wp-block-paragraph">Security Settings → Advanced Audit Policy Configuration →</p>



<p class="wp-block-paragraph">Object Access → Audit File System</p>



<ol start="2" class="wp-block-list">
<li>Confirm the monitored path exists and is accessible on the client machine</li>



<li>Confirm the EventLogAgent service account has appropriate permissions to the monitored path</li>



<li>Verify include and exclude patterns in the file audit rule are not filtering out the expected files</li>



<li>Confirm no audit policy DENY rule is suppressing Windows Security Event IDs 4656 or 4670</li>
</ol>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Performance issues:</strong></p>



<p class="wp-block-paragraph"><strong>Too many events being forwarded:</strong></p>



<ol class="wp-block-list">
<li>Add Exclude Event IDs to the group&#8217;s Event Log configuration for high-volume, low-value events</li>



<li>Create DENY audit policies to suppress routine events such as service account logons</li>



<li>Refine file audit rules — add Exclude Patterns to filter out temporary files and use Include Patterns to limit monitoring to relevant file types</li>



<li>Review which log channels are enabled for the group and disable any that are not required</li>
</ol>



<p class="wp-block-paragraph"><strong>Web interface slow to load:</strong></p>



<ol class="wp-block-list">
<li>Reduce the page size in the client list — use 10 or 25 items per page rather than 100</li>



<li>Use the search bar to filter results rather than loading the full client list</li>



<li>Check server resource utilization on the EventLogCentral server</li>



<li>Review the EventLogCentral server logs for database performance issues:</li>
</ol>



<p class="wp-block-paragraph">C:\Program Files\Blue Lance 2-0\LTA_EventLogCentral\logs</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Common error messages:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Error Message</strong></td><td><strong>Cause</strong></td><td><strong>Resolution</strong></td></tr><tr><td>Invalid username or password</td><td>Incorrect credentials or Caps Lock active</td><td>Verify credentials and check Caps Lock</td></tr><tr><td>Access Denied</td><td>User role does not have permission for the action</td><td>Contact an administrator to adjust role permissions</td></tr><tr><td>Configuration sync failed</td><td>Network connectivity issue between agent and server</td><td>Check connectivity and review server logs</td></tr><tr><td>Target unreachable</td><td>Syslog server offline or firewall blocking the port</td><td>Verify server address, port, and firewall rules</td></tr><tr><td>Certificate error</td><td>TLS certificate not trusted by the agent</td><td>Confirm ltaeventlog.cer is installed on the agent machine</td></tr><tr><td>Service failed to start</td><td>Configuration error or port conflict</td><td>Review EventLogCentral server logs for startup errors</td></tr></tbody></table></figure>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Log file locations:</strong></p>



<figure class="wp-block-table"><table class="has-fixed-layout"><tbody><tr><td><strong>Component</strong></td><td><strong>Log Location</strong></td></tr><tr><td>EventLogCentral Server</td><td>C:\Program Files\Blue Lance 2-0\LTA_EventLogCentral\logs</td></tr><tr><td>EventLogAgent Client</td><td>C:\Program Files\Blue Lance 2-0\LTA_EventLogAgent\logs</td></tr></tbody></table></figure>



<p class="wp-block-paragraph">When contacting support or escalating an issue, include relevant excerpts from both log locations along with a description of the problem and steps already taken to resolve it.</p>



<hr class="wp-block-separator has-alpha-channel-opacity"/>



<p class="wp-block-paragraph"><strong>Contacting support:</strong></p>



<p class="wp-block-paragraph">If the troubleshooting steps above do not resolve the issue, contact Blue Lance support at: support@bluelance.com</p>



<p class="wp-block-paragraph">When contacting support, provide:</p>



<ul class="wp-block-list">
<li>A detailed description of the problem</li>



<li>Steps taken to reproduce the issue</li>



<li>Exact error messages</li>



<li>Relevant log file excerpts</li>



<li>System information including OS version and EventLogCentral version</li>
</ul>



<p class="wp-block-paragraph"></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Common Installation Issues</title>
		<link>https://bluelance.com/docs/common-installation-issues/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:17:37 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15834</guid>

					<description><![CDATA[If you encounter problems during or after installation, refer to the common issues and resolutions below. For issues not covered here, check the application logs first before contacting support. Cannot access from remote machines The server was likely configured using 127.0.0.1 (localhost) as the IP address during installation. This restricts access to the local machine [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">If you encounter problems during or after installation, refer to the common issues and resolutions below. For issues not covered here, check the application logs first before contacting support.</p>



<p class="wp-block-paragraph"><strong>Cannot access from remote machines</strong> The server was likely configured using 127.0.0.1 (localhost) as the IP address during installation. This restricts access to the local machine only. Reconfigure the server using its actual IP address or domain name.</p>



<p class="wp-block-paragraph"><strong>SMTP not working</strong> Email/alert delivery settings can be reconfigured after installation by editing the configuration files in the installation directory. You do not need to reinstall.</p>



<p class="wp-block-paragraph"><strong>Port conflicts</strong> If a required port is already in use by another application, the service will fail to start. Confirm all required ports are free before installation. Use the following to check for port conflicts:</p>



<p class="wp-block-paragraph">On Linux:</p>



<p class="wp-block-paragraph">sudo ss -tulnp | grep &lt;port&gt;</p>



<p class="wp-block-paragraph">On Windows:</p>



<p class="wp-block-paragraph">netstat -ano | findstr &lt;port&gt;</p>



<p class="wp-block-paragraph"><strong>Service errors on startup</strong> Check the application logs for error details:</p>



<p class="wp-block-paragraph">On Linux:</p>



<p class="wp-block-paragraph">cd /opt/bluelance/lcollector/logs/general/</p>



<p class="wp-block-paragraph">cd /opt/bluelance/web/server/logs/</p>



<p class="wp-block-paragraph">On Windows:</p>



<p class="wp-block-paragraph">\Program Files\Blue Lance 2-0\Web\Apps\Logs\</p>



<p class="wp-block-paragraph">\Program Files\Blue Lance 2-0\Collector\Logs\General\</p>



<p class="wp-block-paragraph"><strong>Services not starting automatically on reboot (Linux)</strong> If services do not restart after a system reboot, ensure they are enabled:</p>



<p class="wp-block-paragraph">sudo systemctl enable lta-web</p>



<p class="wp-block-paragraph">sudo systemctl enable lta-collector</p>



<p class="wp-block-paragraph"><strong>PowerShell execution policy error (Windows)</strong> If the installation script fails to run, confirm the execution policy is set correctly before running the installer:</p>



<p class="wp-block-paragraph">Set-ExecutionPolicy Unrestricted</p>



<p class="wp-block-paragraph">Remember to reset it after installation completes:</p>



<p class="wp-block-paragraph">Set-ExecutionPolicy Restricted</p>



<p class="wp-block-paragraph">For additional support, refer to the Blue Lance documentation at<a href="https://www.bluelance.com/docs"> https://www.bluelance.com/docs</a> or contact your system administrator.</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Windows Post-Installation Verification</title>
		<link>https://bluelance.com/docs/windows-post-installation-verification/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:17:27 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15827</guid>

					<description><![CDATA[After installation completes, verify that all services are running correctly before proceeding with configuration. Check service status: sc query LTA_Web sc query LTA_Server sc query LTA_DataCollector All three services should show as running. If any service is not running, check the logs for errors before continuing. Check logs for errors or warnings: \Program Files\Blue Lance [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">After installation completes, verify that all services are running correctly before proceeding with configuration.</p>



<p class="wp-block-paragraph"><strong>Check service status:</strong></p>



<p class="wp-block-paragraph">sc query LTA_Web</p>



<p class="wp-block-paragraph">sc query LTA_Server</p>



<p class="wp-block-paragraph">sc query LTA_DataCollector</p>



<p class="wp-block-paragraph">All three services should show as running. If any service is not running, check the logs for errors before continuing.</p>



<p class="wp-block-paragraph"><strong>Check logs for errors or warnings:</strong></p>



<p class="wp-block-paragraph">\Program Files\Blue Lance 2-0\Web\Apps\Logs\</p>



<p class="wp-block-paragraph">\Program Files\Blue Lance 2-0\Collector\Logs\General\</p>



<p class="wp-block-paragraph"><em>[Your administrator should note any expected output or common first-run messages specific to your environment.]</em></p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Managing Services with systemctl</title>
		<link>https://bluelance.com/docs/managing-services-with-systemctl/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:16:23 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15818</guid>

					<description><![CDATA[Use the following systemctl commands to manage the LT Auditor MP services at the system level. Start a service: sudo systemctl start lta-web sudo systemctl start lta-collector Restart a service: sudo systemctl restart lta-web sudo systemctl restart lta-collector Stop a service: sudo systemctl stop lta-web sudo systemctl stop lta-collector Check service status: sudo systemctl status [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">Use the following systemctl commands to manage the LT Auditor <sup>MP</sup> services at the system level.</p>



<p class="wp-block-paragraph"><strong>Start a service:</strong></p>



<p class="wp-block-paragraph">sudo systemctl start lta-web</p>



<p class="wp-block-paragraph">sudo systemctl start lta-collector</p>



<p class="wp-block-paragraph"><strong>Restart a service:</strong></p>



<p class="wp-block-paragraph">sudo systemctl restart lta-web</p>



<p class="wp-block-paragraph">sudo systemctl restart lta-collector</p>



<p class="wp-block-paragraph"><strong>Stop a service:</strong></p>



<p class="wp-block-paragraph">sudo systemctl stop lta-web</p>



<p class="wp-block-paragraph">sudo systemctl stop lta-collector</p>



<p class="wp-block-paragraph"><strong>Check service status:</strong></p>



<p class="wp-block-paragraph">sudo systemctl status lta-web</p>



<p class="wp-block-paragraph">sudo systemctl status lta-collector</p>



<p class="wp-block-paragraph"><strong>Enable services to start automatically on boot:</strong></p>



<p class="wp-block-paragraph">sudo systemctl enable lta-web</p>



<p class="wp-block-paragraph">sudo systemctl enable lta-collector</p>
]]></content:encoded>
					
		
		
			</item>
		<item>
		<title>Linux Post-Installation Verification</title>
		<link>https://bluelance.com/docs/linux-post-installation-verification/</link>
		
		<dc:creator><![CDATA[peter thomas]]></dc:creator>
		<pubDate>Thu, 28 May 2026 16:16:19 +0000</pubDate>
				<guid isPermaLink="false">https://bluelance.com/?post_type=docs&#038;p=15822</guid>

					<description><![CDATA[After installation completes, verify that all services are running correctly before proceeding with configuration. Check service status: systemctl status lta-web systemctl status lta-collector Both services should show as active and running. If either service is not running, check the logs for errors before continuing. Check logs for errors or warnings: cd /opt/bluelance/lcollector/logs/general/ cd /opt/bluelance/web/server/logs/ [Your [&#8230;]]]></description>
										<content:encoded><![CDATA[
<p class="wp-block-paragraph">After installation completes, verify that all services are running correctly before proceeding with configuration.</p>



<p class="wp-block-paragraph"><strong>Check service status:</strong></p>



<p class="wp-block-paragraph">systemctl status lta-web</p>



<p class="wp-block-paragraph">systemctl status lta-collector</p>



<p class="wp-block-paragraph">Both services should show as active and running. If either service is not running, check the logs for errors before continuing.</p>



<p class="wp-block-paragraph"><strong>Check logs for errors or warnings:</strong></p>



<p class="wp-block-paragraph">cd /opt/bluelance/lcollector/logs/general/</p>



<p class="wp-block-paragraph">cd /opt/bluelance/web/server/logs/</p>



<p class="wp-block-paragraph"><em>[Your administrator should note any expected output or common first-run messages specific to your environment.]</em></p>
]]></content:encoded>
					
		
		
			</item>
	</channel>
</rss>
