Kiwi Syslog Server NG Installation and Upgrade Guide
KSS NG receives syslog messages and SNMP traps from network devices such as routers, switches, and firewalls. You can customize KSS NG to automatically respond to messages that meet the specified criteria.
Use the information in this guide to prepare your environment and install KSS NG. If you have already installed KSS NG and would like to upgrade to the newest version, see the KSS NG Upgrade Guide.
Download the PDF: KSS NG Installation Guide
KSS NG is separate from the legacy Kiwi Syslog Server (KSS). If you installed the legacy version of KSS, you must uninstall it before installing KSS NG. Legacy KSS and KSS NG cannot be installed on the same machine due to using the same port numbers.
Prepare the server to install KSS NG
Review release notes | Review the KSS NG release notes. | |
Review system requirements |
Verify that the server meets the minimum hardware and software requirements. |
|
Run all Windows updates | Check for and run all Microsoft Windows Updates on the server. If a Windows update runs, your system might reboot. | |
Open ports |
Verify that the server's firewall allows traffic to pass through the required ports for KSS NG. |
Installation steps for KSS NG
Download the installation file |
Complete the following steps for new and existing users:
Evaluators: Download your free 14-day evaluation from https://www.solarwinds.com/kiwi-syslog-server. |
|
Run the installation file |
|
|
Complete the Kiwi Syslog Server Setup wizard |
|
|
Close the wizard |
In the Installation Complete window, click Close to complete the installation. |
|
Activate your license |
Enter a license key to activate the licensed edition of KSS NG. |
Perform a silent installation of KSS NG
You can perform a silent install with command line parameters if:
- Installing the service failed.
- You need to run the command from a batch file to automate the installation.
Verify the installation file. | Check that the KiwiSyslogServerNG_<version>.exe . installation file has been downloaded to perform the silent install of KSS NG. |
|
Perform the install. |
Use the following command line format to perform the silent install.
Add parameters as needed before executing the command. See the table below. |
|
Examples |
Install KSS NG in Demo mode with the password
Install Kiwi NG with the password
|
Parameters for silent installation
Parameters are not case sensitive. If you specify more than one parameter at a time, separate the values with a space.
Parameter name | Required or optional | Description |
---|---|---|
fileName
|
Required | The name of the installation file. |
/q
|
Required | Execute the installation in quiet mode. |
PASS
|
Required |
Password for access to the KSS NG user interface. Passwords must be 8-100 digits and include at least one special character, one numerical digit, one upper case letter, and one lower case letter. |
INSTALLDIR
|
Optional | Path to the destination folder. The default destination path is [ProgramFilesFolder]SolarWinds\Kiwi Syslog Server NG . |
DEMOMODE
|
Optional | True or false value to determine if you are downloading in Demo mode. The default value is FALSE . |
PENDOCONSENT
|
Optional | True or false value to determine if you consent to Pendo using your product data. The default value is FALSE . |
PORT
|
Optional | Numeric value from 0-65535 to determine the endpoint port number. The default value is 5000. |
Perform a silent uninstallation
You can perform a silent install with command line parameters if:
- Uninstalling the service failed.
- You need to run the command from a batch file to automate the installation.
To silently uninstall KSS NG, run the command fileName.exe /q /uninstall
.
Log files for install and uninstall data
After you have completed the install or uninstall process in the command line, use the command /log logfilename.txt
to log the data. Logging your install and uninstall processes allows you to view all parameters provided in the command line. See the example below.
KiwiSyslogServerNG.v1.2.1.4.exe /log debugInstKssNG.txt
If you want to create, share, or store logs, you must remove the password if you previously created on in the command line.
Next steps after installing KSS NG
- See the KSS NG Getting Started Guide for configuration information and troubleshooting tips.
- Migrate rules from your previous KSS environment to KSS NG.
- Learn how to add rules, filters, and actions.