NOTE: The following instructions were performed using the specified software packages in place. Testing of any component at any other release levels have not been performed. This document describes a specific scenario that was tested to reliably implement Aria ChatBot with all requisite components explicitly stated.
The server you will be installing Aria ChatBot should have sufficient system requirements to operate. The server must also have internet access to download and install its components.
Preparation:
- In the Service Management Install Media, mount the ISO file (example: D Drive) and access D:\filestore\Virtual_Analyst. You will find a casmBot.zip file which will be needed to complete the implementation.
- Download the Anaconda3-2019.07-Windows-x86_64.exe binary. The location of the binary is here:
- Download the Microsoft Visual C++ Build Tools 2015 binary, file "visualcppbuildtools_full.exe". The location of the binary is here:
https://www.microsoft.com/en-in/download/details.aspx?id=48159
Alternate direct download link:
http://download.microsoft.com/download/5/F/7/5F7ACAEB-8363-451F-9425-68A90F98B238/visualcppbuildtools_full.exe
Note: To ensure you are installing the correct component set, make sure you have downloaded "visualcppbuildtools_full.exe".
If you download file "BuildTools_Full.exe", the product will present as "Microsoft Build Tools 2015". This is contrary to "visualcppbuildtools_full.exe", which presents as "Microsoft Visual C++ Build Tools".

Install Anaconda:
- Locate the Anaconda3-2019.07-Windows-x86_64.exe that you have downloaded. Right click the file and choose "Run As Administrator" to start the install process.
- During the install, you will be presented with a window to "Select Installation Type". Choose "All Users".

- Under "Advanced Installation Options", do not make changes to the options given. Leave "Add Anaconda to the system PATH environment variable" unchecked and "Register Anaconda as the system Python 3.7" checked.

- The installer will take time to complete. Usually about 3 min or more.
- Once the Anaconda install completes, reboot the server.
- From the Windows Start Menu, access "Anaconda3 (64 bit)" and click on the "Anaconda Prompt" menu entry.
- Confirm that the correct Python release is in place by running the following command:
python --version
It should come back as "Python 3.7.3":
NOTE: All instructions from here on will be taking place in the "Anaconda Prompt" unless otherwise noted.
Install Microsoft Visual C++ Build Tools 2015:
- From the Windows Start Menu, access "Anaconda3 (64 bit)" and click on the "Anaconda Prompt" menu entry.

- CD to the location where visualcppbuildtools_full.exe was downloaded.
- Run the command visualcppbuildtools_full to start the install process.

- Choose "Default" for the type of installation to take place. The default option includes the MS Build Tools and C++ Compiler components.
- Once the Microsoft Build Tools has completed installation (about 10 minutes), reboot the server.
Setup the Aria Install environment.
For purposes of simplicity, we will create a directory structure that will contain both the Aria ChatBot scripts and the associated Rasa virtual environment that Aria will be using. The Rasa virtual environment will also be created in the next steps.
- Create directory C:\Aria (this location is entirely arbitrary but will contain all content associated with the Aria ChatBot)
- Unzip the "casmBot.zip" file to location C:\Aria
- You should have a directory setup that looks like this:

- Open an "Anaconda Prompt" window.
- CD to the location where the virtual environment will be kept, in this case C:\Aria
- Run this command to establish the "botenv" virtual environment that Aria ChatBot and Rasa will operate:
python -m venv --system-site-packages ./botenv
Important: We are creating the "botenv" environment under "C:\Aria" to keep the overall environment organised. The essential components of the environment are all being contained under "C:\Aria".
When the command returns, run "dir" and you will see all Aria related directory structures created.

Install Rasa and SpaCy:
- While in the Anaconda Prompt, cd to "C:\Aria" and activate virtual environment by running the following command:
.\botenv\Scripts\activate
- The prompt will return with "(botenv) (base)" preceding the prompt text instead of just "(base)" to indicate the botenv environment has been activated.
- Install Rasa by running the following command:
pip install rasa==1.7.4

The install process will take some time to complete, a little over 5 minutes depending on server and network capability.
- Once the Rasa Install completes, install SpaCy by running the command:
pip install rasa[spacy]
The SpaCy install will take about 2 min to run, depending on server and network capability.
- Download/install, then link the SpaCy language data model as per your requirements. To do this, run the following commands in sequence:
python -m spacy download en_core_web_md
python -m spacy link en_core_web_md en
For additional details on the language models available, please review https://spacy.io/models/en.
Note: We are installing the "medium" version of the language model per our documentation guidelines, ie "en_core_web_md". There are other sizes for the given model such as "en_core_web_sm" or "en_core_web_lg" (small and large respectively)
Train and start up Rasa and Aria ChatBot:
NOTE: Do not use Anaconda Powershell here as a later command to train Rasa will fail if executed in Anaconda Powershell.
- From the Windows Start Menu, access "Anaconda3 (64 bit)" and click on the "Anaconda Prompt" menu entry.
- In the Anaconda Prompt, make sure you are running the "botenv" environment in Anaconda.
cd to "C:\Aria" then run .\botenv\Scripts\activate
- cd to the directory containing casm-bot, "C:\Aria\casm-bot"
- Run the following command to train the Rasa model.
rasa_train
The Rasa Model training usually takes about a few minutes to complete. Example of a completed run:

- Once the Rasa Model training is complete, run the following command to start Rasa:
rasa_run
- Test that Rasa is working by running "http://SERVER:5005" from a web browser where SERVER is the server name or the FQDN where Rasa and the Aria ChatBot have been installed.

You should also see this somewhere in the Anaconda Prompt display (red highlight):

The above should be what you would see once Rasa is up and running.
Note: Leave the Anaconda Prompt up in order to monitor the Aria ChatBot functionality. If you need to restart Aria ChatBot or make any changes, you must re-train Rasa (rasa_train) before running Rasa (rasa_run).
Configure SDM/Xflow:
- Login to CA Service Desk Manager as an Admin User
- Navigate to Administration -> xFlow Interface -> General
- Search for the Configuration key "va.bot.nlu.server.url".
- Update the value "configuration value" to the Rasa service we have just established (http://<RASASERVER>:5005)
Note: You may need to use an FQDN, i.e: http://<RASASERVER.DOMAIN.COM>:5005

To test that it all works, login to xFlow, go into ServicePoint, and Aria should be configured and running.