Portal User Manual(Installation Guide) · Execute SetupDB_MSSQL_2008.bat in the case of SQL Server...

MasterScope Virtual DataCenterAutomation ver5.0Portal User Manual(Installation Guide)

DisclaimerThe copyrighted information noted in this document shall belong to NEC Corporation.

Copying or revising this document, in whole or in part, is strictly prohibited without thepermission of NEC Corporation.

This document may be changed without prior notice.

NEC Corporation shall not be liable for any technical or editing errors or omissions in thisdocument.

NEC Corporation shall not be liable for the accuracy, usability, or certainty of information notedin this document.

Copyright Information• SigmaSystemCenter, MasterScope, Netvisor, NEC Storage, ESMPRO, EXPRESSBUILDER,

EXPRESSSCOPE, SIGMABLADE, UNIVERGE, and ProgrammableFlow are registeredtrademarks of NEC Corporation.

• VMware is a trademark or registered trademark of VMware, Inc. in the United States and othercountries.

• Microsoft, Windows, Windows Server, Windows Vista, Internet Explorer, SQL Server, andHyper-V are trademarks or registered trademarks of Microsoft Corporation in the United Statesof America and other countries.

• Linux is a trademark or registered trademark of Linus Torvalds in the United States of Americaand other countries.

• Red Hat is a trademark or registered trademark of Red Hat, Inc. in the United States and othercountries.

• Intel and Itanium are trademarks or registered trademarks of Intel Corporation in the UnitedStates of America and other countries.

• Apache, Apache Tomcat, and Tomcat are trademarks or registered trademarks of ApacheSoftware Foundation.

• Oracle, Solaris, Java, and WebLogic are registered trademarks of Oracle Corporation and itssubsidiaries and affiliates in the United States of America and other countries.

Other system names, company names, and product names in this document are trademarks orregistered trademarks of their respective companies.

Note the ® mark and the ™ mark are not indicated in this document.

Notes on exporting this productThis product (including software) may be applicable to the controlled cargo (or services) regulated bythe Foreign Exchange and Foreign Trade Law. To export the product to outside of Japan, the exportpermit from Japanese government is required. When information materials, etc. are required for theexport permit application process, contact your distributor or the nearest sales office.

i

PrefaceThis document describes the method of installing MasterScope Virtual DataCenter AutomationPortal.

Related ManualFor details about the method of installing MasterScope Virtual DataCenter Automation ver5.0, seeMasterScope Virtual DataCenter Automation ver5.0 Portal User's Manual (Operation Guide).

Revision HistoryThe configuration of this document is described below:

1. Operating environments

2. Preparation

3. Installation method

4. Environment setting after the installation

5. Uninstallation method

The revision history of the "MasterScope Virtual DataCenter Automation ver5.0 Portal User'sManual (Installation Guide)" is described below:

Manual Revision History

Number Chapter/Section

Details

First Edition

- - -

Notation Rules of This DocumentIn this document, important notes and related information are described as follows.

NoteA functional, operational, or configurational notice, warning, or complement is described.

Notation ListThe following conventions apply to this document.

Notation How to use Example

[ ] square brackets Placed before and after an item (such as a textbox, check box, or tab) on the screen

Enter the machine name in theMachine Name text box.All check box

" " Placed before and after a screen name (such as adialog box or window), and a name of othermanuals

"Setting" window"Installation Guide"

ii

Notation How to use Example

[ ] square brackets inthe command-line

Indicates that the specification of the value in [ ]can be omitted.

add [/a] Gr1

Monospace font(courier new)

Output from the command-line (such as a messageor prompt)

Execute the followingcommand:replace Gr1

Italicizedmonospace font(courier new)

Indicates the items to be replaced with a validvalue and input by users.If the value contains any spaces, surround it with "" (double quotes).

add GroupNameInstallPath= "InstallPath"

iii

ContentsChapter 1. Operating Environments.......................................................................................... 1

1.1 Hardware Requirements ........................................................................................................2

1.2 Software Requirements .........................................................................................................31.2.1 Server..........................................................................................................................31.2.2 Client ..........................................................................................................................3

Chapter 2. Preparation................................................................................................................ 42.1 Construction of a Database Server ........................................................................................5

2.2 SQL Connection Settings ......................................................................................................5

Chapter 3. Installation................................................................................................................. 83.1 Executing Installation............................................................................................................9

3.2 Installation Method in the Case of Redundancy ..................................................................12

Chapter 4. Settings of the Connection with ServiceGovernor WebAPI Base Option ......... 194.1 Connection Settings ............................................................................................................20

4.2 Acquiring and Setting of the MasterScope Virtual DataCenter Automation API Key..........20

Chapter 5. Setting after the Installation .................................................................................. 225.1 Permission for Connection Using the Listening Port Number .............................................23

5.2 Timezone Setting ................................................................................................................24

5.3 Disk Tag Setting..................................................................................................................25

5.4 Application Server (Tomcat) Setting ...................................................................................27

Chapter 6. Connecting to Portal ............................................................................................... 30

Chapter 7. Cluster Constructing .............................................................................................. 317.1 Managing the configuration files.........................................................................................32

7.2 Configuring a cluster shared disk ........................................................................................32

7.3 Positioning and Modifying the SQL Scripts ........................................................................33

7.4 Moving a Database File.......................................................................................................33

7.5 Detaching a database file.....................................................................................................347.5.1 Moving a database file ..............................................................................................347.5.2 Attaching a database file ...........................................................................................347.5.3 Re-creating database users ........................................................................................34

Chapter 8. Upgrading ................................................................................................................ 368.1 Executing Version Up Installation .......................................................................................37

8.2 Configuration after Version Up ...........................................................................................37

Chapter 9. Uninstallation .......................................................................................................... 389.1 Executing Uninstallation .....................................................................................................39

iv

9.2 Deleting Database ...............................................................................................................44

9.3 Deleting Attachment Files...................................................................................................44

v

List of FiguresFigure 2-1 Selecting Instance Name...........................................................................................5Figure 2-2 Enabling TCP/IP.......................................................................................................6Figure 2-3 TCP/IP Property........................................................................................................6Figure 2-4 Specifying the TCP Port ...........................................................................................7Figure 4-1 Services Screen.......................................................................................................21Figure 5-1 Firewall Detail Setting Screen.................................................................................23Figure 5-2 New Inbound Rule Wizard......................................................................................24Figure 5-3 Tomcat properties ...................................................................................................28Figure 5-4 Tomcat properties ...................................................................................................29Figure 5-5 Tomcat properties ...................................................................................................29

vi

List of Tables Manual Revision History ......................................................................................... iiTable 3-1 Setting Item List (Global management server setting).............................................10Table 3-2 Details about the Application Server Setting...........................................................17Table 3-3 Details about the MasterScope Virtual DataCenter Automation Portal Setting........17Table 4-1 Setting.....................................................................................................................20Table 5-1 Setting Items (New Inbound Rule Wizard)..............................................................24Table 5-2 Item List (Timezone Setting) ..................................................................................24Table 5-3 Item List (Disk Tag Setting)....................................................................................25Table 5-4 Item List (Disk Tag Setting)....................................................................................26Table 7-1 Configuration Files Required to Be Set Up and Managed on Both Servers .............32Table 7-2 Setting item.............................................................................................................33Table 7-3 Setting Items...........................................................................................................34

vii

Chapter 1. Operating Environments

Contents1.1 Hardware Requirements ...............................................................................................................2

1.2 Software Requirements ................................................................................................................3


1

This section describes the hardware and software requirements.

1.1 Hardware RequirementsThe minimum specifications of Portal are as follows.

Hardware name Specification

CPU Intel Compatible 2GHz 2Core or higher

Memory At least 3 GB

Hard disk At least 4 GB

Recommended display resolution 1024 x 768 or higher

The recommended specifications are as follows.

Hardware name Specification

CPU Intel Compatible 2.4GHz 8 processor or higher

Memory At least 16 GB

Hard disk At least 50 GB

Recommended display resolution 1024 x 768 or higher

The recommended specifications are based on the actual values necessary to satisfy the maximum ofeach of the items.

Item Maximum Remark

Tenant number 200

Number of users 20,000

Number of concurrentconnections (https)

2,000 Using the following as reference values, you mustchange the settings made for the application server(Tomcat).• Memory: 8096 MB• Number of threads: 300• Number of connections: 2,000

For details, see "5.4 Application Server (Tomcat)Setting (page 27)".

Number of requests 1,000,000 Using the following as reference values, you mustchange the settings made for the application server(Tomcat).• Memory: 8096 MB


Number of concurrentrequests to execute

20

Number of managedservers (VMs)

100,000 Using the following as reference values, you mustchange the settings made for the application server(Tomcat).• Memory: 8096 MB



2

Item Maximum Remark

Number of managed tenantnetworks

4,000

Number of task group 2,000 10 task groups are assumed per tenant.

Number of VM templates 200

1.2 Software Requirements1.2.1 Server

Components Software name

OS Windows Server 2008 R2 Datacenter (x64) SP1Windows Server 2008 R2 Standard (x64) SP1Windows Server 2008 R2 Enterprise (x64) SP1Windows Server 2012 DatacenterWindows Server 2012 StandardWindows Server 2012 R2 DatacenterWindows Server 2012 R2 Standard

DBMS Microsoft SQL Server 2008 R2Microsoft SQL Server 2012 SP1Microsoft SQL Server 2012Microsoft SQL Server 2014

* With respect to the virtual base to be supported, those that are supported by MasterScope VirtualDataCenter Automation ver5.0 are subject to be supported.

1.2.2 ClientComponents Software name

OS Only for Windows OS in which following browsers are available.

Web browser Internet Explorer 10,11Microsoft Edge 20.10240Firefox 44.0Google Chrome 49.0


3

Chapter 2. Preparation

Contents2.1 Construction of a Database Server ...............................................................................................5

2.2 SQL Connection Settings .............................................................................................................5


4

This chapter describes the preparation for installing this product.

2.1 Construction of a Database ServerIt is required to install SQLServer before installing this product.

For details about the method of installation, see the manual of SQLServer.

- Do not use "MSSQLServer" as an instance name.

- This product can be used together with the instance that is used by MasterScope Virtual DataCenterAutomation.

2.2 SQL Connection SettingsAfter installing SQLServer, perform the following connection settings.

1. Start the SQLServer configuration manager.

2. Select [SQL Server Configuration Manager] and then Protocols for[Instance name].

Figure 2-1 Selecting Instance Name

3. Right-click [TCP/IP] displayed on the right frame, and then select [Enable] from the displayedpop-up menu.


5

Figure 2-2 Enabling TCP/IP

4. Right-click [TCP/IP], and open [Property] to display the [IP Address] type. Enable [127.0.0.1].

Figure 2-3 TCP/IP Property

5. Select [IP All] to specify the TCP port (1433 is set by default) that is used by SQLServer.


6

Figure 2-4 Specifying the TCP Port

6. Click [OK] to close the screen.

7. Execute the batch file for DB setting.

The batch file is stored in the following location:

Installation DVD: \fw\Windows\Product\Portal

Move from the command prompt to the current directory described above, and follow theprocedure below to execute the commands. In this case, select the appropriate file name asneeded.

Execute SetupDB_MSSQL_2008.bat in the case of SQL Server 2008 R2 while executeSetupDB_MSSQL2012.bat and SetupDB_MSSQL2014.bat in the cases of SQL Server2012and SQL Server2014, respectively.

Installation DVD: \fw\Windows\Product\Portal>SetupDB_MSSQL2014.bat [Instancename]

[Execution example] * When the DVD drive is drive D

D:\fw\Windows\Product\Portal>SetupDB_MSSQL2014.bat FWCMDB

NoteIf global management server function(GM) has been installed, the following services will be stoppedwhen batch file for database setting is executed as described above and it should be restarted asmanually.*NvPRO ResourceManagerAPI Service*NvPRO Base Manager*WebSAM UMF Operations Manager_10X (Note: "X" value may be different and to be replaced inaccordance with actual installation environment.


7

Chapter 3. Installation

Contents3.1 Executing Installation...................................................................................................................9

3.2 Installation Method in the Case of Redundancy .........................................................................12


8

This chapter describes the method of installing Portal.

Note that this document uses the "C:\Program Files (x86)\NEC\vDCA\GM" directory as aninstallation destination directory.

If installing a portal in the directory other than that described above, replace terms in the text asappropriate.

3.1 Executing InstallationThe Portal is included in the global management server function.This step is not required if Installingthe components of Global Management Server in MasterScope Virtual DataCenter AutomationInstallation Guide have been conducted.

Use the MasterScope Virtual DataCenter Automation Integrated Installer to install the portal.

The method of installing the portal is described below.

1. Execute the following command on the command prompt or Explorer to start the MasterScopeVirtual DataCenter Automation Integrated Installer.

Installation DVD: \install\Windows\vDCAInst.exe

2. Select [Typical], and click the [Next] button.

3. The "Selection of Functions" screen is displayed. Check the [Global Manager] check box, andclick [Next].


9

4. The "Setting of GlobalManager" screen is displayed. Select the item below, and click [Next].

* Follow the description of the MasterScope Virtual DataCenter Automation Installation Guidefor the items other than those below.

Table 3-1 Setting Item List (Global management server setting)

Item name Description

Application server setting - HTTPport

The TCP port that is used by the ServiceGovernor and a portal (12080is set by default.)


10


Application server setting -HTTPS port


Tomcat setting - Management port The port that is used for the application server management within theproduct (12005 is set by default.)

Tomcat setting - AJP/1.3 port The port that is used for the application server management within theproduct (12009 is set by default.)

Portal setting - Host name of SQLServer

Enter the host name of SQLServer (localhost is set by default).

Portal setting - Instance name ofSQL Server

Specify the instance name of SQL Server that is created in"2.1 Construction of a Database Server (page 5)".

Portal setting - Port number ofSQL Server

The TCP port number that is used by SQLServer (1433 is set bydefault).

5. "The installation setting is as follows" screen is displayed. Check the contents, and then clickthe [Start] button.

6. The installation execution confirmation dialog box is displayed. Click the [Yes] button.

7. When the installation is complete, the "Installation result" screen is displayed. Click the[Finish] button.


11

3.2 Installation Method in the Case ofRedundancy

Normally, the global management server and a portal are installed together. However, a portal can beinstalled on separate machines for redundant configuration.

The method of installing a portal separately from the global management server is described below:



2. Select [Custom], and click [Next].


12

3. "The Select the product" screen is displayed. Select [MasterScopeMedia], and click [Run].


13

4. "The MasterScope Framework Media Installer" screen is displayed. Check that [Install] isselected, and click the [Next >] button.


14

5. "The Selection of Functions" screen is displayed. Check the [Application Server] check boxand the [MasterScope Virtual DataCenter Automation Portal] check box, and click the [Next]button.


15

6. "The Setting of install" screen is displayed. Select the item below, and click the [Next] button.


16

Table 3-2 Details about the Application Server Setting


Application server setting - HTTPport


Application server setting -HTTPS port


Table 3-3 Details about the MasterScope Virtual DataCenter Automation Portal Setting


Host name or IP address of DBServer

Enter the host name of SQLServer(localhost is set by default).

Instance name of DB Specify the instance name of SQL Server that is created in"2.1 Construction of a Database Server (page 5)".

Port Number of DB Port Number that is used by SQLServer (1433 is set by default).

7. "The installation setting is as follows" screen is displayed. Click the [Start] button.


17

8. After the installation, the [Finish] screen is displayed. Click the [Finish] button.


18

Chapter 4. Settings of the Connection withServiceGovernor WebAPI Base Option

Contents4.1 Connection Settings ...................................................................................................................20

4.2 Acquiring and Setting of the MasterScope Virtual DataCenter Automation API Key.................20

Chapter 4. Settings of the Connection with ServiceGovernor WebAPI Base Option

19

Portal uses the APIs of ServiceGovernor WebAPI Base Option (referred to as ServiceGovernor in theremainder of document).

This chapter describes the connection settings.

Make the settings after installing Portal.

4.1 Connection SettingsOpen the file and edit it with the reference to the description below.

product.cloudportal.provider.base.url= Protocol (http or https)\://Host name of the globalmanagement server\:Port number of the application server

product.cloudportal.service.monitoring.provider.webapibase.base.url=Protocol (http or https)\://Host name of the global management server\:Port number of the application server

Port number of the application server>>>"Table 3-1 Setting Item List (Global managementserver setting) (page 10)"

Setting example

product.cloudportal.provider.base.url=http\://localhost\:12080product.cloudportal.service.monitoring.provider.webapibase.base.url=http\://localhost\:12080

NoteSpecify the host name and port number of the ServiceGovernor when the ServiceGovernor is installed inanother host.

4.2 Acquiring and Setting of the MasterScopeVirtual DataCenter Automation API Key

1. Refer to Setting up the ServiceGovernor in the MasterScope Virtual DataCenter AutomationInstallation Guide, and take a note of the AccessKeyId and SecretAccessKey value.

2. Set the value that is taken on a note in step 1 for the setting file below.

Open the file; C:\Program Files (x86)\NEC\vDCA\GM (Installation destination directory for aportal)\FW\Tomcat\conf\NEC\webframework.properties,

* Escape ":" and "=" by adding "\" to them.

Table 4-1 Setting

Configuration file key Value

product.cloudportal.provider.vdc.access.key.id AccessKeyId that is taken on anote in step 1

product.cloudportal.provider.vdc.secret.access.key SecretAccessKey that is taken on anote in step 1

product.cloudportal.service.monitoring.provider.webapibase.access.key.id

AccessKeyId that is taken on anote in step 1

product.cloudportal.service.monitoring.provider.webapibase.secret.access.key

SecretAccessKey that is taken on anote in step 1

Setting example


20

product.cloudportal.provider.vdc.access.key.id=collected AccessKeyIdproduct.cloudportal.provider.vdc.secret.access.key=collected SecretAccessKeyproduct.cloudportal.service.monitoring.provider.webapibase.access.key.id=collected AccessKeyIdproduct.cloudportal.service.monitoring.provider.webapibase.secret.access.key=collected SecretAccessKey

After the completion of the above setting, restart "Apache Tomcat 8.0 ServiceGovernor" fromthe service list.

Figure 4-1 Services Screen


21

Chapter 5. Setting after the Installation

Contents5.1 Permission for Connection Using the Listening Port Number ....................................................23

5.2 Timezone Setting .......................................................................................................................24

5.3 Disk Tag Setting.........................................................................................................................25

5.4 Application Server (Tomcat) Setting ..........................................................................................27


22

This chapter describes the settings after the installation.

5.1 Permission for Connection Using theListening Port Number

To display the Portal screen, permit connection using the number of the listening port that wasspecified for the Web server (Tomcat) in the firewall settings of Windows at the time of itsinstallation.

1. Open [Control Panel] - [Windows Firewall] and then select [Advanced].

The detail setting screen is displayed. Select [Inbound Rules] and then select [New Rule] from[Actions].

Figure 5-1 Firewall Detail Setting Screen

2. Make settings by referring to the table below and according to the instructions of the wizard.


23

Figure 5-2 New Inbound Rule Wizard

Table 5-1 Setting Items (New Inbound Rule Wizard)


Rule Type Port

Protocol TCP

Port Describe the application server port number that is set in "Table3-1 Setting Item List (Global management server setting) (page 10)".

Action Permit connection.

Profile From [Domain], [Public], and [Private], select a profile of the networkthat will be used to establish connection to Portal from the outside.

Name Any name

5.2 Timezone SettingSet default values for the timezone that will be specified in a server creation request.

The setting method is shown below.

Open C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat¥conf¥NEC¥webframework.propertiesand edit the following item.

Table 5-2 Item List (Timezone Setting)

Setting item Initial value Description

product.cloudportal.request.timezone 55(GMT Standard Time) Specify default values for thetimezone that will be designated in aserver creation request.Specify a hexadecimal value.


24

Setting item Initial value DescriptionSelect from a list of valid timezones.

[Specification example]

product.cloudportal.request.timezone=EB

When reducing choices of timezones or changing their display names, open "C:\Program Files(x86)\NEC\vDCA\Tomcat\conf\NEC\timezones.json" and make a setting by referring to thefollowing:

"id": "id-number", "name": "display-name"


{"timezones" :[{"id": "1", "name": "Samoa standard time"},{"id": "2", "name": "Hawaii standard time"}, ...{"id": "EB", "name": "Tokyo (standard time)"},{"id": "80000050", "name": "UTC"}]}

After specifying the above, save the file with UTF8 selected as its character code and restart theapplication server (Tomcat). From the left-side panel of the server manager, select the local serverfrom [Services], right-click [Apache Tomcat 8.0 ServiceGovernor], and select [Restart Service].

NoteDo not delete the first comment line of the webframework.properties file.

5.3 Disk Tag SettingMake the settings of the disk tag that will be used for catalogs.

Copy "C:\Program Files (x86)\NEC\vDCA\Tomcat\conf\NEC\diskTags.sample" into a location underthe same directory and rename it to "diskTags.json".

Open the renamed file and edit it by referring to the following.

Set the name of a tag that will be displayed on the screen, a data store tag (basic tag set for SSC)associated as information on the displayed tag, and a disk type.

Table 5-3 Item List (Disk Tag Setting)

Item name Input rules Description

tags - Array in which tag information to bedisplayed on the input screen hasbeen set

name 1 to 64 charactersMust be unique in a system.Multibyte characters can be used.

Tag name (indicating taginformation) that will be displayed asa tag

diskType Specify one of the following:- thin- thick- raw_physical

Specify a disk type that will be setfor the tag.


25

Item name Input rules Description- raw_virtual

datastoreTags Data store tag that has been set forSSC

Specify a data store tag that will beassociated with the tag (multiple datastore tags can be specified).


{ "tags":[ { "name":"gold-disk", "diskType":"thick", "datastoreTags":[ "gold", "silver" ] }, { "name":"silver-disk", "diskType":"thin", "datastoreTags":[ "silver", "bronze" ] }, { "name":"bronze-disk", "diskType":"thin", "datastoreTags": [ "bronze" ] } ]}

Next, specify tags that will be associated with catalogs.

Table 5-4 Item List (Disk Tag Setting)

Item name Input rules Description

catalogs - Array of catalogs in which taginformation to be associated has beenset

name VM template name registered inSigmaSystemCenter

Name of a catalog with which a tagwill be associated

tags 1 to 64 charactersMust be unique in a system.Multibyte characters can be used.

Specify a disk type that will be setfor the tag.


{ "catalogs":[ { "name":"catalog1",


26

"tags":[ "gold-disk", "silver-disk" ] }, { "name":"catalog2", "tags": [ "gold-disk", "silver-disk", "bronze-disk" ] } ]}

product.cloudportal.disk.tags.json=Path after change


product.cloudportal.disk.tags.json=C:\tmp\diskTags_updated.json

After the modification, save the file with UTF8 (without a BOM) selected as its character code andthen restart the application server (Tomcat).

Select the local server from the panel in the left of the server manager, right-click [Apache Tomcat8.0 ServiceGovernor] in the services, and then, select [Restart Service].

5.4 Application Server (Tomcat) Setting• Memory

The following describes how to set the upper memory limit for the application server (Tomcat).

1. Execute the following command on the machine on which the application server(Tomcat) is installed.

C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\bin\tomcat8w.exe //ES//ServiceGovernor

2. Set Maximum memory pool.


27

Figure 5-3 Tomcat properties

3. After making this setting, restart the application server (Tomcat).

• Number of threads

The following describes how to set the upper number-of-threads limit for the application server(Tomcat).

1. Open a text editor on the machine on which the application server (Tomcat) is installedand edit the following file.

C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\server.xml

2. Set maxThreads.


28



• Number of connections

The following describes how to set the upper number-of-connections limit for the applicationserver (Tomcat).

1. Open a text editor on the machine on which the application server (Tomcat) is installedand edit the following file.

C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\server.xml

2. Set maxConnections.




29

Chapter 6. Connecting to PortalFollow the procedure below to check the connection.

1. Access the following URL from a browser.

http://hose name of the global management server: port(12080 is set by default)/portal/

https://hose name of the global management server: port(12443 is set by default)/portal/

2. Check that the login screen is displayed.

Chapter 6. Connecting to Portal

30

Chapter 7. Cluster Constructing

Contents7.1 Managing the configuration files................................................................................................32

7.2 Configuring a cluster shared disk ...............................................................................................32

7.3 Positioning and Modifying the SQL Scripts ...............................................................................33

7.4 Moving a Database File..............................................................................................................33

7.5 Detaching a database file............................................................................................................34


31

For configuring a portal on cluster construction, please refer to "MasterScope Virtual DataCenterAutomation Cluster Configuration Guide For Windows/EXPRESSCLUSTER X", and configure theGlobal Management Server as cluster.

At that time, in order to configure clusters for the database of portal, please add the setting and theprocedure described at this chapter.

NoteThe configuration steps described in "Chapter 2. Preparation (page 4)" to "5.1 Permission for ConnectionUsing the Listening Port Number (page 23)" should be conducted for both the active and standby servers. Ifthe steps described in "MasterScope Virtual DataCenter Automation Cluster Configuration Guide ForWindows/EXPRESSCLUSTER X" have been conducted, cluster service should be stopped beforeconducting setting of a shift.

7.1 Managing the configuration filesIf the portal is used in a redundant or cluster configuration, the following configuration files aremanaged on both the active and standby servers.

Therefore, when changing the contents of a configuration file, it is necessary to change it for both theactive and standby servers. Some files can be managed on both the active and standby servers byplacing them in a cluster shared folder.

In the following description, the installation path is described as C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW. Read the installation path as appropriate according to the setting at the time ofinstallation.

Table 7-1 Configuration Files Required to Be Set Up and Managed on Both Servers

Configuration file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat¥conf¥NEC¥webframework.properties

Disk tag configuration file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\diskTags.json

Time zone configuration file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\timezones.json

User-defined CSS file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\userdefined.css

External link configuration file forcustomization (Optional)

C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\extlinks.json

Icons for customization (Optional) C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\webapps\images\***

Widget option file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\widgets.properties

Default widget configuration file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\default_widget.properties

Linkage region configuration file C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat\conf\NEC\region.properties

7.2 Configuring a cluster shared diskFor a cluster configuration, the disk that was configured by using the "Configuring the shared disk/mirror disk" procedure in the SigmaSystemCenter cluster construction procedure must be describedin webframework.properties.


32

Open C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat¥conf¥NEC¥webframework.properties. Add the target shared disk to webframework.properties by referring tothe following example.

product.cloudportal.file.save.path=Path of shared disk/mirror disk

(Setting example)

product.cloudportal.file.save.path=S:\\Portal\\

NoteEscape \(backslash) in complete path with \.

7.3 Positioning and Modifying the SQL ScriptsAt the procedure "Positioning and Modifying the SQL Scripts" of a Global Management Server, addthe setting for clustering the database of a portal to the SQL Scripts of database clustering.

In this document, the path that SQL scripts are stored to is referred to as "C:\MSSQL", the path thatdatabase files are stored to is referred to as "S:\MSSQL\Data".

C:\MSSQL\ACT.sql

EXEC sp_attach_db 'cloudportal',@filename1 = 'S:\MSSQL\Data\cloudportal.mdf',@filename2 = 'S:\MSSQL\Data\cloudportal_log.ldf'

C:\MSSQL\ACT2.sql

use cloudportalEXEC sp_change_users_login 'Auto_Fix', 'cpuser', NULL, 'P@ssw0rd'EXEC sp_password NULL, 'P@ssw0rd', 'cpuser'

C:\MSSQL\DEACT.sql

ALTER DATABASE cloudportal SET OFFLINE WITH ROLLBACK IMMEDIATE EXECsp_detach_db 'cloudportal', TRUE

7.4 Moving a Database FileAt the procedure "Moving a Database File" of a Global Management Server, move the database fileof a portal in addition to the database file of management function (GM_<Global management servername>). If the instance name FWCMDB is in use, the default value of the path in which the sourcedatabase file is stored is as follows.

C:\Program Files\Microsoft SQL Server\MSSQL12.FWCMDB\MSSQL\DATA

Table 7-2 Setting item

File Name Destination

cloudportal.mdf S:\MSSQL\Data\cloudportal.mdf

cloudportal_log.ldf S:\MSSQL\Data\cloudportal_log.ldf


33

7.5 Detaching a database fileTo move a database file to a shared disk, perform the detach processing on an active host.

Open the command prompt and execute the following commands.

1. Start the command prompt and execute the following command:

sqlcmd -E -S "(local)\FWCMDB"

2. Execute the following query to detach a database file of Portal.

1> alter database cloudportal set offline with ROLLBACK IMMEDIATE2> exec sp_detach_db 'cloudportal',TRUE3> go

7.5.1 Moving a database fileAfter the detach processing is complete, move the database file onto the shared disk. If the instancename FWCMDB is in use, the default value of the path in which the source database file is stored isas follows.

C:\Program Files\Microsoft SQL Server\MSSQL12.FWCMDB\MSSQL\DATA

Table 7-3 Setting Items

File name Move to

cloudportal.mdf S:\MSSQL\Data\cloudportal.mdf

cloudportal_log.ldf S:\MSSQL\Data\cloudportal_log.ldf

7.5.2 Attaching a database fileIf the cluster is suspended, this step is not required. Also, if the cluster is restarted after executing"7.5.1 Moving a database file (page 34)", this step is not required..

1. Start the command prompt and execute the following command.


2. Execute the following query to detach the Portal database file.

1> EXEC sp_attach_db 'cloudportal', @filename1='S:\MSSQL\Data\cloudportal.mdf', @filename2='S:\MSSQL\Data\cloudportal_log.ldf' (Describe the command on one line.)2> go

7.5.3 Re-creating database usersThis step is not required if the cluster is suspended. Also, if the cluster is restarted after executing"7.5.1 Moving a database file (page 34)", this step is not required.

1. Start the command prompt and execute the following command:


2. Execute the following query to detach a database file of Portal.


34

1> use cloudportal2> EXEC sp_change_users_login 'Auto_Fix', 'cpuser', NULL, 'P@ssw0rd'3> EXEC sp_password NULL, 'P@ssw0rd', 'cpuser'4> go


35

Chapter 8. Upgrading

Contents8.1 Executing Version Up Installation ..............................................................................................37

8.2 Configuration after Version Up ..................................................................................................37


36

This chapter describes the upgrading method.

NoteCancel any unapproved requests created before upgrading and make reapplications after upgrading.

8.1 Executing Version Up Installation1. Delete C:\Program Files (x86)\NEC\vDCA\Tomcat\webapps\portal.

2. For details about the upgrading, see "Upgrading" of MasterScope Virtual DataCenterAutomation Installation Guide.

8.2 Configuration after Version UpExecute the following steps after version up installation.

1. Rename C:¥Program Files (x86)¥NEC¥vDCA¥GM¥FW¥Tomcat¥conf¥NEC¥webframework.propertiesto any name and copy the changes (e.g. catalog name) towebframework.properties.sample.

2. Rename webframework.properties.sample to webframework.properties.

3. Configure each setting with reference to "Chapter 5. Setting after the Installation (page 22)".

4. Start the application server (Tomcat). Select Local Server from left panel in Server Manager,and right click [Apache Tomcat 8.0 ServiceGovernor] from Service, then select [StartServices].

5. Delete browser cache.

6. Start the Web browser, and access the following URL.

http://hose name of the global management server: port(12080 is set by default)/portal/

https://hose name of the global management server: port(12443 is set by default)/portal/

7. Check the footer in login page that version was updated.


37

Chapter 9. Uninstallation

Contents9.1 Executing Uninstallation ............................................................................................................39

9.2 Deleting Database ......................................................................................................................44

9.3 Deleting Attachment Files..........................................................................................................44


38

This chapter describes the uninstallation method.

9.1 Executing UninstallationIf the portal was installed by MasterScope Virtual DataCenter Automation Integrated Installer, theportal will be deleted by uninstalling the global management serve in accordance with MasterScopeVirtual DataCenter Automation Installation Guide. The portal can not be uninstalled as itself only.This section indicates uninstallation steps for the portal which is installed in accordance with"3.2 Installation Method in the Case of Redundancy (page 12)"



2. Select [Custom], and click [Next].

3. "The Select the product" screen is displayed. Select [The MasterScope Framework MediaInstaller], and click [Run].


39

4. The "MasterScope Media Installer" screen is displayed. Select [Uninstall], and then click[Next].


40

5. The Uninstallation Selection dialog box is displayed. Check the [MasterScope VirtualDataCenter Automation Portal] check box (however, it is optional for Application Server),click [Next].


41

6. The Uninstallation Confirmation screen is displayed. Click the [Start] button.


42

7. After completing the uninstallation, the [Finish] dialog box is displayed. Click the [Finish]button.


43

9.2 Deleting DatabaseIf a database is unnecessary, delete it by applying the following procedure.

Open the command prompt window and execute the following commands.

C:\Users\Administrator>sqlcmd -E -S localhost\DB-instance-name1> drop database cloudportal2> go1> drop login cpuser2> go1> exit

Example: The DB instance name is FWCMDB (default).

C:\Users\Administrator>sqlcmd -E -S localhost\FWCMDB1> drop database cloudportal2> go1> drop login cpuser2> go1> exit

9.3 Deleting Attachment FilesAt default settings, attachment files are saved to the following path.

C:\Program Files (x86)\NEC\vDCA\GM\FW\Tomcat\cloudportal

Those files are deleted when uninstalling a Global Management Server or a ApplicationServer, butare not deleted when uninstalling a portal only. Therefore, please delete manually.

Also in the case setting the path of shared disk by "MasterScope Virtual DataCenter AutomationCluster Configuration Guide For Windows/EXPRESSCLUSTER X - Setting Up the Shared andMirror Disks", the files are not deleted. Therefore, please delete manually.


44

MasterScope Virtual DataCenter Automation ver5.0Portal User Manual(Installation Guide)

April, 2018 1st Edition

NEC Corporation

©NEC Corporation 2012-2018

Portal User Manual(Installation Guide) · Execute SetupDB_MSSQL_2008.bat in the case of SQL Server...

Documents

Transcript of Portal User Manual(Installation Guide) · Execute SetupDB_MSSQL_2008.bat in the case of SQL Server...