You can install CSO by using a GUI-based installer as well as through the CLI installer.
Note
When you install or upgrade CSO by using the CLI, ensure that you save the passwords for each infrastructure component when they are displayed on the console because these passwords are encrypted and are not displayed again.
In addition, during the installation, ensure that you save the Administration Portal password that is displayed on the console. For the upgrade, you must log in using the password configured for the previously installed version of CSO.
If you are using the GUI installer, after the installation is successful, click the View all IP addresses and passwords link to view all the IP addresses used by CSO and the passwords for various CSO components.
Ensure that you save the passwords for each CSO component (the cspadmin password, used for the Administration Portal login, is the most important) because these passwords are not displayed again.
Table 3 displays the supported versions and download links for CSO Release 4.1.0 and associated software components. We recommend that you use the CSO Downloader to download and install CSO.
Table 3: CSO and Associated Software Components
Product | Supported Version | Download Link |
|---|---|---|
CSO Downloader (available for Windows, MacOS, and Linux Desktop versions) | 4.1.0 | |
Contrail Service Orchestration | 4.1.0 | |
Juniper Identity Management Service (JIMS) | 1.1.1R1 | Pre-bundled with CSO and also available here: https://webdownload.juniper.net/swdl/dl/secure/ site/1/record/75619.html |
Contrail Analytics | 4.1.2.0-171 | Pre-bundled with CSO |
Contrail Cloud Platform | 3.2.5 | https://webdownload.juniper.net/swdl/dl/secure/ site/1/record/69888.html |
NFX150 CPE device | Junos OS Release 18.2X85D11 | |
NFX250 CPE device | Junos OS Release 15.1X53-D496 | |
SRX Series devices | Junos OS Release 15.1X49-D170 |
|
vSRX | Junos OS Release 15.1X49-D170 |
|
MX Series (hub device) | Junos OS Release 16.1R5 |
A full-version installer is available for CSO Release 4.1.0, which can be used for small, medium, and large deployments. For more information, follow the instructions in the Installation and Upgrade Guide or the README file that is included with the software installation package.
Note The physical servers on which you install CSO must have
Internet access to download the libvirt packages. After the packages are downloaded, you do not need Internet
access for the rest of the CSO installation.
When you set up a distributed deployment with an NFX150 or an NFX250 device, you must use Administration Portal or the CSO API to:
For more information, see https://www.juniper.net/documentation/en_US/release-independent/junos/information-products/ pathway-pages/nfx-series/product/.
Note You can upgrade to CSO Release 4.1.0 only from CSO Release 4.0.2.
If your installed version of CSO is not Release 4.0.2, then you must perform a fresh installation of CSO Release 4.1.0.
If your installed version is CSO Release 4.0.2, you can use a script (upgrade.sh) to directly upgrade to CSO Release 4.1.0. If the upgrade is unsuccessful, you can roll back to CSO Release 4.0.2.
For more information, see Upgrading Contrail Service Orchestration Overview in the Installation and Upgrade Guide.
For SD-WAN deployments, CPE devices behind NAT are supported only for Internet links.
The VM on which the virtual route reflector (VRR) is installed supports only one management interface.
Before you onboard devices, ensure that the device is running the software version that is recommended in this release notes.
To use full capabilities of CSO Release 4.1.0, we recommend that you upgrade the sites by using the site upgrade workflow, to Release 4.1.0.
After you upgrade a site, delete and recreate the SD-WAN policies other the ones that use local breakout. For local breakout policies, create a local breakout profile.
After you upgrade CSO to Release 4.1.0, existing SD-WAN policies are shown as undeployed in the CSO UI even though the policies are still active and deployed.