Migrating apps to TAS for VMs [Windows]

You can run apps on VMware Tanzu Application Service for VMs [Windows] 2012 R2 stemcells to run on TAS for VMs [Windows] stemcells, which run Windows Server 2019.

Caution TAS for VMs [Windows] 2012 R2 has reached its end of availability (EoA) and is no longer available.

VMware recommends the blue-green deployment method for high availability.

For more information about blue-green deployments, see Using blue-green deployment to reduce downtime and risk.

Step 1: Installing and deploying the TAS for VMs [Windows] tile

To install and deploy the TAS for VMs [Windows] tile, follow steps 1 and 2 of Installing and configuring TAS for VMs [Windows].

Step 2: Pushing an app to TAS for VMs [Windows] Diego Cells

To deploy a running app again with zero downtime using the blue-green method:

Log in to the Cloud Foundry Command Line Interface (cf CLI) by running:
```
cf login
```
Choose your org and space.
Go to the location of your app.
To find the name of the existing TAS for VMs [Windows] 2012 R2 app you are migrating to TAS for VMs [Windows] Diego, run:
```
cf apps
```
Create a name for the replacement TAS for VMs [Windows] app. VMware recommends you append -green to your existing app name, as shown here:
```
APP-NAME-green
```
Where APP-NAME is the name of the existing TAS for VMs [Windows] Diego 2012 R2 app.
To push your app to a TAS for VMs [Windows] Diego Cell using your newly created name, run:
```
cf push APP-NAME-GREEN -s windows -b BUILDPACK -n HOSTNAME --no-start --no-route
```
Where:
- APP-NAME-GREEN is the newly created “green” name for your app.
- BUILDPACK is your custom buildpack. Specify the buildpack either by name or GitHub URL with an optional branch or tag.
- HOSTNAME is the name of your app’s subdomain. For example, if example.com is your domain and you want the URL to your app to be http://my-app.example.com, then specify my-app as the HOSTNAME.
For example:
```
C:\Users\admin\> cf push ExampleApp-green -s windows ^
-b https://github.com/cloudfoundry/binary-buildpack.git ^
-n my-app --no-start --no-route
```
Important The --no-start and --no-route parameters in this cf push command are required for this procedure. The --no-start parameter is used to create the instance VMs and not start the app, and the --no-route parameter prevents cf push from automatically mapping a route to the app, but no longer unbinds all existing routes associated with the app.

For more information about cf push, see cf push in the Cloud Foundry CLI Reference Guide.
To configure the router so all incoming requests go to both APP-NAME and APP-NAME-green, run:
```
cf map-route APP-NAME-green DOMAIN -n HOSTNAME
```
Where:
- APP-NAME-green is the name of the new “green” version of your app.
- DOMAIN is your domain name. For example, example.com.
- HOSTNAME is the name of your app’s subdomain. For example, if example.com is your domain and you want the URL to your app to be http://my-app.example.com, then specify my-app as the HOSTNAME.
When you use the cf map-route command, you must specify domain name after you specify the app name. For additional information, see cf map-route in the Cloud Foundry CLI Reference Guide.
To start the green app, run:
```
cf start APP-NAME-green
```
Where APP-NAME-green is the name of the new “green” version of your app.
To confirm that both your APP-NAME and APP-NAME-green apps are running, run:
```
cf apps
```
If you experience a problem, see Troubleshooting app deployment and health.
To unmap the original app’s route, run:
```
cf unmap-route APP-NAME DOMAIN -n HOSTNAME
```
Where:
- APP-NAME is the name of the existing version of your app you want to replace with APP-NAME-green.
- DOMAIN is your domain name, for example, example.com.
- HOSTNAME is the name of your app’s subdomain. For example, if example.com is your domain and the existing app is accessed using the URL http://my-app.example.com, then specify my-app as the HOSTNAME.
For additional information about cf-unmap-route, see cf unmap-route in the Cloud Foundry CLI Reference Guide.

Step 3: Deleting an app from TAS for VMs [Windows] 2012 R2 Server Diego Cells

To delete the original app:

Run:
```
cf delete APP-NAME
```
Where APP-NAME is the name of the app that you replaced with APP-NAME-green.

Important Running the command with the -r flag no longer deletes routes when the route is mapped to more than one app.

For additional information about cf delete command, see cf delete in the Cloud Foundry CLI Reference Guide.

Step 4: Uninstalling the old tile (optional)

After you migrate all your apps and you are no longer using the TAS for VMs [Windows] 2012 R2 tile, a Operations Manager uninstalls the tile.

To uninstall the tile:

From the Installation Dashboard, click the Trash icon on the tile to remove that product. In the Delete Product pane, click Confirm.
Click Review Pending Changes.
Click the TAS for VMs [Windows] tile and review the changes. For more information, see Reviewing pending product changes.
Click Apply Changes.

After you delete a product, the product tile is removed from the installation and the Installation Dashboard. However, the product appears in the Available Products view.