Itiverba - Updater Service for OVH DynHost - Icon
Updater Service for OVH DynHost
A secure and reliable Windows Service to keep your OVH DynHost's IP address up-to-date.
1. Download - System Requirements:

You can download this application here: Download application (itiodhus.zip).

Previous versions and the change log are available here: Version history.

System Requirements:
- Microsoft Windows 7, 8, 8.1, 10 or Microsoft Windows Server 2008R2, 2012, 2012R2, 2016.
- Microsoft .Net Framework 4.5 (or greater in 4.x).

OVH Prerequisites:
- Have a domain name registered at OVH.
- Use the OVH DNS servers for your domain.
- Have an OVH DynHost ready to use (the fully qualified domain name (FQDN) of the DynHost, a DynHost Identifier (login) and its Password).
(The management of your OVH DynHosts is done through your "OVH Control Panel" ("OVH Manager"), in the management page of the concerned domain. )

User interface language:
The languages available for the user interface are currently English and French. The language used is automatically selected according to the language of your Operating System. The default language is English.

Installation steps:
See below (sections 3, 4 and 5.1).



2. Program organization:

This software is an "all-in-one" package that includes several subprograms: a Windows Service, a Service Installer and a Service Management Console. The executed subprogram depends on the Command-Line parameters used.

Executing this program with no Command-Line parameter is reserved to the Windows Services infrastructure.
If you try to run the program "itiodhus.exe" without a command-line parameter, it will display an error message.
This program is primarily a Windows Service, so it must be installed as such before it can be started.

Command-Line parameters are discussed later in this document (here).

Itiverba Updater Service for OVH DynHost - Program organization



3. Service Management Console installation:

Open the file "itiodhus.zip" and extract the file "itiodhus.exe" to a folder of your choice.

Create a shortcut to the file "itiodhus.exe" on the Windows Desktop.
Then, edit the shortcut and add " /c" (without quotes) after "itiodhus.exe" (after the end quote, if any) on the "Target" line of the shortcut to tell the system to open the application in "Management Console" mode (see illustration below).
Finally, in the "Compatibility" tab, check the box labeled "Run this program as an administrator" to ensure that you have sufficient rights to manage the service.

Itiverba Updater Service for OVH DynHost - Shortcut to the Management Console Itiverba Updater Service for OVH DynHost - Shortcut: Run this program as an administrator

Click on the shortcut to open the "Service Management Console".


4. OVH DynHost configuration

To configure the DynHost update settings, open the Service Management Console using the shortcut created in the previous section and click on the "Job Config." tab.

Itiverba Updater Service for OVH DynHost - OVH DynHost configuration


DynHost (FQDN) : The Fully qualified domain name of the OVH DynHost (e.g.: host1.subdom.domain.com).

Identifier (Login) : The DynHost access identifier (e.g.: domain.com-host1login).

Identifier Password : The password of the DynHost access identifier.

Update Protocol : Choose HTTPS (port 443) for secure updates (TLS/SSL encryption). If you choose HTTP (port 80), the data (including the login and password) will not be encrypted.

Check Interval : Interval (in minutes) between IP address checks. The minimum is 3 minutes.

Update Mode :
- Auto : (Recommended mode) The IP address is automatically detected by the OVH server depending on the origin of the verification request (the public IP address used by the Server/PC running this service/application). If the detected IP address is different from the address assigned to the DynHost, the DynHost's IP address is updated. The OVH server is contacted at each check interval.


- External : The IP address is determined by one or more "IP Source(s)" located by an URL. An "IP Source" can be a web page (http/https), a file on an FTP server, a local file or a file in a network share. This application will search for an IP address in the files/web pages and retain the first valid IP address found in each file or web page.

The most common IP address found in the URL list will be assigned to your OVH DynHost.
An update of the Dynhost IP address is made each time the detected IP address has changed. In addition, a forced update is performed during service startup and then once every 24 hours even if no change in the IP address has been detected. The OVH server is contacted only when an update of the IP address is performed.

This mode allows you to have full control over the IP address that will be assigned to your DynHost. For example, you can create a local text file (*. txt) that allows you to change the address of your DynHost manually by simply editing this file.
The IP Source can also be a page of your externally hosted website, a web page of your local router, a file created by a script or software and stored on a network share...

A list of URLs to websites that provide a text file with "Your IP" is preencoded in the drop-down list of the "Add IP Sources URL" dialog box. If your website is located at a location other than your DynHost, you can ask your webmaster to add a text page with the visitor's IP address (this takes a few minutes); You can then use the URL of this page as an "IP Source" in this software (best privacy).

Itiverba Updater Service for OVH DynHost - Adding an IP Source URL Itiverba Updater Service for OVH DynHost - IP Source URL list


Log Level : This software logs its operations in a file named "itiodhusJob.log" located in the same folder as this service/application. Errors are always logged regardless of the selected level. The content of this log file is displayed in the first tab.
The log file size is limited to 1MB. Once this size is reached the file is automatically renamed to "itiodhusJob.log.old" (if a file named "itiodhusJob.log.old" already exists, it is automatically deleted).

Test Update : This button allows you to test the update of your DynHost with the parameters displayed in this tab before saving them in the configuration file.

Last IP : Last IP address assigned to your DynHost by this software. This IP adresse is stored in the file "ip.txt" located in the same folder as this service/application. This file is created by this application and automatically updated each time the DynHost IP address is updated.



Configuration file :
The configuration is saved in an XML file named "itiodhus.cfg" located in the same folder as this service/application. You can change the configuration while the service is running (no need to restart the service): the configuration file is reloaded before each job execution.
Note: If you change the "Check interval", it takes two intervals for this change to be taken into account.


5. Service installation

A service runs as soon as the operating system has started without the need to open a user session. Using this software as a service is the best way to keep your DynHost always up to date.

Only one instance of this service can run on a Server/PC. If you want other hosts to point to the same IP address as your DynHost, create them on their "Authoritative DNS Server" using a CNAME pointing to your DynHost.

There are three different ways to install this software as a service:

5.1. Service installation using the Management Console (GUI):

Open the Service Management Console using the shortcut created in the section 3, and click on the "Service Config." tab.

IMPORTANT: To use the features of this tab, you must have Elevated Privileges. Run this application as an administrator if necessary.

IItiverba Updater Service for OVH DynHost - Service installation using the Management Console


Click the "Install Service" button to install the service.
After installation, the software will ask you if you want to start the service. You can start the service later using the "Start Service" button.

To uninstall the service, click the "Uninstall Service" button.
The uninstall procedure will automatically stop the service before uninstalling it.

Logging of these actions is displayed at the bottom of this tab. This information is also stored in a file named "itiodhus.InstallLog" located in the same folder as this service/application.

Note: The executable file used by the service will be the same as the one used to install this service.


5.2 Service installation using the Command-Line:

It is possible to install the Service using the integrated Command-Line installer.

This application is not a "Console Application", so there is no output when used in the Command Prompt console (see examples below). However, you can see the command line result in the file named "itiodhus.InstallLog" located in the same folder as this service/application.

IMPORTANT: You must run the Command Prompt with "Elevated Privileges" to install/uninstall the service. Run the Command Prompt as an administrator if necessary.

Example 1: Install and Start the service :
(Assuming that "itiodhus.exe" is located in in "C:\Program Files\Itiodhus")
C:\Program Files\Itiodhus>itiodhus.exe /i /start
C:\Program Files\Itiodhus>


Example 2: Install the service under "Local Service" account, activate the "Delayed Start" mode and start the service :
(Assuming that "itiodhus.exe" is located in in "C:\Program Files\Itiodhus")
C:\Program Files\Itiodhus>itiodhus.exe /i /account=LocalService /delayedautostart /start
C:\Program Files\Itiodhus>


Example 3: Install the service under a custom user account "Domain\TestUser" and start the service :
(Assuming that "itiodhus.exe" is located in in "C:\Program Files\Itiodhus")
Important: When using a custom user account, you must first give this user full control over the folder containing this application (and all files belonging to this application, including the file "itiodhus.exe").

C:\Program Files\Itiodhus>itiodhus.exe /i /account=user /username=Domain\TestUser /password=TestPass /start
C:\Program Files\Itiodhus>

If you want to run the service under a local user account, use:
/username=.\TestUser or /username=COMPUTER_NAME\TestUser


Example 4: Uninstall the service :
(Assuming that "itiodhus.exe" is located in in "C:\Program Files\Itiodhus")
C:\Program Files\Itiodhus>itiodhus.exe /u
C:\Program Files\Itiodhus>


5.3. Service installation using InstallUtil.exe (Command-Line):

The service can also be installed using the "InstallUtil.exe" installer from Microsoft. This is a "Console Application", so there is an output when used in the "Command Prompt" console (see examples below).

IMPORTANT: You must run the Command Prompt with "Elevated Privileges" to install/uninstall the service. Run the Command Prompt as an administrator if necessary.

You can find the right version of "InstallUtil.exe" for this service on your computer (assuming Windows is installed in C:\Windows):
32-bit: C:\Windows\Microsoft.NET\Framework\v4.0.30319
64-bit: C:\Windows\Microsoft.NET\Framework64\v4.0.30319

More info on the Microsoft installer tool InstallUtil.exe: Click here

Example 1: Install and Start the service:
(Assuming "InstallUtil.exe" has been copied to the folder "C:\Program Files\Itiodhus"):
C:\Program Files\Itiodhus>installutil itiodhus.exe /i /start


Example 2: Display help about the InstallUtil installer and this service:
(Assuming "InstallUtil.exe" has been copied to the folder "C:\Program Files\Itiodhus"):
C:\Program Files\Itiodhus>installutil itiodhus.exe /?


Example 3: Uninstall the service:
(Assuming "InstallUtil.exe" has been copied to the folder "C:\Program Files\Itiodhus"):
C:\Program Files\Itiodhus>installutil itiodhus.exe /u

Itiverba Updater Service for OVH DynHost - InstallUtil


Note: The output of the Command Prompt console is saved in a file named "itiodhus.InstallLog" located in the same folder as this service/application.



6. "Run as App." Tab:

From this tab you can run the service job as an application.

This feature is provided for testing and debugging purposes.

It is strongly discouraged to execute the service as an application while the service is running, unless the application is executed from an executable file located in a different folder than the service.
When the service and application share the same executable (located in the same folder), they also share the same configuration and log files.

When running the service as an application, all operations are logged in real time in the lower part of this tab, regardless of the "Log Level" selected in the configuration.

The execution of the "service job as an application" stops when the application is closed (the update of the DynHost by this means is therefore stopped). However, if the service is started when the application is closed, it will continue to operate and therefore the update of the DynHost by this means will also continue.



7. "Log file" Tab:

This tab displays the contents of the file "itiodhusJob.log" (the service log file).
The displayed content is automatically refreshed every 5 seconds.



8. Service Control:

You can start and stop the service from the integrated Service Management Console ("Service Config." tab).

IMPORTANT: To use the features of this tab, you must have Elevated Privileges. Run this application as an administrator if necessary.

Naturally, you can also use the "net start/stop itiodhus" commands in a Command Prompt (Admin), or use the Windows Services Management Console.



9. Command-Line Parameters

/install or /i : Installs the service.
Requires elevated privileges.

/uninstall or /u : Uninstalls the service.
Requires elevated privileges.

/console or /c : Displays the Service Managment Console (GUI).

/start : Starts the service after installation.

/delayedautostart : Activates the 'Delayed Start' mode. (When the computer starts up, this service will wait a few minutes before starting.)

/account=SERVICE_ACCOUNT_TYPE : Account type under which to run this service.
( Accepted values for "SERVICE_ACCOUNT_TYPE" : LocalService / LocalSystem / NetworkService / User ).

/username=USER_NAME : User account under which the service will run.
Requires the use of "/account=user".

/password=USER_PASSWORD : Password associated with the user account.
Requires the use of "/account=user /username=USER_NAME".



10. Service Operation:

The service job is performed half a second after starting and then at each check interval.

The IP address assigned to the DynHost is written to a local file named "ip.txt" each time the DynHost address is changed.

You can change the configuration without having to restart the service; the configuration file is reloaded at each interval before the service job is executed.

The architecture of this service has been designed to limit its consumption of Server/PC resources while preventing the service itself from crashing, even in case of unexpected problems.


Index