...

• Port 8102 - open only to Kitely (using the firewall). The number "8102" is meant as a reminder that the services that use this port usually use port 8002.

The Helo, Home and Gatekeeper Services

Although we will use Port 8102 for the most sensitive services (Assets, Inventory), there are two three Hypergrid services that will still should use Port 8002: Helo, Home and Gatekeeper. The reason they need to use Port 8002 (or whatever your grid's main port is) is that these two services act as identifiers for the grid. In other words, the address "yourgrid.com:8002" is a unique identifier for your grid, and is considered to be a different grid from "yourgrid.com:8102" or "yourgrid.com:1234". If you ever change the port on which these services run (Home and Gatekeeper) then this will change the very identity of your grid. The consequences in Kitely Market will be that your users won't be able to use it anymore since there will be a mismatch between the grid that they used to be in ("yourgrid.com:8102") and the grid that they claim to belong to now . In order ("yourgrid.com:8002"). This may be fixable, so if you ever get into this situation then please contact Kitely. But it's best to avoid this situation, and that's why we recommend that you use your grid's main port (Port 8002) for the Helo, Home and Gatekeeper services.

What are these services? The Helo service is a very small service that just confirms that the server supports Hypergrid. The Home service allows querying the grid's users, which Kitely Market does in order to convert user names to UUID's. The Gatekeeper service is used for teleporting between grids. However, the Gatekeeper service is not actually open! We need the Gatekeeper port to be correct because this address is sent to Kitely and used to identify the grid, but it isn't actually possible to use this address because the Gatekeeper service will not be enabled.

Modify Robust.ini

Copy the following sections from Robust.HG.ini to Robust.ini (at the end of the file):

• [Hypergrid]

• [GatekeeperService]

• [UserAgentService]

• [HGInventoryService]

• [HGAssetService]

• [HGInstantMessageService]

Add the 1. Add the following lines at the end of the [ServiceList] section (they were copied from the [ServiceList] section in Robust.HG.ini):

;; Hypergrid
UserAgentServerConnector = "8002/OpenSim.Server.Handlers.dll:UserAgentServerConnector"
HeloServiceInConnector = "8002/OpenSim.Server.Handlers.dll:HeloServiceInConnector"
InstantMessageServerConnector = "8102/OpenSim.Server.Handlers.dll:InstantMessageServerConnector"
HGInventoryServiceConnector = "HGInventoryService@8102/OpenSim.Server.Handlers.dll:XInventoryInConnector"
HGAssetServiceConnector = "HGAssetService@8102/OpenSim.Server.Handlers.dll:AssetServiceConnector"

Notice that we don't have a line for the Gatekeeper Service. That's what makes it inaccessible.

2. Add the following lines at the end of the [LoginService] section (they were copied from the [LoginService] section in Robust.HG.ini):

    ;; Hypergrid
    SRV_HomeURI = "http://rohan127.0.grid0.com1:8002"
    SRV_InventoryServerURI = "http://rohan127.0.grid0.com1:8102"
    SRV_AssetServerURI = "http://rohan127.0.grid0.com1:8102"
    SRV_ProfileServerURI = "http://rohan127.0.grid0.com1:8002"
    SRV_FriendsServerURI = "http://rohan127.0.grid0.com1:8102"
    SRV_IMServerURI = "http://rohan127.0.grid0.com1:8102"
    SRV_GroupsServerURI = "http://rohan.grid.com:8102"

...

127.0.0.1:8102"

Replace every instance of "127.0.0.1" with the address of your grid, e.g. "yougrid.com".

Notice that the Home service uses port 8002, and most of the other services use port 8102. (The Gatekeeper service doesn't get mentioned a mention here.)

If you examined this list with a sharp eye then you may have noticed that the Profile service also uses port 8002, and we haven't mentioned this service before. That's because the Profile service exists in non-Hypergrid versions of OpenSim as well, and the default address for this service uses port 8002. If you're using a different address for your Profile Service then please specify it here. The benefit of specifying the correct profile service is that Kitely Market will be able to show your users' actual pictures, which makes for a better user experience and also gives buyers confidence that their products were delivered to the correct avatar. If you're not using a Profile Service then you can leave this setting unchanged; it won't cause any harm.

3. Copy the following sections from Robust.HG.ini to Robust.ini (at the end of the file):

• [Hypergrid]

• [GatekeeperService]

• [UserAgentService]

• [HGInventoryService]

• [HGAssetService]

• [HGInstantMessageService]

Replace every instance of "127.0.0.1" with the address of your grid, e.g. "yougrid.com".

You may have noticed that the [GateekeeperService] section has some rules regarding who may teleport into the grid. We don't bother to set these rules since the Gatekeeper service isn't actually accessible.

Add the following line at the end of the [UserAgentService] section:

    ForeignTripsAllowed_Level_0 = false

Configure the Firewall

Set your firewall to allow incoming TCP access to Port 8102 only from *.kitely.com.

(If you can't create a wildcard rule then you can allow access from grid.kitely.com instead. This will work for now, but it's not future-proof.)