OneSetup Wizard

In the Welcome page you can select:

  • Install New Instance – Installs a new instance of OneSetup components (selected by default).
  • Upgrade or Repair – Upgrades or repairs a OneSetup instance (enabled only if there is an existing installation). It also allows to install new components in an existing instance.
  • Uninstall Instance – Uninstalls a OneSetup instance (enabled only if there is an existing installation).
  • Download packages – Downloads packages to the local disk in order to perform an offline installation (enabled if the package repository status is ok).

 OneSetup_select.png


The wizard has four buttons:

  • Previous - Goes back to the previous step.
  • Next - Advances to the next step.
  • Cancel - Exits the application after user confirmation.
  • Finish - Closes the application.

 

At the bottom of the page, the NuGet package Repository status is presented:

  • Ok – Repository is reachable and the user is authorized.
  • InvalidUrl – The Url is not valid.
  • UnAuthorized – The user is not authorized to access the repository.
  • NotReachable – The repository is not reachable.
  • Other – Other errors.

 

Click on the OneSetup_select_refresh.png button to force a status refresh.

Click on the "settings" button OneSetup_select_settings.png to change the repository configurations.

If the repository status is not Ok and you click on the Next button, with the install or upgrade options, a message box is presented indicating that the repository is not online and that only pre-downloaded packages will be available (offline install).

The download option is disabled if the repository status is not Ok.

 

On the Package Repository pop-up you'll see:

OneSetup_package_repository.png

  • Url – The NuGet repository Url, by default to the public release repository. If left blank the default public realease repository will be used (https://collab-vsts.pkgs.visualstudio.com/_packaging/OneContactReleases/nuget/v3/index.json).
  • Username - User name used for repository autentication. Each client and or partner can have the their own set of credentials or a shared one.
  • Password – Password, a Personal Access Token.
  • Package Directory – Directory used to store the downloaded packages. By default it will be a Package folder inside the Temp directory. If left blank the default folder will be selected (user temp directory \packages).
  • Include prerelease – List pre-release package versions. Pre-release versions have a suffix appended to the regular version number (e.g., 3.1.0-alpha1).