Maximum Access Gateway Users Allowed remains at 0 after changing hostname on a Citrix Access Gateway Enterprise

First off I’m not a big fan of changing the default hostname ‘ns’ of a Citrix NetScaler/AGEE, this creates potential problems on moments when you cannot use them. For instance with a situation where you have to rebuild a Citrix Access Gateway Enterprise as soon as possible to restore user productivity as soon as possible.

Citrix NetScaler and Citrix Access Gateway Enterprise are pre-configured with the hostname ns and there really is no reason to change this. This hostname is not being broadcasted to other machines in any way. So it will not lead to conflicts with other systems on your network.

But offcourse there will always be customers who want the hostnames altered no matter what! Today I had run into a little problem with a customer who has changed the default ns name to an alternate hostname.

Whilst setting the correct hostname and installing the license files the count remains at 0 for the Maximum Access Gateway Users Allowed.

1

After a little investigation it became clear that the /etc/hosts file still has the “127.0.0.1 ns” mapping and not the new hostname which offcourse is present in the license files. Now, on a Citrix NetScaler you cannot edit the /etc/hosts file directly. Any change you make in this file will be lost when rebooted.

The solution is as follows, create an rc.conf file in the /nsconfig directory with an editor of choice (vi) and add the following entry hostname=<hostname>

This will add the correct hostname to the /etc/hosts file and from there on license files will be read correctly and applied.

About Henny Louwers
I work as a Consultant specialized in Application Delivery, Virtualization of Servers, Desktops and Apps.

One Response to Maximum Access Gateway Users Allowed remains at 0 after changing hostname on a Citrix Access Gateway Enterprise

  1. Haarausfall says:

    Everyone loves what you guys are usually up too. This kind of
    clever work and reporting! Keep up the fantastic works guys I’ve you guys to my blogroll.

    Like

%d bloggers like this: