Changing the Hostname

By default, WSO2 products identify the hostname of the current machine through the Java API. However, this value sometimes yields erroneous results on some environments. Therefore, users are recommended to configure the hostname. The following procedure explains how to change the hostname and management hostname of WSO2 API Manager (WSO2 API-M) as required for your production environment. 

1. Open the <API-M_HOME>/repository/conf/carbon.xml file and set the HostName and MgtHostName property as shown below.
2. Generate a key store by following the sub steps given below.

   1. Open a terminal and issue the following command to generate a key store.
   2. Specify a preferred KeyStore password once prompted.
   3. Specify a preferred Key password once prompted.

   4. Enter the first name and last name as follows once prompted.

      *.am.dev.wso2.com

   5. Enter values for the other parameters as required. 
   Once this information is submitted, a key store is generated with a private key and a public certificate with am.dev.wso2.com as the CN.
3. Copy the generated self-signed key store (i.e., apimkey.jks) to the <API-M_HOME>/repository/resources/security directory.
4. Export the public certificate from the keystore and import that certificate to the  client­-truststore.jks  file following the steps given below.
1. Navigate to the <API-M_HOME>/repository/resources/security directory.

2. Issue the following command to export the public certificate from the primary key store

   keytool -export -alias am.dev.wso2.com -file am.dev.wso2.com -keystore apimkey.jks -storepass <keystore_password_given_above> 

3. Issue the following command to import the certificate to the client­-truststore.jks file.

   keytool -import -alias am.dev.wso2.com -file am.dev.wso2.com -keystore client-truststore.jks -storepass wso2carbon

Whats Next?