10_T3747-1-OTH-17-479_T3747-1_AWS-3_EEP_v2.3_Installation_Guide.pdf

Defense Information Systems Agency

Defense Spectrum Organization

Strategic Planning Office

Annapolis, Maryland 21402

Working Document

Advanced Wireless Services-3 Early Entry Portal v2.3

Installation Guide

T3747-1-OTH-17-479

29 June 2017

Prepared for:

Strategic Planning Office 2004 Turbot Landing

Annapolis, MD 21402-5064

Prime Contractor

Harris Corp.

141 National Business Parkway, Suite 200

Annapolis Junction, MD 20701

Distribution authorized to DoD Components only: Operational Use; June 2017. Other requests shall be referred to the DSO.

AWS-3 EEP v2.3 Installation Guide

Defense Spectrum Organization ii

This report was prepared by Harris Corp. under Contract HC1047-07-D-0001 in support of the

Defense Information Systems Agency’s Defense Spectrum Organization.

Defense Spectrum Organization iii

REPORT DOCUMENTATION PAGE

Form Approved

OMB No. 0704-0188 Public reporting burden for this collection of information is estimated to average 1 hour per response, including the time for reviewing instructions, searching existing data sources, gathering and maintaining the data needed, and completing and reviewing this collection of information. Send comments regarding this burden estimate or any other aspect of this collection of information, including suggestions for reducing this burden to Department of Defense, Washington Headquarters Services, Directorate for Information Operations and Reports (0704-0188), 1215 Jefferson Davis Highway, Suite 1204, Arlington, VA 22202-4302. Respondents should be aware that notwithstanding any other provision of law, no person shall be subject to any penalty for failing to comply with a collection of information if it does not display a currently valid OMB control number. PLEASE DO NOT RETURN

YOUR FORM TO THE ABOVE ADDRESS.

1. REPORT DATE (MM-YYYY) 2. REPORT TYPE 3. DATES COVERED (From - To)

07-2016 Working Document

4. TITLE AND SUBTITLE 5a. CONTRACT NUMBER

Advanced Wireless Services-3 Early Entry Portal v2.3 Installation Guide

HC1047-07-D-0001

5b. GRANT NUMBER

5c. PROGRAM ELEMENT NUMBER

6. AUTHOR(S) 5d. PROJECT NUMBER

Harris Corp. T3747-1 Project Team T3747-1 5e. TASK NUMBER

TO-1110

5f. WORK UNIT NUMBER

7. PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES) 8. PERFORMING ORGANIZATION REPORT NUMBER Harris Corp.

141 National Business Pkwy., Suite 200 Annapolis Junction, MD 20701 T3747-1-OTH-17-479

9. SPONSORING / MONITORING AGENCY NAME(S) AND ADDRESS(ES) 10. SPONSOR/MONITOR’S ACRONYM(S)

Strategic Planning Office 2004 Turbot Landing Annapolis, MD 21402-5064

DSO/SPO

11. SPONSOR/MONITOR’S REPORT

NUMBER(S)

12. DISTRIBUTION / AVAILABILITY STATEMENT

Distribution authorized to DoD Components only: Operational Use; June 2017. Other requests shall be referred to the DSO.

13. SUPPLEMENTARY NOTES

14. ABSTRACT

This document specifies the installation instructions for the Advanced Wireless Services-3 Early Entry Portal v2.3.

15. SUBJECT TERMS

Advanced Wireless Services-3, AWS-3, Early Entry Portal, EEP, Installation Guide

16. SECURITY CLASSIFICATION OF: 17. LIMITATION

OF ABSTRACT

18. NUMBER

OF PAGES

19a. NAME OF RESPONSIBLE JSC PERSON

a. REPORT b. ABSTRACT c. THIS PAGE Christopher D. Johnson

U U U SAR 16

19b. TELEPHONE NUMBER

301-225-3819

Standard Form 298 (Rev. 8-98) Prescribed by ANSI Std. Z39.18

Defense Spectrum Organization iv

This page intentionally left blank.

Defense Spectrum Organization v

Record of Changes

Change

Number Date

Section

Number Description Modified By

Defense Spectrum Organization vi

Defense Spectrum Organization vii

Table of Contents

1. INTRODUCTION

1.1 BACKGROUND

1.2 PURPOSE

1.3 SCOPE

1.4 INTENDED DOCUMENT AUDIENCE

1.5 SECURITY CLASSIFICATION AND CONSIDERATIONS

1.6 PROVIDING FEEDBACK

1.7 POINTS OF CONTACT

2. PREREQUISITES AND ASSUMPTIONS

3. PRE-INSTALL INSTRUCTIONS

4. WEB APPLICATION AND SITE UPGRADE

5. POST INSTALL INSTRUCTIONS

6. ACROYMNS

List of Tables

Table 1-1. Points of Contact

Defense Spectrum Organization viii

Defense Spectrum Organization 9

1. INTRODUCTION

This document presents the upgrade instructions for v2.3 of the Advanced Wireless

Services-3 (AWS-3) Early Entry Portal (EEP) (hereinafter referred to in this document as the EEP).

1.1 BACKGROUND

The Federal Communications Commission (FCC) has reallocated the 1755 – 1780 MHz band for use by commercial entities and completed its auction of Advanced Wireless

Services-3 (AWS-3) licenses. The Services and the Defense Information Systems Agency’s

Defense Spectrum Organization (DSO) have developed transition plans for their respective organizations to facilitate increasingly less-restrictive sharing arrangements for early entry of commercial AWS systems and permanent sharing between the Department of Defense

(DoD) and commercial systems operating in the 1755 – 1780 MHz band.

The FCC and the National Telecommunications and Information Administration specified the procedures to be followed in allowing early entry into this band by the AWS-3 licensees as well as ongoing coordination that would continue to be applicable to the

Government stations that would continue to operate in the band after the transition period.

The EEP is designed and developed to facilitate this coordination.

1.2 PURPOSE

This document specifies the instructions for upgrading the EEP product to version 2.3.

1.3 SCOPE

The scope of this document is limited to describing the installation instructions for the EEP v2.3.

1.4 INTENDED DOCUMENT AUDIENCE

This document is intended for the EEP technical audience.

1.5 SECURITY CLASSIFICATION AND CONSIDERATIONS

This document is considered to be unclassified, with distribution authorized to DoD components only. Other requests shall be referred to the DSO.

1.6 PROVIDING FEEDBACK

Constructive feedback is encouraged from all readers to improve the value and accuracy of the information presented herein. Provide feedback to Mr. Christopher D. Johnson/DSO.

1.7 POINTS OF CONTACT

Table 1-1 lists the contact information for the Harris Corp. individuals that support the installation of the EEP software.

Defense Spectrum Organization 10

Table 1-1. Points of Contact

Title Contact Phone Email

Harris IT Services. Task

Order Manager

Lynn Cumberpatch 301-867-2966 lynn.cumberpatch@harris.com

Harris IT Services. Chief

Software Engineer / Task

Lead

Alexandra Finkler 301-867-2977 alexandra.finkler@harris.com

Harris IT Services

Installation Support

Khanh Pham 301-867-2786 khanh.pham@harris.com mailto:alexandra.finkler@harris.com mailto:khanh.pham@harris.com

Defense Spectrum Organization 11

2. PREREQUISITES AND ASSUMPTIONS

The ability to successfully perform the EEP installation is subject to the following assumptions and prerequisites.

Assumptions:

Experienced system administrators who are capable of installing software products without detailed guidance will carry out the steps within this document.

Installation steps will be completed in the order as they appear in this document.

Prerequisites:

EEP v1.0, v1.5, 2.1 or 2.2 is currently installed.

EEP v2.3 installation CD.

3. PRE-INSTALL INSTRUCTIONS

Set IIS to restrict access for everyone.

Shutdown the SharePoint Server and the Database Server.

Take snapshots for the both servers and name it “Before 2.3 Upgrade”.

Note: If there are any errors or problems during the upgrade process, please revert to this snapshot.

Start both SharePoint server and Database Server.

4. WEB APPLICATION AND SITE UPGRADE

1. Copy the EEPModules folder from the installation drive to the Modules folder within the data drive (e.g., D:\EEPModules\)

2. Add the path to the EEPModules folder (e.g., append “; D:\EEPModules\” without the quotes) to the SPModulePath system variable (if not added already)

3. Create a folder in the root of the data drive called EEPWorkspace (if not created already)

4. Copy the file MasterUpgrade.ps1 from the installation drive to the EEPWorkspace folder

5. Create a folder named EEP2.3Release under EEPWorkspace; e.g., F:\EEPWorkspace\EEP2.3Release

6. Copy the eepsolution.wsp version 2.3 to the release folder; e.g., F:\EEPWorkspace\EEP2.3Release\eepsolution.wsp

7. Open a new Powershell session as an administrator

8. Type the command to add the SharePoint snapin:

Add-PSSnapin Microsoft.SharePoint.PowerShell

Defense Spectrum Organization 12

9. Run the “Get-EEPInvalidWorkflows” script, to ensure there are no cases that are in a bad state, before proceeding. If there are bad cases; evaluate whether the upgrade can proceed.

10. Close the current Powershell session to release the EEPSolution.dll from memory

11. Open a new Powershell session as an administrator

12. Type the command to add the SharePoint snapin:

Add-PSSnapin Microsoft.SharePoint.PowerShell

13. Run the MasterUpgrade.ps1

14. When prompted, provide the following:

a. WebApplicationUrl: https://<TheServerURL>:443

Note: Make sure to replace the <The Server URL> with the actual server.

b. SolutionNameToUninstall: eepsolution.wsp

c. SolutionFileToBeInstall: [DataDrive]:\

EEPWorkspace\EEP2.3Release\EEPSolution.wsp

d. Type in “y” (without quotes) when prompt for confirmation

15. When prompted about web.config is encrypted?

a. Enter “Y” (without quotes) or “Yes” to confirm that the web.config is encrypted.

16. Monitor the console for any error until the script finishes

5. POST INSTALL INSTRUCTIONS

1. Shut down both servers

2. Take a snapshot for both VMs and name them “After 2.3 Upgrade”

3. Start up the servers

4. Open the EEP application in a browser

5. Login as different test users and make sure that the site operate as normal

6. Run a few tests:

a. Create CRs and CAs

b. Move New CRs and CAs forward in the workflow

c. Move Old CRs and CAs forward in the workflow

7. After the test is finished, Revert the VMs to the Snapshot named “After 2.3 Upgrade”

8. Start the two VMs

9. Open EEP and login as the Administrator user

10. Make sure that none of the test data are present

Defense Spectrum Organization 13

11. Delete all temporary and installation files

12. Delete all snapshot

13. Remove IIS restriction

14. DO NOT run any more tests after this step

Defense Spectrum Organization 14

Defense Spectrum Organization 15

6. ACROYMNS

AWS-3 Advanced Wireless Services-3

DoD Department of Defense

DSO Defense Spectrum Organization

EEP Early Entry Portal

FCC Federal Communications Commission

Defense Spectrum Organization 16

Defense Spectrum Organization

DISTRIBUTION LIST

Internal No. of Copies

R. Schneider (.pdf)

G. Wagner (.pdf)

H. McDonald (.pdf)

C. Johnson (.pdf)

S. Schutta (.pdf)

L. Cumberpatch (.pdf)

A. Finkler (.pdf)

Defense Spectrum Organization