Use > UCMDB Modules > Smart Software Analytics > Administration > Smart Software Analytics Server Deployment > Set up an Smart Software Analytics Server

Set up an Smart Software Analytics Server

This section provides a brief instruction on how to set up an SSA server. Before the installation, review Pre-deployment Considerations and make sure that you meet all the requirements.

Note  

  • It is recommended to create a user with Administrator privileges. SSA must be installed and started by a user with Administrator privileges.
  • SSA supports only Windows platforms.

  • (For upgrade only) It is recommended to uninstall SSA 2.0 before you install SSA 3.0. If you want to keep your customized configurations made in SSA 2.0, for example, the scheduler.cron parameter, keystore, and truststore, back up those configurations and copy them back to the corresponding folders in SSA 3.0 after the installation.

Setup

To set up the SSA server on a Windows machine, follow these steps:

  1. Extract the ZIP packages for Windows platform.

  2. Check if there is a newer version of master SAI files that have been released. If yes, download the latest master SAI files it and replace the older ones under the <SSA installation directory>\ssa-server\ssa\data\masterSAI folder.

  3. Execute the <SSA installation directory>\install_ssa_service.bat script to register SSA as the Windows service: CMS SSA Server.

  4. Execute the <SSA installation directory>\start_ssa_service.bat script to start the service.

Now you can launch and configure SSA from UCMDB Home. For details, see Enable and Configure Smart Software Analytics.

Post Setup

To make sure that Smart Software Analytics works in the best condition, it is recommended that you perform the following after setting up Smart Software Analytics

Monitor SSA

To monitor SSA, perform the following in a regular basis:

  • Confirm that the SSA service is running properly.
  • Check the log file for errors. In the log file, every change to the user SAI file and the autoteach.zsai file should be logged.

  • Check the <SSA installation directory>\ssa-server\ssa\data\scanFile folder. By checking the last modified time of each scanfile, you can have a clear understanding of the work done by SSA.

Back up User SAI Files

Always back up user SAI files timely in a regular basis to avoid potential data loss. All user SAI files are saved under the <SSA installation directory>\ssa-server\ssa\data\masterSAI folder.

Tip As the SSA data is saved on the Windows file system, a backup system is used to prevent data loss due to file corruption. Whenever the SAI file is changed, a *.bak file would be saved in the same folder as backup.

Maintain the DK Package

The auto teach results would be more accurate with the latest DK package. Therefore, it is strongly recommended that you keep the DK package content on SSA up to date by downloading the latest package, which is released on ITOM Marketplace in a monthly base. Upload the master SAI files contained in the latest package when you finish downloading.

Troubleshooting

Refer to Troubleshooting Smart Software Analytics for more details.

Send Help Center feedback