OpenNCP - Installation Manual Consolidation

Aug 6, 2015 

Estimated - 13:00 to 14:00 CEST

Performed - 13:00 to 14:30 CEST

AGENDA

1) Feedback review installation manual

LOCATION

- Wiki+ WorkBench + AdobeConnect

• Development Board:  https://openncp.atlassian.net/secure/RapidBoard.jspa?rapidView=1

• AdobeConnect: 

  •  http://ec-wacs.adobeconnect.com/openncp/

    Room Passcode:  ask @Rui Alves (Unlicensed) or @markus.kalliola

    ----------------

    If you have never attended an Adobe Connect meeting before:

    Test your connection: http://ec-wacs.adobeconnect.com/common/help/en/support/meeting_test.htm

    Get a quick overview: http://www.adobe.com/products/adobeconnect.html

    Adobe, the Adobe logo, Acrobat and Adobe Connect are either registered trademarks or trademarks of Adobe Systems Incorporated in the United States and/or other countries.
    ----------------

PARTICIPANTS

Today's Meeting Participants: (To be updated)

@Rui Alves (Unlicensed)

@Joao Cunha

@S

Yacoubou Waolany

@Alen Vrecko (Unlicensed)

@Tomaž Zupan

[holidays] Michèle Foucart

[holidays] Stephane Spanhi

Invited Members List:

Licinio Mano

Alexandre Santos

Marko Peric

Heiko Zimmermann

Kostas Karkaletsis

Markus Kalliola

Robert Scharinger

Thomas Fleischman

Sandra Klimmecek

Marcello Melgara

RELATED PAGES

• OpenNCP Installation

• OpenNCP Installation Manual (deprecated, since 2015-10-29)

MEETING NOTES

1) Feedback review Installation manual

• @Joao Cunha provided guidance to his comments and made an overview on the comments added from @S and @Alen Vrecko (Unlicensed):

  • The review of the manual and the comments made and added in the review page should be a team work, and so, be revised by all the community, including the TECH COMMITEE...

  • Section 1: JDK 1.7 is an advise, as 1.8 may not work...

  • Section 2:@Alen Vrecko (Unlicensed) suggests that this info should be placed in section 4 (section for becomes section 3 in consequence), as this information for someone new is isollated and out of context.

  • Section 3: Need to compile this into the Installation Manual

    • @Joao Cunha: We should leave this question open until we have this knowledge.

    • @S: We should update the .zip file.

    • The OID is important as well

      • @Joao Cunha: we have to ask to TECH COMMITEE.

    • 3.1 - @Alen Vrecko (Unlicensed): Link to Installation Manual (IM) Overview on the beginning of the manual, for sake of understanding of the whole picture - we started by the IM not having seen the IM Overview before...

    • 3.2 - Help needed from @Stéphane Spahni.

      @S to update properties.

    • 3.3 - Keystores - Needed inputs from @Stéphane Spahni.

      • @S: We could make a summary about Keystores and Truststores...

  • Section 4:

    • 4.2 - @Joao Cunha: We need to write something about this point... Like screenshots of the TSL-Editor explaining the configurations available there.

      • epSOS Deliverable 3.4.2 may help - it has the structure of the TSL files...

      • Some fields must have specifi values - we SHOULD take a look in this section and assess if we can add somethingto the manual.

      @Joao Cunha to do this assessment

      @Alen Vrecko (Unlicensed) to take the screenshots and explain steps (constraints of time, possibly only in Sept)...
      
      
      

    • 4.5 - @Kostas Karkaletsis and the TECH COMMITEE may provide helpful tips here...

    • 4.7 - @Joao Cunha: This was the most confusing section for me... Did I miss something to add in the Manual revieew?

      • @S: Guess the review is complete.

    • 4.8 - @Joao Cunha and @S: We need to know the right direction to move about how can we build the National Connector...

      • There is something on Developer's Corner about this...

      @S will try to recover this page, if doubts persist, we'll need to ask TECH COMMITEE assistance...

  • Section 5: 

    •  None of us needed to pass through this part... For now, it remains as it is.

  
  
  

• Review from @Alen Vrecko (Unlicensed)'s Comments:

  • "A link to "OpenNCP Installation Overview" should be available somewhere in the beginning of the manual, e.g. before proceeding with the installation please refer to "OpenNCP Installation Overview" for the basic information about the OpenNPC installation and OpenNPC architecture."

    • @Joao Cunha: we should put it at the very beginning...

    • @S: Should these 2 pages be merged? The IM and the IM Overview?

      • @Joao Cunha: It is possible and makes sense... We need to look as it is and if it is updated...

  • "Section 2, Obtain artifacts lists the artifacts which are not mentioned in section 3, but only later, in section 4. We suggest to MOVE the whole section under section "4. Install and setup components" (this will make it section 3), e.g. 4.1 (3.1) and RENAME to "List of NPC Artifacts"

    • We should move section 2 to section 4.

  • "Are you supposed to execute this script manually or is it being executed automatically during the process of installation? Maybe just add a line explaining that."

    • @Joao Cunha: We should explain how to run the script (4.3)...

  • "Sections 4.4, 4.5, 4.6 and 4.7 are all describing instructions of necessary installations, but they lack of explanation of their purpose."

    • @Alen Vrecko (Unlicensed): We need to explain the purpose of some points...

    • @Joao Cunha: Some are in the IM Overview... Should we add in the IM Overview? Or directly in the IM?
      
      

  • IPSec...

• Related ISSUES

  • https://openncp.atlassian.net/browse/OPENNCP-39Help with OpenNCP installation: OpenATNA,

  • https://openncp.atlassian.net/browse/OPENNCP-8OpenNCP Installation Manual Improvement: TSL Properties

  • https://openncp.atlassian.net/browse/OP-5Installation notes for the log viewer

  • https://openncp.atlassian.net/browse/COMA-10Update the epsos configuration zip file in installation manual at the wiki

  • @Joao Cunha Investigated the issues

    • 1 of them is already addressed in the current installation manual;

    • 3 will be resolved with review.