Bulk Server Import with Live Optics (Host Optics only)
The Live Optics software is designed to be used in both small and large IT environments. As IT assets increase in number, the process of adding servers manually to Live Optics can increase to where using the manual connection of remote servers becomes less efficient. This KB article is designed to show how to use a text file and the bulk import function to import a list of servers into the Native Win32 Version of Live Optics.
*NOTE: The Native Win32 version of Live Optics will only perform the host based performance collection.
The bulk import functions require the use of the Native Win32 Live Optics collector (Host Optics Only). This can be download in the same area as the .NET collector in your Live Optics Dashboard.
Step 1: Create text file
Before running the Live Optics collector, you should first create the list of servers that need to be imported into Live Optics.
- Open your preferred text editing software and create a new text file.
- Due to the nature of the server import function in Live Optics, servers with Windows OS's and Linux OS's need to be saved into separate text files. Add all of the servers to be imported into Live Optics. You can list each server by either its IP address or its hostname.
- Save the text file in the folder where Live Optics was extracted and select the .txt file type.
Step 2: Run Live Optics from the command line
- Open a command prompt from the computer where Live Optics will be executed
- Navigate to the folder where the Live Optics software and server list text file were saved.
- There are two different ways to run Live Optics from the command prompt to import a server list. Depending on the importing of Windows based and/or Linux based server, you should use the following Live Optics command line arguments.
- .\LiveOpticsNativeWindows.exe /wmitargets="Windows.txt" /sshtargets="Linux.txt"
Note: At this time, only the Windows Live Optics collector supports importing lists of server addresses using this method. The Linux Live Optics collectors do not support importing a server list from a file.
Step 3: Enter authentication credentials when prompted
Optical Prime will attempt to connect to each server in the order listed in the files. Optical Prime will prompt for a username and password, and will pass those credentials for each server in the list. If a server rejects the credentials, Optical Prime will prompt for new credentials, and those will be used for the remainder of the list. If connecting to both WMI and SSH targets, Optical Prime will first process the WMI list, and then prompt for a new set of credentials when starting the SSH target list.
This method of configuring Optical Prime should only be used if the following criteria are met:
- The same user account will be used to access all of the servers within a given target list file.
- If more than one user account is required, all of the servers exist within your organizations private network and are considered trusted.
Step 4: Configure Live Optics and begin collector run
The final step is to configure the remaining options in Live Optics and begin the collector run. Once the collector run has started, Live Optics will continue to run collecting performance information on all of the servers imported into it. At this time, a project can be created and the data can be reviewed.