Post

How to setup the workstation for Build Tools for VMware Aria

Posted Updated
By www.clouddepth.com
views 10 min read

The following applies on Mac, but should work on Windows as well with proper Windows command accordingly. More documentation can be found here.

Prerequisites

Install Homebrew

1

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install Maven

For now, only Maven 3.8.x is supported. 3.9.x is working well. But not higher.

1

brew install maven

Install and configure OpenJDK@17

  • Install OpenJDK
1

brew install openjdk@17
  • Add JAVA_HOME to .zshrc
1

echo 'export JAVA_HOME=$(/usr/libexec/java_home)' >> ~/.zshrc
  • Apply changes
1

source .zshrc

Download and install NodeJS

For now, only NodeJS 14.x is supported. 16.x is working well. But not higher.

Create a Keystore for vRO package signing

  • Create a directory for Keystore
1
2

mkdir archetype.keystore-2.0.0
cd archetype.keystore-2.0.0
  • Generate a new keystore. Replace with your values.

Java keystore used for signing packages build time. All API calls from the toolchain (i.e. the client) verify the SSL certificate returned by vRO/vRA (i.e. the server). If you are using self-signed or third-party signed certificates, you may need to add those certificates or their CA certificates to the default JAVA keystore, i.e. JAVA_HOME/lib/security/cacerts. This is the recommended approach.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

keytool -keystore archetype.keystore -genkey -alias dunesrsa_alias -storepass 'XXXXXX' -keyalg RSA
What is your first and last name?
  [Unknown]:  John Doe
What is the name of your organizational unit?
  [Unknown]:  XX
What is the name of your organization?
  [Unknown]:  XX
What is the name of your City or Locality?
  [Unknown]:  XX
What is the name of your State or Province?
  [Unknown]:  XX
What is the two-letter country code for this unit?
  [Unknown]:  XX
Is CN=John Doe, OU=XX, O=XX, L=XX, ST=XX, C=XX correct?
  [no]:  yes

Enter key password for <dunesrsa_alias>
 (RETURN if same as keystore password):

Warning:
The JKS keystore uses a proprietary format. It is recommended to migrate to PKCS12 which is an industry standard format using "keytool -importkeystore -srckeystore archetype.keystore -destkeystore archetype.keystore -deststoretype pkcs12".
  • Generate a key to sign the toolchain. Replace the values with yours.

It’s essential to note that the emailAddress should NOT be empty. Otherwise, the vRO import will break with a ‘400 OK’ error

1
2
3
4
5
6
7

keytool -genkey -keyalg RSA -keysize 2048 -alias dunesrsa_alias -keystore archetype.keystore -storepass 'XXXXX' -validity 3650 -dname "CN=Project,OU=Department,O=Company,L=City,ST=State,C=XX,emailAddress=XXX"

Enter key password for <dunesrsa_alias>
 (RETURN if same as keystore password):

Warning:
The JKS keystore uses a proprietary format. It is recommended to migrate to PKCS12 which is an industry standard format using "keytool -importkeystore -srckeystore archetype.keystore -destkeystore archetype.keystore -deststoretype pkcs12".

Generate a Private Key and Certificate for vRO Package Signing

1

cd /path/archetype.keystore-2.0.0

Generate a private key and export it. Replace with your values.

1

openssl genpkey -out private_key.pem -algorithm RSA

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

openssl req -new -key private_key.pem -out csr.csr
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) []:XX
State or Province Name (full name) []:XX
Locality Name (eg, city) []:XX
Organization Name (eg, company) []:XX
Organizational Unit Name (eg, section) []:XX
Common Name (eg, fully qualified host name) []:XX
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:

1

openssl req -x509 -days 999 -key private_key.pem -in csr.csr -out cert.pem

Make sure that archetype.keystore-2.0.0 directory contains those three files

img-description

Create an archetype.keystore-2.0.0.zip

1
2

cd ..
zip archetype.keystore-2.0.0.zip -r archetype.keystore-2.0.0

Create .m2 and keystore directory

1
2
3

mkdir ~/.m2
cd .m2
mkdir keystore

Copy archetype.keystore-2.0.0.zip to .m2 directory

1

cp /path/archetype.keystore-2.0.0.zip ~/.m2/keystore/

Now, the ~/.m2/keystore/ should contain the following:

img-description

Create settings-security.xml

All the encrypted passwords will be used later in the settings.xml. Maven password encryption details can be found here.

1
2

cd ~/.m2
touch settings-security.xml

Generate Maven master password

1
2
3

mvn --encrypt-master-password
Master password: XXX
{5bTlAWaH...}

Save it into settings-security.xml.

1

vi settings-security.xml

Copy password into the settings-security.xml and save.

1
2
3

<settingsSecurity>
    <master>{5bTlAWaH...}</master>
</settingsSecurity>

Encrypt credentials

Encrypt user's password and keystore's password.

Using this method, Maven will handle the escape of all special characters. There is no longer a need to provide the password as part of the command.

Example:

1
2
3

mvn --encrypt-password
Password:
{5bTlAWaH...}

Create settings.xml

1

vi settings.xml

Copy the XML body below into settings.xml ans save the file.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

<?xml version="1.0" encoding="UTF-8"?>
<settings
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd"
    xmlns="http://maven.apache.org/SETTINGS/1.1.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <servers>
        <server>
            <username>user@domain.local</username>
            <password>{5bTlAWaH...}</password>
            <id>vra01</id>
        </server>
        <server>
            <username>user@domain.local</username>
            <password>{5bTlAWaH...}</password>
            <id>vro01</id>
        </server>
    </servers>
    <profiles>
        <profile>
            <id>packaging</id>
            <properties>
                <keystorePassword>{ftykftyid}</keystorePassword>
                <keystoreLocation>/Users/user1/.m2/keystore/archetype.keystore-2.0.0.zip</keystoreLocation>
                <vroPrivateKeyPem>/Users/user1/.m2/keystore/private_key.pem</vroPrivateKeyPem>
                <vroCertificatePem>/Users/user1/.m2/keystore/cert.pem</vroCertificatePem>
                <vroKeyPass>PASSWORD</vroKeyPass>
            </properties>
        </profile>
        <profile>
            <id>bundle</id>
            <properties>
                <assembly.skipAssembly>false</assembly.skipAssembly>
            </properties>
        </profile>
        <profile>
            <id>artifactory</id>
            <repositories>
                <repository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>central</id>
                    <name>central</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </repository>
                <repository>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                    <id>central-snapshots</id>
                    <name>central-snapshots</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>central</id>
                    <name>central</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </pluginRepository>
                <pluginRepository>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                    <id>central-snapshots</id>
                    <name>central-snapshots</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </pluginRepository>
            </pluginRepositories>
            <properties>
                <releaseRepositoryUrl>https://repo1.maven.org/maven2/</releaseRepositoryUrl>
                <snapshotRepositoryUrl>https://repo1.maven.org/maven2/</snapshotRepositoryUrl>
            </properties>
        </profile>
        <profile>
            <!--Environment
            identifier. Multiple environments are allowed by configuring multiple profiles -->
            <id>vro01</id>
            <properties>
                <vrealize.ssl.ignore.hostname>false</vrealize.ssl.ignore.hostname>
                <vrealize.ssl.ignore.certificate>false</vrealize.ssl.ignore.certificate>
                <!--vRO Connection-->
                <vro.host>{vro_host}</vro.host>
                <vro.port>{vro_port}</vro.port>
                <vro.serverId>vro01</vro.serverId>
                <vro.auth>{basic}</vro.auth> <!-- If "basic" is selected here, ensure com.vmware.o11n.sso.basic-authentication.enabled=true System Property is set in vRO -->
                <vro.authHost>{auth_host}</vro.authHost> <!-- Required for external vRO instances when vra auth is used -->
                <vro.authPort>{auth_port}</vro.authPort> <!-- Required for external vRO instances when vra auth is used -->
                <vro.refresh.token>{refresh_token}</vro.refresh.token> <!-- login with token when vra auth is used -->
                <vro.proxy>http://proxy.host:80</vro.proxy>
                <vro.tenant>{vro_tenant}</vro.tenant>
            </properties>
        </profile>
        <profile>
            <!--Environment
            identifier. Multiple environments are allowed by configuring multiple profiles -->
            <id>vra01</id>
            <properties>
                <vrealize.ssl.ignore.hostname>false</vrealize.ssl.ignore.hostname>
                <vrealize.ssl.ignore.certificate>false</vrealize.ssl.ignore.certificate>
                <!--vRA Connection-->
                <vra.host>{vra_host}</vra.host>
                <vra.port>{vra_port}</vra.port>
                <vra.tenant>{vra_tenant}</vra.tenant>
                <vra.serverId>vra01</vra.serverId>
            </properties>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>artifactory</activeProfile>
        <activeProfile>packaging</activeProfile>
    </activeProfiles>
</settings>

If I encrypt the vroKeyPass with mvn --encrypt-password the project building will fail in the later stage. I didn’t find a way to make it work. The vroKeyPass should remain a clear-text password.

  • vrealize.ssl.ignore can be changed from false to true if needed. Of course, it is not recommended in the production environment
  • vroKeyPass is a password used when we created a Private Key
  • keystorePassword is a password used when we created a Keystore
  • keystoreLocation change to your location
  • vroPrivateKeyPem change to your location
  • vroCertificatePem change to your location
  • <servers><server><username> change to your username
  • <servers><server><password> change to your password
  • <servers><server><id> change to your id

The minimum required settings for vRO

1
2
3
4

<vro.host>VRO_FQDN</vro.host>
<vro.port>443</vro.port>
<vro.serverId>vro01</vro.serverId>
<vro.auth>basic</vro.auth>

The minimum required settings for vRA

1
2
3
4

<vro.host>VRA_FQDN</vro.host>
<vro.port>443</vro.port>
<vro.serverId>vra01</vro.serverId>
<vro.auth>basic</vro.auth>

Here’s how the final setup will look if one (or both) of these minimum settings are applied:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

<?xml version="1.0" encoding="UTF-8"?>
<settings
    xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.1.0 http://maven.apache.org/xsd/settings-1.1.0.xsd"
    xmlns="http://maven.apache.org/SETTINGS/1.1.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <servers>
        <server>
            <username>user@domain.local</username>
            <password>{5bTlAWaH...}</password>
            <id>vra01</id>
        </server>
        <server>
            <username>user@domain.local</username>
            <password>{5bTlAWaH...}</password>
            <id>vro01</id>
        </server>
    </servers>
    <profiles>
        <profile>
            <id>packaging</id>
            <properties>
                <keystorePassword>{ftykftyid}</keystorePassword>
                <keystoreLocation>/Users/user1/.m2/keystore/archetype.keystore-2.0.0.zip</keystoreLocation>
                <vroPrivateKeyPem>/Users/user1/.m2/keystore/private_key.pem</vroPrivateKeyPem>
                <vroCertificatePem>/Users/user1/.m2/keystore/cert.pem</vroCertificatePem>
                <vroKeyPass>PASSWORD</vroKeyPass>
            </properties>
        </profile>
        <profile>
            <id>bundle</id>
            <properties>
                <assembly.skipAssembly>false</assembly.skipAssembly>
            </properties>
        </profile>
        <profile>
            <id>artifactory</id>
            <repositories>
                <repository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>central</id>
                    <name>central</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </repository>
                <repository>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                    <id>central-snapshots</id>
                    <name>central-snapshots</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                    <id>central</id>
                    <name>central</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </pluginRepository>
                <pluginRepository>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                    <id>central-snapshots</id>
                    <name>central-snapshots</name>
                    <url>https://repo1.maven.org/maven2/</url>
                </pluginRepository>
            </pluginRepositories>
            <properties>
                <releaseRepositoryUrl>https://repo1.maven.org/maven2/</releaseRepositoryUrl>
                <snapshotRepositoryUrl>https://repo1.maven.org/maven2/</snapshotRepositoryUrl>
            </properties>
        </profile>
        <profile>
            <!--Environment
            identifier. Multiple environments are allowed by configuring multiple profiles -->
            <id>vro01</id>
            <properties>
                <vrealize.ssl.ignore.hostname>false</vrealize.ssl.ignore.hostname>
                <vrealize.ssl.ignore.certificate>false</vrealize.ssl.ignore.certificate>
                <!--vRO Connection-->
                <vro.host>VRO_FQDN</vro.host>
                <vro.port>443</vro.port>
                <vro.serverId>vro01</vro.serverId>
                <vro.auth>basic</vro.auth>
            </properties>
        </profile>
        <profile>
            <!--Environment
            identifier. Multiple environments are allowed by configuring multiple profiles -->
            <id>vra01</id>
            <properties>
                <vrealize.ssl.ignore.hostname>false</vrealize.ssl.ignore.hostname>
                <vrealize.ssl.ignore.certificate>false</vrealize.ssl.ignore.certificate>
                <!--vRA Connection-->
                <vro.host>VRA_FQDN</vro.host>
                <vro.port>443</vro.port>
                <vro.serverId>vra01</vro.serverId>
                <vro.auth>basic</vro.auth>
            </properties>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>artifactory</activeProfile>
        <activeProfile>packaging</activeProfile>
    </activeProfiles>
</settings>

Now, the .m2 directory should include the following:

1
2
3
4

Permissions Size   User  Date Modified Name
drwxr-xr-x@    -   user1 27 Mar 20:07  keystore
.rw-r--r--@  105   user1 27 Mar 21:07  settings-security.xml
.rw-r--r--@  6.1k  user1 27 Mar 21:07  settings.xml

Install Building Tools dependencies

Clone the repo and run the following:

1
2
3
4
5
6
7
8
9

cd /path/build-tools-for-vmware-aria-2.37.0

mvn clean install -f common/keystore-example/pom.xml
mvn clean install -f maven/npmlib/pom.xml
mvn clean install -f pom.xml
mvn clean install -f maven/base-package/pom.xml
mvn clean install -f packages/pom.xml
mvn clean install -f maven/typescript-project-all/pom.xml
mvn clean install -f maven/repository/pom.xml

All the mvn commands should be completed successfully. This will confirm that NodeJS is installed correctly. If one of the steps will fail, check that the installed version of Node is 16.x.

Install vRealize Developer Tools

Follow the instructions provided in the repository. The simplest way is to install the extension in the VSCode. Just go to the Extensions Marketplace and install it. img-description

Create a new project in VSCode

Open VSCode, go to Command Palette (CMD + SHIFT + P) and start typing vRealize. Select vRealize: New Project. img-description Select the type of the project. Let’s create a vRO TypeScript-based Project img-description Provide a Project ID img-description Provide a Project Name img-description Save the project in some directory.

If the error occurs, it may happen because of the default version DarchetypeVersion=2.12.5. The quick solution will be to change the default version in the vRealize Developer Tool setting in VSCode below to any relevant version that should be used.

img-description

When everything was done properly, we should see the following in the VSCode img-description

Optional: Configure vRO to support Basic Authentication

If Basic authentication is chosen, follow this procedure. This is how it should look like at the end. img-description

UPDATE 1: Windows installation

Thanks to Mohammad Makeen AlDamouni for providing these tips.

Windows based installation requires a few additional adjustments:

Make sure both Python and OpenSSL are added to the environment variables.

  1. Install OpenSSL (version: OpenSSL 3.1.3 19 Sep 2023 (Library: OpenSSL 3.1.3 19 Sep 2023) )

  2. Install Python (version: Python 3.8.0) - pip: 19.2.3

    The steps below are similar to those mentioned above for the Mac and can be referenced.

  3. Creation of the Keystore can be done using the KeyStore Explorer.
  4. Extract private key from the keystore.
  5. Generate the certificate.
  6. Confirm that both the generated previously certificate and private key are valid.

Some of the mvn clean install commands can fail. The reason for that is the user who executed the command encountered a privilege restriction, which prevented the command from running successfully. To resolve this issue, one possible solution is to open the Command Prompt with administrative access by choosing the “Run as administrator” option.

It is possible to add -X to the mvn command to get the output at the debug level.

Next step

In the next post, we’ll see how to push the code to the vRO with some cool tricks.

VMware, Build Tools, Aria Orchestrator, How To, vRO
vmware building_tools
This post is licensed under CC BY 4.0 by the author.