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

Set up a Smart Software Analytics Server

Before the installation, review the "Pre-deployment Considerations" section above 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 3.0 or 2018.05 before you install SSA 2018.08. If you want to keep your customized configurations made in SSA 3.0 or 2018.05, for example, the scheduler.cron parameter, keystore, and truststore, back up those configurations and copy them back to the corresponding folders in SSA 2018.08 after the installation.

Installing SSA server

To install the SSA server, 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 and replace the older ones under the <SSA_Install_Dir>\ssa-server\ssa\data\masterSAI folder.
  3. Execute the <SSA_Install_Dir>\install_ssa_service.bat script to register SSA as the Windows service: CMS SSA Server.

  4. Input the store pass for SSA (at least six characters) in the command prompt window:

    Please input new store pass for SSA Keystore and Truststore: ******
    Please repeat new store pass for SSA Keystore and Truststore: ******
    Please input new safe word for your store pass:

    Note If SSA is already installed and you want to change the store pass, run StorePassManager.bat under the ssa-server\bin directory, and then input the original store pass, new store pass, and new safe word.

  5. Execute the <SSA_Install_Dir>\start_ssa_service.bat script to start the service.

Now you can launch and configure SSA from CMS UI.

 

Post-Installation Setup

To ensure that Smart Software Analytics works in the best condition, it is recommended that you perform the following after installing 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_Install_Dir>\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_Install_Dir>\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.

Send Help Center feedback