How to change the hostname in Data Virtualization OAuth callback URL?

How to change the hostname in Data Virtualization OAuth callback URL?

book

Article ID: KB0137799

calendar_today

Updated On:

Products Versions
TIBCO Data Virtualization All supported versions

Description

Follow the steps - 
1. Stop All DV Server Services
   Ensure all three DV services are completely stopped before making any changes.

2. Backup Configuration File
   Navigate to the following path: [TDV_Server_dir]\conf\server\. Copy the file `server_values.xml` and save it as a backup in a separate location.

3. Update Hostname in `server_values.xml'. 

Note - Ensure the new hostname is mapped correctly in the hosts file of the DV Server machine. 

The default location for the file on Windows - C:\Windows\System32\drivers\etc\hosts. Linux: /etc/hosts

Open the original `server_values.xml` file and update the value for each of the following attributes with the new hostname:

   * /server/config/info/serverId
   * /server/config/info/displayName
   * /server/config/net/hostname
   * /server/config/net/wsdlhostname

   Example: To update the `serverId`, locate this block:

   ```xml
   <common:attribute>
     <common:name>/server/config/info/serverId</common:name>
     <common:type>STRING</common:type>
     <common:value>old.hostname.com</common:value>
   </common:attribute>
   ```

   Change it to:

   ```xml
   <common:attribute>
     <common:name>/server/config/info/serverId</common:name>
     <common:type>STRING</common:type>
     <common:value>newhostname.com</common:value>
   </common:attribute>
   ```

   Repeat this for the other listed attributes.

4. Start DV Services
   Once the updates are saved, start all DV Server services.

5. Verify in DV Studio
   - Launch DV Studio and navigate to the configuration tab: Server > Configuration > Network
   - The Hostname field should now reflect the updated value.

Note - 

* This change will impact the hostname mentioned for any client connection. Take necessary action. 

* If the hostname still displays the previous value after performing the above steps, it may require external network or DNS updates. Please open a Support ticket for further assistance.

 

Environment

All Supported Operating Systems 

Issue/Introduction

When performing OAuth authentication through DV Studio, DV generates a default callback URL in the format:
https://[hostname]:[DV base port + 2]/oauth2studiocallback

The hostname used in this URL is derived from the DV Studio configuration, specifically from:
Studio > Server > Configuration > Network > Hostname

This value appears as grayed out in Studio and cannot be edited directly. This article outlines how to update the hostname value used by DV.