

Changing the Hostname¶

By default, WSO2 products identify the hostname of the current machine through the Java API. However, it is recommended to configure the hostname by setting the hostname parameter in the deployment.toml file of each runtime (API-M or Micro Integrator).

Changing the API-M hostname¶

Follow the steps given below.

Update the deployment.toml file.
1. Open the <API-M_HOME>/repository/conf/deployment.toml file
2. Define the hostname attribute under server configurations as shown below.
  Format
```
[server]
hostname = "{hostname}"
```
  Example
```
[server]
hostname = "am.dev.wso2.com"
```
  Replace {hostname} with the Hostname or IP address of the machine hosting this server. This becomes part of the endpoint reference of the services deployed on this server instance.
3. Configure the Developer Portal URL, which is used to access the Developer Portal via the Publisher.
  
  Uncomment the following configuration and define the hostname.
```
[apim.devportal]
url = "https://<hostname>:${mgt.transport.https.port}/devportal"
```
Generate a key store, export the public certificate from the keystore, and import that certificate to the client-truststore.jks file.

For more information, see Creating New Keystores.
Restart the server.
Map the hostname alias to its IP address in the /etc/hosts file of your system as shown below.

Info

You need this when the host is internal or not resolved by a DNS,
```
127.0.0.1       localhost
<ip_address>    <hostname>
```

Warning

After you change the hostname, if you encounter login failures when trying to access the API Publisher and API Developer Portal with the error Registered callback does not match with the provided url, see 'Registered callback does not match with the provided url' error in the Troubleshooting guide.

Note

When changing the hostname in deployment.toml prior to the initial startup of the server, the URLs and endpoints will be read from the file system and subsequently persisted in the database. This is applicable to most configurations in the Resident Identity Provider (IDP). Therefore, any changes made before the initial server startup can be performed via the deployment.toml file.

However, if changes are required after the initial server startup, the Resident IDP configuration must be updated via the Management Console(https://<host>:<port>/carbon) UI.

Changing the Micro Integrator hostname¶

Follow the steps given below.

Open the <MI-HOME>/conf/deployment.toml file
Define the hostname attribute under server configuration as shown below.
Format
```
[server]
hostname = "{hostname}"
```
Example
```
[server]
hostname="localhost"
```

To configure hostnames for WSDLs and endpoints, it is recommended to add the following parameter for the transport listener in the deployment.toml file.

[transport.http]
listener.wsdl_epr_prefix="http://$ref{server.hostname}"

Top