Difference between revisions of "OS4X-ID"

Revision as of 16:30, 10 December 2013

The so-called "OS4X-ID" is an installation and hardware dependant hash of your system running OS4X. OS4X needs a valid license which is based on this ID. In order to receive a license, the OS4X-ID is the basis for this encrypted file.

At least, the following parameters are the basis for the OS4X-ID:

local hostname
resolved IP address of the local hostname
MAC address of device which is uses the resolved IP address of the local hostname, or (if not resolvable) the device of the kernel presented as first device, based on TCP/IP, which offers a MAC address
CPU-ID where applicable

retrieving OS4X-ID via web interface

In the administrative web interface, click in the left menu on "Tools". The OS4X-ID will be displayed in the main screen right under the "backup" options:

If the license file is writable by the web server user, an upload of a valid license is possible via the "choose file" and "upload license" buttons. A pre-check of validity is done before exchanging the license file.

retrieving OS4X-ID via command line

The program "os4xlic" is used for commandline interaction.

My OS4X-ID changed, why?

Please check the following circumstances:

The hostname of the system (obtainable via the commandline program "hostname") is static.
Verify that the IP address of the hostname (obtained in step #1) is static. The resolving could be done locally (u.e. via "/etc/hosts" or via other online services, as DNS or NIS; see chapter below).
Verify that the host running OS4X has a device with exactly that IP address of step #2.
Verify that the device obtained in step #3 has a static MAC address.

constantly changing OS4X-ID

If your OS4X-ID is changing sometimes and you're really sure you didn't change the machine configuration, you should check that the name resolving works constantly. This can be done by editing the file

/etc/nsswitch.conf

on most Unix systems and the file

/etc/netsvc.conf

on AIX systems.

In order to obtain the same information every time, you should configure the first host name resolving method as "local" and add a static IP address and hostname for your machine to "/etc/hosts". This should fix your problem.

An example for a working entry in the file

/etc/nsswitch.conf

is:

hosts:          files dns

A working AIX configuration file

 /etc/netsvc.conf

is:

hosts = local, bind

In both cases, the local file "/etc/hosts" is asked first, then the configured DNS server. This also speeds up the name resolving mechanism.

AIX licensing

The OS4X ID is obtained in AIX using the following list of devices (first available will be used for MAC address calculation):

ent0
ent1
ent2
first available other device

If you need a special handling, please contact us.

@@ Line 22: / Line 22: @@
 Please check the following circumstances:
 #The hostname of the system (obtainable via the commandline program "<code>hostname</code>") is static.
-#Verify that the IP address of the hostname (obtained in step #1) is static. The resolving could be done locally (u.e. via "<code>/etc/hosts</code>" or via other online services, as DNS or NIS).
+#Verify that the IP address of the hostname (obtained in step #1) is static. The resolving could be done locally (u.e. via "<code>/etc/hosts</code>" or via other online services, as DNS or NIS; see chapter below).
 #Verify that the host running OS4X has a device with exactly that IP address of step #2.
 #Verify that the device obtained in step #3 has a static MAC address.