The following article contains instructions for installing the AIS Dependency Bundle, a package required for all AI-powered Solutions to interact with the Xperiflow engine. This is the first package you should install when setting up or upgrading AI Services in your OneStream environment.
Platform Version
Your OneStream install is on a specific Platform Version, for example v9.0.0. The Platform Version for any Solution you wish to install must align with the Platform Version you have installed to ensure compatibility. A Solution built for v9.1.0 is not guaranteed to function on a v9.0.0 OneStream install.
Minor version discrepancies such as v9.0.0 vs v9.0.1 are likely to be compliant. Check with a OneStream consultant if you are unsure about version compatibility.
All solution uploads must be performed by a user with visibility of the Application tab within OneStream. To verify visibility, log in to your supplied OneStream client and check the left navigation window. The Application tab mustbe visible to load solutions into your environment.
Xperiflow Version
Along with the Platform version, this dependency bundle is released alongside a specific Xperiflow Engine version as well. A misalignment between the bundle’s target Xperiflow version and your environment’s Xperiflow version may create compile and/or runtime issues.
Download
To begin, navigate to Solution Exchange from your browser and log in with your provided OneStream credentials. Once at the Solution Exchange Home Page, navigate to and select the Solutions tab.
The solution you will be installing is AI Dependency Bundle. Search for the solution directly or use the filters to narrow down search results until your solution is visible. Select the solution to open its download page.
Ensure that the selected Platform Version matches the Platform Version you will be working with. Select the latest Solution Version, then click Download.
In some cases, you may be advised to download a specific, non-latest Solution Version for a given solution. The best version for you will be dependent on your Xperiflow Engine Version.
Install
With your solution downloaded, open your OneStream Client, connect to your Server, log in, and select the desired Application for installing the new solution.
Make sure that your Platform Version matches your new solution’s Platform Version. Solutions may not launch or function properly on incorrect Platform Versions.
To upload your Solution, select the Application tab, then under Tools select Load/Extract.
Select the ellipsis … to open your local File Explorer. Select your downloaded Solution, then Open, and finally the Load button to upload the Solution to the environment.
If a copy of the solution is already present in the environment, you will likely receive an error during upload. If that is the case, delete or uninstall the prior solution to upload the new one.
To verify the install completed successfully, open the Workspaces window under Presentation.
The AI Dependency Bundle contains the DataFlow (DFL) and Xperiflow Business Rules (XBR) Solutions. These Solutions enable communication between OneStream AI Solutions, data storage resources, and the Xperiflow Engine. Neither of these solutions will be launched directly; instead, they serve as the Xperiflow connectivity layer that powers all other AI Solutions.
All AI Solutions will also need Xperiflow Administration Tools (XAT) to function properly. The install guide for that solution can be found here.