Create new virtual hosts using templates

Use scripting to create a new virtual host from a new or preexisting template.

Before starting this task, wsadmin.sh must be running. See the topic about starting the wsadmin scripting client for more information.

Some configuration object types have templates that we can use when creating a virtual host. We can create a new virtual host using a preexisting template or by creating a new custom template. To create a new virtual host using a template:

1. To create a new custom template, perform the following steps:

   1. Copy and paste the following file into a new file, myvirtualhostname.xml:

      (dist)(zos)

      app_server_root\config\templates\default\virtualhosts.xml

      (iseries)

      app_server_root/config/templates/default/virtualhosts.xml

   2. Edit and customize the new myvirtualhostname.xml file.

   3. Place the new file in the following directory:

      (dist)(zos)

      app_server_root\config\templates\custom\

      (iseries)

      app_server_root/config/templates/custom/

   The new custom template to appear with the list of templates, restart the deployment manager.

   The console does not support the use of custom templates. The new template that we create will not be visible in the console panels.

2. Use the AdminConfig object listTemplates command to list available templates, for example:

   • Jacl:

     $AdminConfig listTemplates VirtualHost

   • Jython:

     print AdminConfig.listTemplates('VirtualHost')

   Example output:

   default_host(templates/default:virtualhosts.xml#VirtualHost_1)
   my_host(templates/custom:virtualhostname.xml#VirtualHost_1)

3. Create a new virtual host. For example:

   • Jacl:

     set cell [$AdminConfig getid /Cell:NetworkDeploymentCell/]
     set vtempl [$AdminConfig listTemplates VirtualHost my_host]
     $AdminConfig createUsingTemplate VirtualHost $cell {{name newVirHost}} $vtempl

   • Jython:

     cell = AdminConfig.getid('/Cell:NetworkDeploymentCell/')
     vtempl = AdminConfig.listTemplates('VirtualHost', 'my_host')
     AdminConfig.createUsingTemplate('VirtualHost', cell, [['name', 'newVirHost']], vtempl)

4. Save the configuration changes. See the topic about saving configuration changes with wsadmin.sh for more information.

5. In a network deployment environment only, synchronize the node. See the topic about synchronizing nodes using wsdmin.sh for more information.

Related tasks

Use the wsadmin scripting AdminConfig object for scripted administration

Start the wsadmin scripting client

Saving configuration changes with wsadmin.sh

Related information:

Commands for the AdminConfig object