vSphere 6.0 – Page 37

vCenter Server 6.0 Tidbits Part 1: What install & deployment parameters did I use?

04.06.2015 by William Lam // 6 Comments

This is the first part in a new blog series that I will be working on in which I will be sharing some simple tips and tricks that I learned along the way while working with vCenter Server 6.0, these especially came in handy during the early development of vSphere 6.0. These tidbits will include information covering both the vCenter Server for Windows (VCS) as well as the vCenter Server Appliance (VCSA).

When installing VCS or deploying the VCSA, you are prompted to fill out a variety of inputs based on the deployment type, SSO Domain, database information, etc. These "install parameters" are then fed into the configuration of either your vCenter Server (Embedded) or separated out with vCenter Server Management Node and Platform Services Controller Node.

After you successfully deployed your vCenter Server and say a couple of weeks has passed and you are now wondering what install parameters you used either for auditing, informational purposes or more likely you may need to know one of these parameters for adding additional instances say for Enhanced Linked Mode, how might you go and retrieve this information?

Luckily, VMware has made finding this information extremely easy by providing a tiny little utility called "install-parameter" and here are the locations for both platforms:

Windows:

"C:\Program Files\VMware\vCenter Server\bin\install-parameter.bat"

VCSA:

/bin/install-parameter

The utility accepts the name of a well defined set of installation parameters, an example would be "vmdir.domain-name" which specifies the name of the SSO Domain that you had configured:

You can see the complete list of available installation parameters under the following paths in the two platforms:

Windows:

C:\ProgramData\VMware\vCenterServer\cfg\install-defaults

VCSA:

/etc/vmware/install-defaults

For your convenience, I have also listed all the installation parameters in the table at the very bottom of this post.

In addition to these installation parameters, there are two additional ones that I would like to mention which are not part of this list.

Database Type

The information is stored in a file called db.type with possible values of: embedded, oracle and mssql and here are the paths for the two platforms:

Windows:

C:\ProgramData\VMware\vCenterServer\cfg\db.type

VCSA:

/etc/vmware/db.type

The possible values for this files is: embedded, oracle and mssql

Deployment Type

The information is stored in a file called deployment.node.type with possible values of: embedded, management and here are the paths for the two platforms:

Windows:

C:\ProgramData\VMware\vCenterServer\cfg\deployment.node.type

VCSA:

/etc/vmware/deployment.node.type

For those with a critical eye, you might have noticed there is one installation parameter that is not available in any of these files and that would be the SSO Domain Site Name. This property is not really important (outside of troubleshooting) unless you need to add additional Platform Services Controller and replicate with an additional one or adding additional vCenter Servers for enabling Enhanced Linked Mode support. This property is one of the required parameters when performing a scripted install but is not needed if performing the deployment using the guided install method. In the next blog post, I will show you how you can retrieve this property.

vCenter Server 6.0 Installation Parameter

autodeploy.ext.managementport
autodeploy.ext.serviceport
cis-license.int.http
cm.int.cmhttp
cm.url
cm.url.path
db.dsn
db.instance
db.presetupdone
db.provider
db.servername
db.serverport
db.user
eam.int.http
invsvc.int.http
mbcs.int.http
netdumper.ext.serviceport
netdumper.int.webport
perfcharts.int.https
rhttpproxy.cert
rhttpproxy.conf.path
rhttpproxy.ext.port1
rhttpproxy.ext.port2
sca.hostid
sca.int.scahttp
sps.int.pbmhttp
sps.int.pbmhttps
sps.int.smshttp
sps.int.smshttps
sps.int.spshttp
sps.int.spshttps
sshd.ext.port1
syslog.ext.port
syslog.ext.tls
syslog.int.http
syslog.int.port
system.hostname
system.hostname.type
system.urlhostname
system.vm0.hostname
vapi.int.endpoint-http
vapi.int.jmx-port
vc.conf.path
vc.home.path
vc.instance.cfg.path
vmafd.ext.port1
vmca.cert.dir
vmca.ext.port1
vmdir.admin-dn
vmdir.domain-dn
vmdir.domain-name
vmdir.ext.port1
vmdir.ext.port2
vmdir.ldap-port
vmdir.ldu-guid
vmdir.site-guid
vmdir.username
vmkdc.ext.port1
vmkdc.ext.port2
vmkdc.ext.port3
vpostgres.int.server_port
vpxd.ext.port1
vpxd.ext.port2
vpxd.int.sdk-port
vpxd.int.sdk-tunnel-port
vsan-observer.ext.port1
vsm.int.http
vsm.int.https
vsphere-client.ext.port1
workflow.int.jmx-port
workflow.int.service-port
workflow.int.vapi-port

Easily automate ESXi 6.0 Active Directory join using domainjoin-cli

04.06.2015 by William Lam // 9 Comments

A nice little enhancement that I recently came across in ESXi 6.0 is the inclusion of the Likewise utility called domainjoin-cli which allows you to join a system to an Active Directory Domain. Previously, if you wanted to automate the process of joining an ESXi host to an Active Directory Domain, you had to either manually configure it using the vSphere Web/Client, using Host Profiles or creating an external script using the vSphere APIs.

All of these options were mostly executed during the post-provisioning process and if you wanted to include Active Directory configuration as part of the provisioning process, you may have had to resort to something like calling into the vSphere MOB within a Kickstart script as I had shown back in 2011 in this article here. The solution I came up with was not ideal but it worked for those that did not want to have additional steps after initial provisioning.

With the domainjoin-cli utility now included in the ESXi Shell of ESXi 6.0, you easily automate the joining an Active Directory Domain with just a couple of lines added to your Kickstart or provisioning scripts. Before you can use the command-line utility, you will need to ensure the Likewise Service Manager Daemon is running by running the following two commands which will start the service and also ensure the service automatically starts up:

/etc/init.d/lwsmd start
chkconfig lwsmd on

Next, to join to your Active Directory Domain, you will need to specify the following 3 parameters:

join - Specifying the operation is a join versus a leave
AD Domain Name - Active Directory Domain to join
AD Username - Active Directory username to join to the domain
AD Password - Active Directory password to join to the domain (optional as you will be prompted if it is not specified)

Here is an example of what the command looks like joining my Active Directory Domain in my lab:

/usr/lib/vmware/likewise/bin/domainjoin-cli join primp-industries.com administrator [PASSWORD]

You should see a success message if the ESXi host was successfully joined to the Active Directory Domain and you will want to reboot your ESXi host for the changes to take full effect. This is definitely a simpler method to include into an ESXi Kickstart script to automate the joining of an Active Directory Domain and hopefully you will find this handy when using ESXi 6.0.

Quick Tip - Upgrading VMware Tools for Nested ESXi 6.0

04.03.2015 by William Lam // 2 Comments

I have received several questions about this in the last couple of weeks regarding the process of upgrading VMware Tools for running Nested ESXi 5.x and 6.0 when the physical ESXi host has been upgraded to ESXi 6.0. Instead of individual replies, I thought I would share this quick tip. First off, VMware Tools for Nested ESXi provides a very specific set of capabilities for Nested ESXi guests as shown below:

Provides guest OS information of the nested ESXi Hypervisor (eg. IP address, configured hostname, etc.).
Allows the nested ESXi VM to be cleanly shut down or restarted when performing power operations with the vSphere Web/C# Client or vSphere APIs.
Executes scripts that help automate ESXi guest OS operations when the guest’s power state changes.
Supports the Guest Operations API (formally known as the VIX API).

Unlike traditional VMware Tools which may provide updated capabilities with each new release, VMware Tools for Nested ESXi exposes only a subset of those capabilities which has not changed between ESXi 5.x and 6.0. This is an important fact to be aware of because you may see "Unsupported older version" for the VMware Tools status in the vSphere Web/C# Client and this is perfectly fine and expected.

Here is a screenshot of a Nested ESXi 5.5 VM with VMware Tools installed running on top of an upgraded physical ESXi 6.0 host:

In this scenario, the VMware Tools status will be reported as "Unsupported older version" because the version of VMware Tools does not match the latest version of VMware Tools included with ESXi 6.0. However, you should not be alarm as the expected functionality listed above will continue to work without any problems and you can just ignore the UI warning. The only way to get rid of this warning is to upgrade the Nested ESXi VM to ESXi 6.0 which I go over in more details below. I know upgrading may not be an option if you still wish to run ESXi 5.x, but as far as I know, there will not be an update to VMware Tools VIB for ESXi 6.0 as it is now pre-installed with ESXi 6.0.

Here is a screenshot of the same VM which has now been upgraded to ESXi 6.0 running on top of an upgraded physical ESXi 6.0 host:

In this case, the VMware Tools status will be reported as "Unsupported older version" because the version of VMware Tools does not match the latest version of VMware Tools included with ESXi 6.0. However, because VMware Tools now comes pre-installed with ESXi 6.0. We can easily remedy this by removing the VMware Tools VIB we installed for ESXi 5.x by running the following ESXCLI command and then rebooting:

esxcli software vib remove -n esx-tools-for-esxi

Once the ESXi host has rebooted, the VMware Tools that is pre-installed with ESXi 6.0 will automatically start up if it detects it is running as a VM. If you now look at your vSphere Web/C# Client, you will see that VMware Tools status shows current and is also the default behavior if you are running Nested ESXi 6.0 VM on top of physical ESXi 6.0 host.

With VMware Tools being pre-installed with ESXi 6.0 and only loaded when it detects it is being run as a VM, you no longer need to worry about manually installing additional VIBs get the benefits of having VMware Tools installed for your Nested ESXi VMs.