Installation and Update
yunIO provides a Windows service for the communication with the SAP system and comes with an embedded Web UI, the yunIO Designer. The yunIO service is installed on a local or cloud-hosted Windows server environment.
Prerequisites
Administrator rights are required to install yunIO.
Setup
yunIOSetup.exe is an industry standard setup. Execute the yunIOSetup.exe file and follow the instructions of the setup. When starting the setup the following components can be selected:
| Component | Description |
|---|---|
| Main Product Files | All required files to use yunIO. |
| Install Service | Installs the server component as a windows service that runs under a virtual service account with the least required privileges. |
| Start Menu Shortcuts | Component that adds shortcuts to the start menu. |
| Enable .NET updates via Windows Update for Windows Server Edition. | Adds a registry entry that automatically updates .NET. |
| Open the yunIO Designer after installation | Opens the yunIO Designer in your standard web browser. |
For information on how to install a license, see License.
Enable .NET updates via Windows Update for Windows Server Edition
This setup option is only available on Windows Server Editions and only if the option is not already active. It adds a registry entry that automatically updates .NET via Windows Update. To deactivate this option, delete the registry entry.
Installation Directory Files
The list below shows several important files that are placed into the default directory C:\Program Files\Theobald Software\yunIO after installation:
| Filename | Description |
|---|---|
| logs directory | Directory with server and extraction etc. logs. |
| config directory | Directory containing all SAP connections, extractions and other settings. |
| Uninstall yunIO shortcut | Shortcut for uninstalling and removing yunIO with all its components from your machine. |
| yunIOSetup.exe | Setup of the currently installed version. |
| yunIOLicense.json | License file with information about the component and runtime. |
Update
Warning
Data loss.
System updates or changes can restrict software functionalities and this may lead to data loss. Create a backup of the directory: C:\Program Files\Theobald Software\yunIO\config at regular intervals.
It is recommended to update the software regularly, as regular updates are crucial for a stable performance. Check the Changelog for updates.
A newer version can be installed over the older version. All settings and created objects are preserved.
Workflow
- Check if you have a working test environment with a valid license.
- Make sure that the test environment is a copy of the current production environment.
- Check the changelog to see if an update is needed.
- Create a backup of the current installation.
- Conduct any necessary preparations and changes as described in the Release Note / Changelog.
Tip
Subscribe via email to Theobald Software’s technical newsletter that informs about software changes and new features.
Access the yunIO Designer
To access the yunIO Designer, enter the designer-URL in a web browser.
The URL pattern to access the yunIO Designer is http(s)://[host or IP address]:[port].
- If the yunIO service runs on a local server, replace
[host]with localhost. - If the yunIO service does not run on the same machine as the browser, replace
[host]with the name or IP address of the host on which the service runs. - After the installation the yunIO Designer is accessible under the default port 8077.
The port can be configured in the Settings menu of the Designer.
Note
Make sure that the YunIO Service is running on your windows system and that the default port 8077 is not blocked by your firewall.
Version Number
To check your current version number, navigate to the About menu in the yunIO Designer.
The version number is displayed next to the page title.
