Adding info about reinitializing the appliance #852

stuclem · 2017-09-21T16:23:13Z

Fixes #681

Fixes #763

@andrewtchin and @anchal-agrawal can you please review? Thanks!

andrewtchin

wait for anchal to review too

anchal-agrawal · 2017-09-21T17:01:04Z

docs/user_doc/vic_vsphere_admin/register_different_psc.md

+
+2. Delete the three Platform Services Controller configuration files from the appliance.
+
+    <pre>rm /etc/vmware/psc/admiral/psc-config.properties`</pre>


Trailing ` character at the end on this line and the two below.

anchal-agrawal · 2017-09-21T17:09:54Z

docs/user_doc/vic_vsphere_admin/register_different_psc.md

+2. Stop the vSphere Integrated Containers Management Portal service.
+
+    <pre>systemctl stop admiral.service</pre>
+2. List all of the containers that are running in the appliance.


List all of the containers that are running in the appliance. -> List all of the containers in the appliance.

anchal-agrawal · 2017-09-21T17:12:25Z

docs/user_doc/vic_vsphere_admin/reinitialize_appliance.md

@@ -0,0 +1,16 @@
+# Reinitialize the vSphere Integrated Containers Appliance
+
+After you power on the vSphere Integrated Containers appliance for the first time, you are prompted to enter the vCenter Server credentials. This allows performs the OVA installer to perform two tasks to  initialize the appliance:


... you are prompted to enter the vCenter Server credentials and PSC settings.

anchal-agrawal · 2017-09-22T03:36:53Z

Adding @lgayatri - we should verify the steps documented in this PR for registering with a different PSC on your setup before merging this.

stuclem · 2017-09-22T08:40:50Z

Thanks @anchal-agrawal. A couple of questions about this info:

Are these procedures only applicable to 1.2.1? If so, I will merge this just before I push the 1.2.1 update (I have other updates for 1.2.0 that I want to push today, before we release 1.2.1)
In the case of re-tagging the appliance, I just say that you might need to do it if someone accidentally deletes the tag.
- Are there other cases in which the tag might disappear?
- What exact errors do users see if the tag is missing?

Thanks!

lgayatri · 2017-09-22T10:32:41Z

@stuclem @anchal-agrawal . I reviewed the steps for https://github.com/stuclem/vic-product/blob/78713dd98a8246a8d950ee1fc619cc79427bea47/docs/user_doc/vic_vsphere_admin/register_different_psc.md.

Guide looks great. Two comments:

In Step 5, remove ` at the end of file name
In Step 6, the URL would be https://vic_appliance_address:9443 instead of http://vic_appliance_address.

By the way, I tested this workflow and it works perfectly.

stuclem · 2017-09-22T10:55:50Z

Thanks @lgayatri - I have removed the trailing ` from step 5 in 81dd1d0. For the address, http://vic_appliance_address redirects to https://vic_appliance_address:9443, so we opted to use the simpler address throughout the docs.

Glad to hear that the procedure works perfectly!

lgayatri · 2017-09-22T11:03:20Z

Ok @stuclem , please retain the port number as 9443.

stuclem · 2017-09-25T13:06:48Z

@anchal-agrawal these procedures relate exclusively to 1.2.1, correct? If so, I'll hold off merging this until we push the 1.2.1 update release.

anchal-agrawal · 2017-09-25T14:49:41Z

@stuclem This applies to 1.2.0 as well. However, the steps we have mentioned in register_different_psc.md (originally doc'd in #681 (comment)) are not fully fleshed out and tested yet. Please hold off on merging that section.

Re: tagging - not sure how the tag could disappear unless the user removes it. If the tag is missing, the content trust feature would not work as expected. If tagging fails the first time the appliance is initialized via the Getting Started page, the user will see a red alert with the message Failed to locate VIC Appliance. Please check the vCenter Server provided and try again.

anchal-agrawal · 2017-09-27T14:59:29Z

docs/user_doc/vic_vsphere_admin/reinitialize_appliance.md

+
+The Getting Started Page includes a button labeled **Re-Initialize the  vSphere Integrated Containers Appliance**. 
+
+**CAUTION**: Clicking the reinitialize button when the appliance is functioning correctly can result in data loss. You must only reinitialize the appliance in the following circumstances:


This is not true - clicking the reinitialize button while the OVA is functioning does not break the OVA. However, during upgrade, it's important that the user not visit the Getting Started page and initialize from there or use the reinitialize button on that page. We mention this note on the OVA console screen and in the upgrade docs.

We should revert this note to its earlier form.

Done in de44433

anchal-agrawal · 2017-09-27T15:37:10Z

docs/user_doc/vic_vsphere_admin/register_different_psc.md

@@ -0,0 +1,30 @@
+# Register the vSphere Integrated Containers Appliance with a Different Platform Services Controller


I suggest deferring this addition. As noted in a previous comment in this PR, these steps haven't been fully verified. @lgayatri saw an issue where this procedure worked fine and the OVA was working as expected, but the Admiral UI looked broken after ~15 hours. I haven't gotten a chance to look into that yet.

I think we should:

remove this file and any references to it in this PR

re-open Reregister with new PSC #610 since that issue is specifically for doc'ing the process to register with a different PSC

Removed in 6163c49 and fcb32b7. Reopened #644 to reinsert this text once the procedure is fixed and validated.

Adding info about reinitializing the appliance

78713dd

stuclem requested review from andrewtchin and anchal-agrawal September 21, 2017 16:23

vmwclabot added the cla-not-required label Sep 21, 2017

andrewtchin approved these changes Sep 21, 2017

View reviewed changes

anchal-agrawal reviewed Sep 21, 2017

View reviewed changes

anchal-agrawal requested a review from lgayatri September 22, 2017 03:36

Comments from Anchal on reinit

81dd1d0

stuclem mentioned this pull request Sep 25, 2017

Inconsistent redirect behavior if you specify HTTP or HTTPS with OVA address #864

Open

Added link to wrapper topic.

5f956b3

More info about retagging appliance VM.

2bb7dac

andrewtchin approved these changes Sep 26, 2017

View reviewed changes

stuclem mentioned this pull request Sep 27, 2017

OVA upgrade 1.1.1 to 1.2.y fails during harbor's data migration #841

Closed

Beefed up the warning against clicking reinit

e7265f3

anchal-agrawal reviewed Sep 27, 2017

View reviewed changes

stuclem added 3 commits September 28, 2017 12:36

Reverted warning about pressing reinit button

de44433

Removed references to topic on registering with different PSC.

6163c49

Deleted PSC topic (kept backup copy for later use)

fcb32b7

stuclem mentioned this pull request Sep 28, 2017

Document how to register VIC Appliance with a new PSC and install/upgrade plug-ins after deployment #644

Closed

anchal-agrawal approved these changes Sep 28, 2017

View reviewed changes

stuclem merged commit 58f6e96 into vmware:master Sep 29, 2017

stuclem deleted the initialize branch September 29, 2017 09:12

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Adding info about reinitializing the appliance #852

Adding info about reinitializing the appliance #852

stuclem commented Sep 21, 2017

andrewtchin left a comment

anchal-agrawal Sep 21, 2017

stuclem Sep 22, 2017

anchal-agrawal Sep 21, 2017

stuclem Sep 22, 2017

anchal-agrawal Sep 21, 2017

stuclem Sep 22, 2017

anchal-agrawal commented Sep 22, 2017

stuclem commented Sep 22, 2017

lgayatri commented Sep 22, 2017

stuclem commented Sep 22, 2017

lgayatri commented Sep 22, 2017

stuclem commented Sep 25, 2017

anchal-agrawal commented Sep 25, 2017 •

edited

Loading

anchal-agrawal Sep 27, 2017

stuclem Sep 28, 2017

anchal-agrawal Sep 27, 2017 •

edited

Loading

stuclem Sep 28, 2017 •

edited

Loading


		2. Delete the three Platform Services Controller configuration files from the appliance.

		<pre>rm /etc/vmware/psc/admiral/psc-config.properties`</pre>

		@@ -0,0 +1,16 @@
		# Reinitialize the vSphere Integrated Containers Appliance

		After you power on the vSphere Integrated Containers appliance for the first time, you are prompted to enter the vCenter Server credentials. This allows performs the OVA installer to perform two tasks to initialize the appliance:


		The Getting Started Page includes a button labeled Re-Initialize the vSphere Integrated Containers Appliance.

		CAUTION: Clicking the reinitialize button when the appliance is functioning correctly can result in data loss. You must only reinitialize the appliance in the following circumstances:

		@@ -0,0 +1,30 @@
		# Register the vSphere Integrated Containers Appliance with a Different Platform Services Controller

Adding info about reinitializing the appliance #852

Adding info about reinitializing the appliance #852

Conversation

stuclem commented Sep 21, 2017

andrewtchin left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

anchal-agrawal commented Sep 22, 2017

stuclem commented Sep 22, 2017

lgayatri commented Sep 22, 2017

stuclem commented Sep 22, 2017

lgayatri commented Sep 22, 2017

stuclem commented Sep 25, 2017

anchal-agrawal commented Sep 25, 2017 • edited Loading

Choose a reason for hiding this comment

Choose a reason for hiding this comment

anchal-agrawal Sep 27, 2017 • edited Loading

Choose a reason for hiding this comment

stuclem Sep 28, 2017 • edited Loading

Choose a reason for hiding this comment

anchal-agrawal commented Sep 25, 2017 •

edited

Loading

anchal-agrawal Sep 27, 2017 •

edited

Loading

stuclem Sep 28, 2017 •

edited

Loading