nec sigmasystemcenter 3.6 ssc command reference · contents chapter 1. about ssc command ..... 1...

298
SigmaSystemCenter 3.6 ssc Command Reference SSC0306-doc-0037

Upload: others

Post on 20-Aug-2020

15 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

SigmaSystemCenter 3.6ssc Command Reference

SSC0306-doc-0037

Page 2: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Disclaimer of WarrantyAll the information, text, graphics, links or other items contained within this document is provided bycopyright law.

All Rights Reserved. No part of this document may be reproduced or transmitted without permissionof NEC.

NEC may make changes to this document, at any time without notice.

NEC assumes no responsibility for errors or omissions in this document.

THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHEREXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIESOF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.

NEC does not warrant the accuracy or completeness of this document.

Trademark Information• NEC SigmaSystemCenter, SigmaSystemCenter, MasterScope, EXPRESSCLUSTER,

SIGMABLADE and ProgrammableFlow are either registered trademarks or trademarks of NECCorporation in the United States and/or other countries.

• ESMPRO is a registered trademark or trademark of NEC Corporation in Japan and othercountries.

• Microsoft, Windows, Windows Server, Windows Vista, Internet Explorer, SQL Server, andHyper-V are registered trademarks of Microsoft Corporation in the United States and othercountries.

• Linux is a registered trademark or trademark of Linus Torvalds in the U.S. and/or othercountries.

• Red Hat is a registered trademark or trademark of Red Hat, Inc. in the U.S. and/or othercountries.

• Intel, and Itanium are trademarks of Intel Corporation in the U.S. and/or other countries.

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

• NetApp, Data ONTAP, FilerView, MultiStore, vFiler, Snapshot and FlexVol are trademarks orregistered trademarks of NetApp, Inc. in the United States and/or other countries.

Other names and brands used in this document may be registered trademarks or trademarks of theirrespective owners.

Note that (R) and TM marks are not indicated in this document.

i SigmaSystemCenter 3.5 ssc Command Reference

Page 3: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ContentsChapter 1. About ssc Command................................................................................................. 1

1.1 ssc Command........................................................................................................................21.1.1 Conditions to Use ssc Commands and Supplementary Information.............................91.1.2 Symbols ....................................................................................................................101.1.3 Common Options ......................................................................................................101.1.4 Return Values of ssc Command .................................................................................111.1.5 About Path and GroupPath Specification ..................................................................111.1.6 OS Lists and Time zones ...........................................................................................131.1.7 Performance Data and Metric IDs .............................................................................161.1.8 Controllers and Location Data for Each Virtualization Infrastructure Product ...........191.1.9 Caution Notes of ssc Command ................................................................................20

Chapter 2. Command for Setup................................................................................................ 212.1 License................................................................................................................................22

2.1.1 Adding License .........................................................................................................222.1.2 Deleting License .......................................................................................................222.1.3 Displaying Licenses ..................................................................................................22

2.2 User ....................................................................................................................................232.2.1 Creating User Account ..............................................................................................232.2.2 Deleting User Account ..............................................................................................232.2.3 Displaying User Account ..........................................................................................242.2.4 Changing User Account Password ............................................................................242.2.5 Acquiring User Account and Group ..........................................................................25

2.3 Environment Setting ...........................................................................................................262.3.1 Updating Environment Setting ..................................................................................262.3.2 Start Up Collecting Setting........................................................................................28

2.4 Subsystem...........................................................................................................................292.4.1 Adding Subsystem ....................................................................................................29

2.5 Collect.................................................................................................................................302.5.1 Collecting Information ..............................................................................................30

2.6 Machine ..............................................................................................................................312.6.1 Registering Machine .................................................................................................312.6.2 Unregistering Machine ..............................................................................................322.6.3 Allocating Machine, Registering Master Machine, or Adding Machine to Pool ........332.6.4 Releasing or Deleting From Pool ..............................................................................342.6.5 Displaying Machine ..................................................................................................372.6.6 Updating Machine .....................................................................................................412.6.7 Control of Power to the Machine...............................................................................442.6.8 Backup ......................................................................................................................452.6.9 Restore ......................................................................................................................462.6.10 Registering Hardware..............................................................................................472.6.11 Operation of Maintenance to the Machine ...............................................................482.6.12 Configuration Change to the Machine .....................................................................49

ii SigmaSystemCenter 3.5 ssc Command Reference

Page 4: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.6.13 Search for a Machine...............................................................................................502.6.14 Displays Machine Status and Machine Place History ..............................................50

2.7 Machine Account ................................................................................................................512.7.1 Creating Machine Account ........................................................................................512.7.2 Updating Machine Account .......................................................................................522.7.3 Deleting Machine Account ........................................................................................532.7.4 Displaying Machine Account ....................................................................................53

2.8 Group..................................................................................................................................552.8.1 Creating Group..........................................................................................................552.8.2 Updating Group Setting.............................................................................................592.8.3 Deleting Group..........................................................................................................632.8.4 Displaying Group Setting ..........................................................................................642.8.5 Setting Machine Profile .............................................................................................642.8.6 Setting Host Profile ...................................................................................................702.8.7 Replacing Machine....................................................................................................742.8.8 Executing ScaleIn .....................................................................................................752.8.9 Executing ScaleOut ...................................................................................................752.8.10 Notifying a Tree of the Specified Group to DPM ....................................................75

2.9 Host ....................................................................................................................................762.9.1 Creating Host ............................................................................................................762.9.2 Updating Host ...........................................................................................................772.9.3 Deleting Host ............................................................................................................792.9.4 Displaying Host Definition........................................................................................792.9.5 Creating Dependency Setting for Hosts .....................................................................802.9.6 Deleting Dependency Setting for Hosts .....................................................................812.9.7 Updating Dependency Setting for Hosts ....................................................................812.9.8 Displaying Dependency Setting for Hosts .................................................................822.9.9 Adding Dependency Between Hosts .........................................................................822.9.10 Deleting Dependency Between Hosts ......................................................................822.9.11 Displaying Dependency Between Hosts ..................................................................83

2.10 IP Address.........................................................................................................................832.10.1 Adding IP Address Information...............................................................................832.10.2 Deleting IP Address Information .............................................................................84

2.11 Software ............................................................................................................................852.11.1 Adding Software .....................................................................................................852.11.2 Deploying Software.................................................................................................862.11.3 Deleting Software....................................................................................................892.11.4 Displaying Software Information ............................................................................902.11.5 Create Logical Software ..........................................................................................902.11.6 Delete Logical Software ..........................................................................................912.11.7 Show Logical Software Information ........................................................................912.11.8 Add the Software to the Logical Software ...............................................................922.11.9 Delete the Software from the Logical Software .......................................................92

2.12 Storage ..............................................................................................................................932.12.1 Adding Storage .......................................................................................................932.12.2 Deleting Storage......................................................................................................95

iii SigmaSystemCenter 3.5 ssc Command Reference

Page 5: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.12.3 Updating Disk Array ...............................................................................................952.12.4 Displaying Disk Array Path.....................................................................................962.12.5 Displaying Disk Array.............................................................................................992.12.6 Setting HBA..........................................................................................................1012.12.7 Releasing HBA .....................................................................................................1012.12.8 Creating Disk Volume ...........................................................................................1022.12.9 Updating Disk Volume ..........................................................................................1052.12.10 Deleting Disk Volume .........................................................................................1072.12.11 Assigning Disk Volume .......................................................................................1082.12.12 Releasing Disk Volume .......................................................................................1092.12.13 Displaying Disk Volume......................................................................................1112.12.14 Updating Storage Pool.........................................................................................1142.12.15 Displaying Storage Pool ......................................................................................1152.12.16 Updating the Use or the Status of the RDM Disk ................................................1192.12.17 Displaying Information of Disk for RDM............................................................1212.12.18 Displaying Storage Topology ..............................................................................121

2.13 Network ..........................................................................................................................1232.13.1 Creating VLAN .....................................................................................................1232.13.2 Deleting VLAN .....................................................................................................1232.13.3 Displaying VLAN .................................................................................................1242.13.4 Creating Port Group ..............................................................................................1242.13.5 Updating Port Group .............................................................................................1252.13.6 Deleting Port Group ..............................................................................................1272.13.7 Displaying Port Group...........................................................................................1282.13.8 Creating Private VLAN .........................................................................................1292.13.9 Updating Private VLAN........................................................................................1292.13.10 Deleting Private VLAN .......................................................................................1302.13.11 Displaying VXLAN ............................................................................................1312.13.12 Displaying VTN ..................................................................................................1312.13.13 Creating Firewall Profile .....................................................................................1312.13.14 Deleting Firewall Profile .....................................................................................1322.13.15 Displaying Firewall Profile .................................................................................1322.13.16 Adding Filtering Rule..........................................................................................1322.13.17 Creating Network Definition ...............................................................................1332.13.18 Applying Network Definition ..............................................................................1342.13.19 Deleting Network Definition ...............................................................................1342.13.20 Displaying Network Definition ...........................................................................1342.13.21 Adding VLAN(Port Group) Definition to a Network ..........................................1352.13.22 Deleting VLAN (Port Group) Definition from the Network ................................1352.13.23 Adding Address Pool to a Network .....................................................................1362.13.24 Deleting Address Pool from the Network ............................................................1372.13.25 Adding Static Route Setting to a Network ...........................................................1372.13.26 Deleting Static Route Setting from the Network ..................................................1382.13.27 Adding Firewall Setting to a Network .................................................................1382.13.28 Deleting Firewall Setting from the Network ........................................................1392.13.29 Adding Virtual Bridge Definition to a Network ...................................................1392.13.30 Deleting Virtual Bridge Definition from the Network..........................................140

iv SigmaSystemCenter 3.5 ssc Command Reference

Page 6: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.13.31 Adding Virtual Router Definition to a Network ...................................................1402.13.32 Deleting Virtual Router Definition from the Network..........................................1412.13.33 Adding Interface to a Virtual Router Definition...................................................1412.13.34 Deleting Interface from the Virtual Router Definition .........................................1422.13.35 Adding Static Routing to a Virtual Router Definition ..........................................1422.13.36 Deleting Static Routing from the Virtual Router Definition.................................1432.13.37 Adding Network Setting ......................................................................................1432.13.38 Deleting Network Setting ....................................................................................1442.13.39 Deleting Virtual Network Resource .....................................................................144

2.14 Load Balancer .................................................................................................................1452.14.1 Adding Load Balancer...........................................................................................1452.14.2 Deleting Load Balancer .........................................................................................1452.14.3 Displaying Load Balancer Information..................................................................1462.14.4 Adding Load Balancer Group................................................................................1462.14.5 Deleting Load Balancer Group ..............................................................................147

2.15 Logical Machine .............................................................................................................1482.15.1 Making Logical Machine ......................................................................................1482.15.2 Dissociating Logical Machine ...............................................................................1482.15.3 Displaying Logical Machine Information ..............................................................1492.15.4 Creating Logical Machine Account .......................................................................1522.15.5 Updating Logical Machine Account ......................................................................1522.15.6 Deleting Logical Machine Account .......................................................................1532.15.7 Displaying Logical Machine Account Information................................................1542.15.8 Creating Logical Machine Profile..........................................................................1552.15.9 Updating Logical Machine Profile.........................................................................1552.15.10 Deleting Logical Machine Profile........................................................................156

2.16 Smart Group....................................................................................................................1562.16.1 Creating Smart Group ...........................................................................................1562.16.2 Deleting Smart Group ...........................................................................................1652.16.3 Displaying Smart Group Properties .......................................................................1662.16.4 Exporting Smart Group Settings ............................................................................1672.16.5 Importing Smart Group Settings ............................................................................168

2.17 Profile .............................................................................................................................1692.17.1 Creating a Performance Monitoring Profile ...........................................................1692.17.2 Updating the Profile Settings for Performance Monitoring....................................1712.17.3 Deleting a Performance Monitoring Profile ...........................................................1722.17.4 Displaying the Performance Monitoring Profile Settings.......................................1722.17.5 Setting a Performance Monitoring Profile to a Group (Group/Model) ...................1752.17.6 Creating a Named Host Profile..............................................................................1762.17.7 Creating a Named Machine Profile........................................................................1792.17.8 Displaying the Machine Profile .............................................................................1842.17.9 Exporting Monitoring Profile ................................................................................1862.17.10 Importing Monitoring Profile ..............................................................................1862.17.11 Adding Threshold Setting to a Performance Indicator .........................................1872.17.12 Updating Threshold Setting of the Performance Indicator ...................................1882.17.13 Deleting Threshold Setting from the Performance Indicator ................................189

v SigmaSystemCenter 3.5 ssc Command Reference

Page 7: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.18 API Key ..........................................................................................................................1902.18.1 Creating API Key ..................................................................................................1902.18.2 Updating API Key .................................................................................................1902.18.3 Deleting API Key ..................................................................................................1912.18.4 Displaying API Key ..............................................................................................191

2.19 Custom Setting................................................................................................................1922.19.1 Creating Custom Setting .......................................................................................1922.19.2 Deleting Custom Setting .......................................................................................1932.19.3 Displaying Custom Setting ....................................................................................195

2.20 CIM Indication Setting....................................................................................................1962.20.1 Registering CIM Indication Setting .......................................................................1962.20.2 Unregistering CIM Indication Setting....................................................................196

2.21 Custom Object ................................................................................................................1962.21.1 Adding Custom Object ..........................................................................................1962.21.2 Updating Custom Object .......................................................................................1972.21.3 Deleting Custom Object ........................................................................................1982.21.4 Displaying Custom Object ....................................................................................1982.21.5 Adding Relate .......................................................................................................1982.21.6 Deleting Relate......................................................................................................199

2.22 External Resource ...........................................................................................................2002.22.1 Adding External Resource.....................................................................................200

Chapter 3. Command for Controlling.................................................................................... 2023.1 Operations for Datacenter .................................................................................................203

3.1.1 Adding Datacenter ..................................................................................................203

3.2 Operations for Virtual Machine Server..............................................................................2033.2.1 Adding Virtual Machine Server ...............................................................................2033.2.2 Updating Virtual Machine Server ............................................................................2043.2.3 Deleting Virtual Machine Server .............................................................................2043.2.4 Changing Password of Virtual Machine Server .......................................................2053.2.5 Post-Processing of Virtual Machine Server Recovery..............................................2053.2.6 Evacuating Machine ................................................................................................206

3.3 Operations for Virtual Machine .........................................................................................2083.3.1 Creating Virtual Machine ........................................................................................2083.3.2 Creating Virtual Machine (no OS) ...........................................................................2103.3.3 Changing Configuration of Virtual Machines ..........................................................2153.3.4 Deleting Virtual Machine ........................................................................................2223.3.5 Cloning Virtual Machine .........................................................................................2243.3.6 Moving Virtual Machine (Migrate) .........................................................................2243.3.7 Moving Virtual Machine (Move).............................................................................2253.3.8 Evacuating Machine (Host Specified) .....................................................................2263.3.9 Exporting Virtual Machine ......................................................................................2273.3.10 Importing Virtual Machine ....................................................................................2283.3.11 Creating Template .................................................................................................2283.3.12 Updating Template ................................................................................................2313.3.13 Deleting Template .................................................................................................233

vi SigmaSystemCenter 3.5 ssc Command Reference

Page 8: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.3.14 Exporting Template ...............................................................................................2343.3.15 Importing Template ...............................................................................................2343.3.16 Adding Image........................................................................................................2353.3.17 Updating Image .....................................................................................................2363.3.18 Deleting Images ....................................................................................................2363.3.19 Displaying Images.................................................................................................2373.3.20 Creating Snapshot .................................................................................................2373.3.21 Updating Snapshot ................................................................................................2383.3.22 Deleting Snapshots ................................................................................................2383.3.23 Reverting a Snapshot.............................................................................................2393.3.24 Displaying Snapshots Information.........................................................................2393.3.25 Reconfiguring Virtual Machine .............................................................................2393.3.26 Showing a Mountable ISO Image and a List of the CD / DVD Drive on the Virtual

Machine .....................................................................................................................2403.3.27 Mounting the ISO Image to a Virtual Machine ......................................................2413.3.28 Unmounting the ISO Image from a Virtual Machine .............................................241

3.4 VM Placement Rule ..........................................................................................................2423.4.1 Configuring VM Placement Rule ............................................................................2423.4.2 Releasing VM Placement Rule ................................................................................2433.4.3 Enabling VM Placement Rule .................................................................................2443.4.4 Disabling VM Placement Rule ................................................................................2453.4.5 Placement by VM Placement Rule ..........................................................................2453.4.6 Displaying VM Placement Rule ..............................................................................2453.4.7 Verifying VM Placement Rule ................................................................................2473.4.8 Creating Restriction Group......................................................................................2473.4.9 Deleting Restriction Group......................................................................................2483.4.10 Adding Member to Restriction Group ...................................................................2483.4.11 Removing Member from Restriction Group ..........................................................2493.4.12 Displaying Restriction Group ................................................................................249

3.5 Datastore...........................................................................................................................2503.5.1 Displaying Datastore ...............................................................................................2503.5.2 Creating Datastore...................................................................................................2543.5.3 Deleting Datastore...................................................................................................2543.5.4 Scanning and Updating Datastore Information ........................................................2553.5.5 Updating Datastore Settings ....................................................................................2553.5.6 Setting the Virtual Machine Creating Datastore.......................................................2563.5.7 Displaying Folder/File of Datastore.........................................................................2573.5.8 Mount Datastore......................................................................................................2573.5.9 Unmount Datastore .................................................................................................258

3.6 Resource Pool ..................................................................................................................2583.6.1 Creating Resource Pool ...........................................................................................2583.6.2 Displaying Resource Pool Information ....................................................................2593.6.3 Deleting a Resource Pool ........................................................................................2613.6.4 Configures the Setting for Monitoring of Resource Pool .........................................2613.6.5 Displays the Setting for Monitoring of Resource Pool .............................................262

3.7 Placement Information ......................................................................................................263

vii SigmaSystemCenter 3.5 ssc Command Reference

Page 9: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.7.1 Configuring Placement Information ........................................................................2633.7.2 Deleting Placement Information ..............................................................................2643.7.3 Displaying Placement Information ..........................................................................2653.7.4 Applying Placement Information.............................................................................266

3.8 Service ..............................................................................................................................2673.8.1 Displaying Service Setting ......................................................................................2673.8.2 Updating Service Setting .........................................................................................267

Chapter 4. Command for Maintenance ................................................................................. 2684.1 Operations Log .................................................................................................................269

4.1.1 Displaying Operations Log......................................................................................269

4.2 Policy................................................................................................................................2704.2.1 Exporting Policy .....................................................................................................2704.2.2 Importing Policy .....................................................................................................271

4.3 Maintenance......................................................................................................................2714.3.1 Maintaining Configuration Information...................................................................2714.3.2 Deleting Distribution History ..................................................................................2754.3.3 Updating Status of Machines...................................................................................2764.3.4 Updating Status of Devices .....................................................................................2784.3.5 Deleting Information of DPM .................................................................................2784.3.6 Encoding of data .....................................................................................................279

4.4 MachineAccessHistory......................................................................................................2794.4.1 Displaying the Detail Information of MachineAccessHistory..................................2794.4.2 Deleting MachineAccessHistory .............................................................................2804.4.3 Setting the Environment Settings of MachineAccessHistory ...................................281

4.5 Exporting (Backing up)/Importing (Restoring) of SSC Configuration Information ...........2814.5.1 Exporting (Backing up) SSC configuration Information..........................................2814.5.2 Importing (Restoring) SSC configuration Information ............................................282

4.6 Output Report ...................................................................................................................2844.6.1 Creating Report .......................................................................................................284

Index........................................................................................................................................... 285

viii SigmaSystemCenter 3.5 ssc Command Reference

Page 10: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2
Page 11: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Chapter 1. About ssc Command

Contents1.1 ssc Command...............................................................................................................................2

Chapter 1. About ssc Command

1 SigmaSystemCenter 3.5 ssc Command Reference

Page 12: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This chapter explains about the ssc commands of SigmaSystemCenter.

1.1 ssc CommandWith the ssc command line tool, you can set collectively the setting of creating

the group host and any other ones which have been required to set from Web console

individually until now by executing commands from a BAT file. This function

dramatically reduces the burden of configuring large scale environment. In addition,

some functions, including settings for configuration changes in the virtual environment,

support operations only by the ssc command.

The functional enhancement for pvmutl command, that is a former command line tool,

will not be offered in the future SigmaSystemCenter versions.

Please use the ssc command instead of it.

The ssc command provides you the following functions:

Command (Function) Subcommand Explanation

create user Creates a user account.

group * Creates a group.

host Creates a host in a group.

machine Creates virtual machines in a group.

template Creates a template in a group.

diskvolume Creates a disk volume.

datastore Creates datastore.

smartgroup * Creates or modifies a smart group.

object Creates custom objects.

report Creates a report file.

add license Adds a license.

manager Adds a subsystem.

ipaddress Adds an IP address (network) to a host in a group.

software * Adds software in a group (group or model) or a distributionpoint of a host.

storage Adds a disk volume of a disk array to a host in a group.

lb Adds a load balancer in a group.

vmserver Adds a virtual machine server in a datacenter.

update environment Sets environment settings.

group * Edits and updates settings of a group.

host Edits and updates settings of a host.

vmproperty Edits virtual machines collectively.

machine Edits and updates settings of a machine.

datastore Updates datastore settings.

Chapter 1. About ssc Command

2 SigmaSystemCenter 3.5 ssc Command Reference

Page 13: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

diskvolume Updates a disk volume.

storagepool Updates storage pool.

vmserver Edits the capacity value of a virtual machine server.

osservice Updates OS services/deamons.

diskarray * Update a diskarray.

object Change the setting of a custom object, network device and astorage device.

delete license Deletes a license.

user Deletes a user account.

vmserver Deletes a virtual machine server from a datacenter.

history Deletes old history that distributed software to the machine.

diskvolume Deletes the disk volume.

template Deletes templates.

machine Deletes virtual machines.

datastore Deletes datastore.

smartgroup Deletes a smart group.

group Deletes a tenant, category, group or model.

host Deletes host in a group.

storage Deletes storage in a group, model or host.

ipaddress Deletes IPAddress in a host.

lb Deletes LB settings in a group.

software Deletes Software in a group, model and host.

object Deletes custom objects.

collect - Collects information of a specified target.

register machine Registers a machine in a resource group or rack.

hardware Targets Hardware for the management.

unregister machine Unregisters a machine from a resource group or rack.

assign machine Executes Allocate Machine, Register Master Machine, or Add toPool.

diskvolume Assigns a disk volume to the machine.

external-resource * Assigns a resource according to an external resource structure.

set hba Sets HBA to a disk array.

profile Sets a machine profile in a group.

hostprofile Sets a host profile.

datastore-setting Sets the virtual machine creating datastore.

release(releasing assignment orreleasing from a pool)

machine Releases assignment of a machine or deletes a machine from apool.

hba Releases HBA from a disk array.

diskvolume Releases a disk volume from the machine.

Chapter 1. About ssc Command

3 SigmaSystemCenter 3.5 ssc Command Reference

Page 14: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

change-passwd - Changes a password of a user account or VM server account.

migrate(moving a virtual machine)

machine Moves (migrate) a virtual machine.

move(moving a virtual machine)

machine Moves (move) a virtual machine.

vmop(placement rule)

set-rule Sets the placement rule of virtual machines.

delete-rule Deletes the placement rule of virtual machines.

enable-rule Enables the placement rule setting of virtual machines.

disable-rule Disables the placement rule setting of virtual machines.

apply-rule Places virtual machines according to placement rule.

show-rule Displays placement rule settings of virtual machines.

verify-rule Verifies the placement rule setting of virtual machines.

create-group Creates the restriction group for VM Placement Rule feature.

delete-group Deletes the restriction group for VM Placement Rule feature.

add-member Adds member to a restriction group for VM Placement Rulefeature.

remove-member Removes member from a restriction group for VM PlacementRule feature.

show-group Displays restriction group settings for VM Placement Rulefeature.

set-position Configures the placement information for virtual machines.

delete-position Deletes the placement information for virtual machines.

show-position Displays the placement information for virtual machines.

apply-position Migrates virtual machines according to the placementinformation.

recover machine Recovers a virtual machine server.

evacuate machine Evacuates virtual machines on a virtual machine server to othervirtual machine server.

host Evacuates virtual machines on a virtual machine server to othervirtual machine server (with a host specified).

machine-account(creating, updating,deleting, and displaying)

create Creates a machine account.

update Updates a machine account.

delete Deletes a machine account.

show Displays machine account information.

export policy Exports policy information to an XML file.

smartgroup Exports smart group settings to the XML file.

template Exports a template.

vm Exports a virtual machine.

import policy Imports policy information from an XML file.

smartgroup Imports smart group settings from a XML file.

template Imports a template.

Chapter 1. About ssc Command

4 SigmaSystemCenter 3.5 ssc Command Reference

Page 15: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

vm Imports a virtual machine.

maintenance cmdb Maintains the configuration database.

machine Maintain a specified machine.

startup-collect-mode - Changes a collect mode in the stratup.

show license Displays licenses.

user Displays user account information.

group * Displays settings of a group.

host Displays settings of a host.

machine * Displays machines information.

log Displays the Operations log.

diskarraypath Displays a disk array path.

datastore Displays datastore information.

diskvolume * Displays the disk volume information.

storagepool Displays the storage pool information.

smartgroup Displays a smart group setting information.

storagetopology Displays the storage topology information.

diskarray * Displays the disk array information.

software Displays Software information.

lb Displays Lb information.

vlan Displays the information of the VLAN that have been created inthe switch.

osservice Displays OS services/deamons.

object Displays custom objects.

reconfigure machine Reconfigures virtual machines.

set-machine-status - Updates status of a machine.

deploy(deploying)

software Deploys software to the selected machines.

replace(replacing)

machine Replaces the specified machine.

power-control(power supply control)

machine Controls of power to the host running in the group or themanaged machine.

clone(cloning)

machine Clones the virtual machine.

scan(scanning)

datastore Scans and updates datastore information which connected to aVM server.

resourcepool(creating, displaying,deleting)

create Creates a Resource Pool.

show Displays resource Pool information.

delete Deletes a resource Pool.

set-monitor-setting Configures the setting for monitoring of resource pool.

Chapter 1. About ssc Command

5 SigmaSystemCenter 3.5 ssc Command Reference

Page 16: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

show-monitor-setting

Displays the setting for monitoring of resource pool.

network(creating, adding)

create Creates a network.

add-vlan Adds a VLAN (a port group) definition to the network.

add-addresspool Adds an address pool to the network.

add-virtualbridge Adds a virtual bridge definition to the network.

apply Apply the setting of the network.

delete Deletes a network.

delete-addresspool Deletes an address pool from the network.

delete-virtualbridge

Deletes a virtual bridge definition from the network.

delete-vlan Deletes a VLAN (a port group) definition from the network.

show Displays network information.

add-static-rt * Adds a static route setting to a network.

delete-static-rt * Deletes a static route setting from a network.

add-firewallsetting Adds the firewall setting to the network.

delete-firewallsetting

Deletes the firewall setting from the network.

add-router Adds a router definition to the network.

delete-router Deletes a router definition from the network.

add-router-if Adds an interface to a router definition.

delete-router-if Deletes an interface from the router definition.

add-router-rt Adds a static routing to router definition.

delete-router-rt Deletes a static routing from router definition.

changehistory(displaying, deleting,setting)

show Displays MachineAccessHistory detail information.

delete Deletes the MachineAccessHistory.

set * Sets operation settings of MachineAccessHistory.

scalein(scale in)

- Executes ScaleIn.

scaleout(scale out)

- Executes ScaleOut.

group(setting)

set-network Adds a network setting to a group.(Former name is "add vlan".)

delete-network Deletes network setting in a group.

logicalmachine(assigning, releasing,displaying etc.)

assign Makes the specified machine logical and creates an association.

release Dissociates a logical machine.

show Displays logical machines information.

create-account Creates logical machine account for a host.

update-account Updates logical machine account for a host.

delete-account Deletes logical machine account from a host.

show-account Displays logical machine account information.

Chapter 1. About ssc Command

6 SigmaSystemCenter 3.5 ssc Command Reference

Page 17: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

create-profile Creates logical machine profile for a host.

update-profile Updates logical machine profile for a host.

delete-profile Deletes logical machine profile from a host.

machine backup Backs up the machine.

restore Restores the machine.

chcfg Changes configuration for the activated machine.

dpminformation delete Deletes information of DPM.

dpm-location notify Notifies a tree of specified group to DPM.

hostprofile create Creates named host profile.

profile create Creates named machine profile.

show Displays machine profile.

rdmstorage show Displays information of disk for RDM.

update Updates the use or the status of the RDM Disk.

portgroup create Creates a port group on the specifying switch (NetworkDevice).

delete Deletes a port group on the specifying switch (NetworkDevice).

show Displays a port group list.

update Updates a port group on the specifying switch (NetworkDevice).

privatevlan create Creates a private VLAN in the target distributed virtual switch.

delete Deletes a private VLAN of the distributed virtual switch.

update Updates a private VLAN in the target distributed virtual switch.

vlan create Creates a VLAN in the switch.

delete Deletes a VLAN in the switch.

image add Adds an image.(Former name is "add image".)

delete Deletes images.

update Updates images.

show shows images (Former name is "show image").

snapshot create Creates a snapshot (Former name is "create snapshot").

update Edits a snapshot.

delete Deletes snapshots.

revert Reverts a snapshot.

show Displays snapshots information.

monitoringprofile create Creates a performance monitoring Profile.

update Updates the profile settings for performance monitoring.

delete Deletes a performance monitoring profile.

set Sets a performance monitoring profile to a group (Group/Model).

show * Displays the performance monitoring profile settings.

export Exports a performance monitoring profile.

import importS a performance monitoring profile.

Chapter 1. About ssc Command

7 SigmaSystemCenter 3.5 ssc Command Reference

Page 18: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

add-threshold * Adds a threshold setting to the performance indicator.

update-threshold * Updates a threshold setting of a performance indicator.

delete-threshold * Deletes a threshold setting from a performance indicator.

template update Updates a template.

apikey create Creates an API key.

update Updates an API key.

delete Deletes an API key.

show Displays an API key.

dependency add Adds dependency between hosts.(Former name is "dependencyset".)

delete Deletes dependency between hosts.

show Displays dependency between hosts.

create-setting Creates dependency setting for hosts.

delete-setting Deletes dependency setting for hosts.

update-setting Updates dependency setting for hosts.

show-setting Displays dependency setting for hosts.

datastorefile show Displays folder/file of datastore.

vm create Creates a virtual machine (no OS).

iso mount Mounts the ISO image to a virtual machine.

unmount Unmount the ISO image from a virtual machine.

show Show a mountable ISO image and a list of the CD / DVD driveon the virtual machine.

config-export - Exporting (Backing up) SSC configuration information.

config-import - Importing (Restoring) SSC configuration information.

firewallprofile create Creates the firewall profile.

delete Deletes the firewall profile.

add Adds a filtering rule to the firewall profile.

show Displays the list or the detail of the firewall profile.

sync ldapuser Acquires information of user account and group.

customproperty show Shows the custom setting.

add Adds the custom setting.

delete Deletes the custom setting.

mount datastore Mounts Datastore.

unmount datastore Unmounts Datastore.

vxlan show Displays the vxlan list.

vtn show Displays VTN information.

indication register Registers settings for receiving CIM Indication.

unregister Unregisters settings for receiving CIM Indication.

encrypt-string - Encodes specified data.

Chapter 1. About ssc Command

8 SigmaSystemCenter 3.5 ssc Command Reference

Page 19: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command (Function) Subcommand Explanation

search machine Search for a machine.

datacenter add Adds a data center to a virtual manager.

set-object-status - Change the status of a custom object, network device and astorage device.

add-relate object Add the relation between a custom object and the object of atarget resource.

delete-relate object Delete the relation between a custom object and the object of atarget resource.

lbgroup create * Creates a load balancer group in a load balancer or software loadbalancer.

delete Deletes a load balancer group in a load balancer or the softwareload balancer.

virtualnetwork delete Deletes a virtual network resource.

logicalsoftware create * Create logical software.

delete * Delete logical software.

show * Show logical software information.

add-software * Add the software to the logical software.

delete-software * Delete the software from the logical software.

machinehistory show * Displays Machine Status and Machine Place History.

*New commands or enhanced commands in SigmaSystemCenter 3.6.

1.1.1 Conditions to Use ssc Commands and SupplementaryInformation

The following conditions must be met to use the ssc command:

• Execute the ssc commands on a management server. Only users with administrator rights canexecute the ssc commands.

NoteIf the User Account Control, UAC, is valid, you need to execute with the Administrator mode. For example,right-click Command Prompt [the short cut of Command Prompt] and click Run as administrator to launchthe ssc commands.

• About backing up the database

The ssc command provides you various useful functions, such as configuring hosts collectively;however, if a specified command is wrong, in the case that the command is executedautomatically by BAT command without advance verification, for example, unintended settingscan be configured.

Extract backup of database in advance so that you can restore the condition of before executingthe command in such cases.

TipFor how to back up, see Chapter 10, "Backup and Restoration" in NEC SigmaSystemCenter ConfigurationGuide.

Chapter 1. About ssc Command

9 SigmaSystemCenter 3.5 ssc Command Reference

Page 20: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

1.1.2 SymbolsThe following symbols are used in the explanation of the functions of ssc commands.

• [ ] (brackets) indicate optional items.

• | (vertical line) is a separator indicating that you can select either of the separated items.

• <> is an option that you need to specify.

• () indicate abbreviated style.

For example, in case of "-error (-e)" ,-e is an abbreviated style.

1.1.3 Common OptionsThe following options can be used commonly in the ssc commands.

If you do not specify parameters when you start ssc from command line,

the system displays list of all commands.

[Syntax]

ssc [option1] [option2] command [subcommand...]

[parameter…] [cmd option [option parameter]...]

[Parameters and Options]

You can use the following options to [option1].

-v A mode to get the command to work, outputting status, such as command execution status

--verbose 〃

-q A mode to get the command to work with no message outputted(This mode is suitable for batch execution.)

--quiet 〃

-d A mode to get the command to work with debug messages outputted

--debug 〃

You can use the following options to [option2].

-h Outputs command Usage.

--help 〃

help 〃

--ver Outputs version information.

--version 〃

About command [subcommand...].

If inputted command (subcommand) doesn't exist, list of a command which narrowed down

to the parameter as a key is outputted.If there is no target command, Usage is outputted.

You can use the following options to [cmd option].

-h Outputs parameter explanation (help) for each command.

-help 〃

Chapter 1. About ssc Command

10 SigmaSystemCenter 3.5 ssc Command Reference

Page 21: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

1.1.4 Return Values of ssc CommandThe execution results of ssc commands can be determined by their return values.

Return values of ssc commands are as follows:

Values Success/Failure Causes

0 Succeeded

1 Failed Command format errors, such as insufficient parameters.

2 Failed Executed by a user without administrator authority.

3 Failed Parameter check error, such as specified resource is not found.

4 Failed Cannot update SigmaSystemCenter configuration database.

5 Failed Cannot collect the Job history of started action sequence.

6 Failed SigmaSystemCenter connection error

7 Failed Failed to run the action sequence (action sequence error).

10 Failed Other error, such as system error

1.1.5 About Path and GroupPath SpecificationSpecify the topic path of the target resource that is shown in the Operation view, the Resource view,or the Virtual view as the path.

(You can confirm the topic path from the Web Console.)

E.g., Assume that a target resource is on the same machine named "VM1".

in the Operation view -> operations:/category1/group1/vmmodel/VM1

in the Resource view -> resource:/vmgroup/VM1

in the Virtual view -> virtual:/VC1/DataCenter1/VMS1/VM1

You can specify "\ (backslash)" or "/ (slash)" as the delimiter of the group path.

• You can specify a running machine as a target by specifying a host in an operation group.

E.g., operations:/category1/group1/host1

• You can identify a machine by specifying only the machine name unless there are multiplemachines with the same name (behavior is unpredictable in this case).

Add the path to identify the machine for this condition.

• When specifying the path in the Resource view, machines right under the root cannot bespecified. Re-register the machines as group subordinates using machine registration command(register machine).

E.g., ssc register machine /NewGroup / -e -n

• Smart groups cannot be specified except for a command (collect group).

• From SigmaSystemCenter 3.5 Update1, you can use the same method to specify paths for allcommands.

However, if you specify a path without specifying a view (such as "operations:/"), the targetviews vary by each command.

For the target views, see the following table:

Chapter 1. About ssc Command

11 SigmaSystemCenter 3.5 ssc Command Reference

Page 22: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command names Arguments/Options Views withoutarguments/options

ssc collect -path Path resource

ssc power-control machine -path Path resource

ssc maintenance machine -fullpath FullPath resource

ssc add software Path operations

ssc deploy software -path path resource

ssc rdmstorage show -vms VmsName virtual

ssc rdmstorage update -vms VmsName virtual

ssc portgroup create Path virtual

ssc portgroup delete Path virtual

ssc portgroup show Path virtual

ssc portgroup update Path virtual

ssc privatevlan create Path virtual

ssc privatevlan delete Path virtual

ssc privatevlan update Path virtual

ssc customproperty add Target resource

-vmserver VMServerPath virtual

ssc customproperty delete Target resource

-vmserver VMServerPath virtual

ssc customproperty show Target resource

-vmserver VMServerPath virtual

ssc recover machine SourceName virtual

ssc evacuate machine SourceName virtual

DestinationName virtual

ssc update vmproperty Path virtual

ssc migrate machine SourceName virtual

DestinationName virtual

ssc move machine SourceName virtual

DestinationName virtual

ssc create template Path virtual

ssc snapshot create Path virtual

ssc snapshot delete Path virtual

ssc snapshot revert Path virtual

ssc snapshot show Path virtual

ssc delete machine -path Path virtual

ssc clone machine SourceName virtual

VmsName virtual

ssc vm create -vms VmsName virtual

Chapter 1. About ssc Command

12 SigmaSystemCenter 3.5 ssc Command Reference

Page 23: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Command names Arguments/Options Views withoutarguments/options

ssc export vm VmName virtual

ssc iso mount VMName operation

ssc iso show VMName operation

ssc iso unmount VMName operation

ssc set-machine-status -path Path resource

ssc dpminformation delete Path resource

ssc update vmserver VMServer virtual

ssc snapshot update VM virtual

1.1.6 OS Lists and Time zones• OS lists

The lists show OS codes and OS names to be specified in ssc command.

Windows Server

20 Windows Server 2008 Standard (x86)

21 Windows Server 2008 Enterprise (x86)

22 Windows Server 2008 Datacenter (x86)

23 Windows Server 2008 Standard (x64)

24 Windows Server 2008 Enterprise (x64)

25 Windows Server 2008 Datacenter (x64)

27 Windows Server 2008 R2 Standard (x64)

28 Windows Server 2008 R2 Enterprise (x64)

29 Windows Server 2008 R2 Datacenter (x64)

20101 Windows Server 2012 Standard

20102 Windows Server 2012 Datacenter

20201 Windows Server 2012 R2 Standard

20202 Windows Server 2012 R2 Datacenter

20301 Windows Server 2016

Windows Client

OsNameCode OsName

30 Windows Vista Business (x86)

31 Windows Vista Enterprise (x86)

32 Windows Vista Ultimate (x86)

33 Windows Vista Business (x64)

34 Windows Vista Enterprise (x64)

35 Windows Vista Ultimate (x64)

40 Windows 7 Professional (x86)

41 Windows 7 Ultimate (x86)

Chapter 1. About ssc Command

13 SigmaSystemCenter 3.5 ssc Command Reference

Page 24: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Windows Client

OsNameCode OsName

42 Windows 7 Enterprise (x86)

43 Windows 7 Professional (x64)

44 Windows 7 Enterprise (x64)

45 Windows 7 Ultimate (x64)

10103 Windows 8 Pro (x86)

10104 Windows 8 Pro (x64)

10105 Windows 8 Enterprise (x86)

10106 Windows 8 Enterprise (x64)

10203 Windows 8.1 Pro (x86)

10204 Windows 8.1 Enterprise (x86)

10205 Windows 8.1 Pro (x64)

10206 Windows 8.1 Enterprise (x64)

10303 Windows 10 Pro (x86)

10304 Windows 10 Pro (x64)

10305 Windows 10 Enterprise (x86)

10306 Windows 10 Enterprise (x64)

Linux

OsNameCode OsName

165 Red Hat Enterprise Linux AS 5

30503 Red Hat Enterprise Linux AS 5 (64bit)

166 Red Hat Enterprise Linux 5 AP

30504 Red Hat Enterprise Linux 5 AP (64bit)

169 Red Hat Enterprise Linux 6

30602 Red Hat Enterprise Linux 6 (64bit)

30702 Red Hat Enterprise Linux 7 (64bit)

168 SUSE Linux Enterprise Server 10

41002 SUSE Linux Enterprise Server 10 (64bit)

• Time zones

The list shows time zones to be specified in ssc command.

Index Name of Time Zone Time

0 Dateline Standard Time (GMT-12:00) International Date Line West

1 Samoa Standard Time (GMT-11:00) Midway Island, Samoa

2 Hawaiian Standard Time (GMT-10:00) Hawaii

3 Alaskan Standard Time (GMT-09:00) Alaska

4 Pacific Standard Time (GMT-08:00) Pacific Time (US and Canada); Tijuana

10 Mountain Standard Time (GMT-07:00) Mountain Time (US and Canada)

Chapter 1. About ssc Command

14 SigmaSystemCenter 3.5 ssc Command Reference

Page 25: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Index Name of Time Zone Time

13 Mexico Standard Time 2 (GMT-07:00) Chihuahua, La Paz, Mazatlan

15 U.S. Mountain Standard Time (GMT-07:00) Arizona

20 Central Standard Time (GMT-06:00) Central Time (US and Canada

25 Canada Central Standard Time (GMT-06:00) Saskatchewan

30 Mexico Standard Time (GMT-06:00) Guadalajara, Mexico City, Monterrey

33 Central America Standard Time (GMT-06:00) Central America

35 Eastern Standard Time (GMT-05:00) Eastern Time (US and Canada)

40 U.S. Eastern Standard Time (GMT-05:00) Indiana (East)

45 S.A. Pacific Standard Time (GMT-05:00) Bogota, Lima, Quito

50 Atlantic Standard Time (GMT-04:00) Atlantic Time (Canada)

55 S.A. Western Standard Time (GMT-04:00) Caracas, La Paz

56 Pacific S.A. Standard Time (GMT-04:00) Santiago

60 Newfoundland and Labrador Standard Time (GMT-03:30) Newfoundland and Labrador

65 E. South America Standard Time (GMT-03:00) Brasilia

70 S.A. Eastern Standard Time (GMT-03:00) Buenos Aires, Georgetown

73 Greenland Standard Time (GMT-03:00) Greenland

75 Mid-Atlantic Standard Time (GMT-02:00) Mid-Atlantic

80 Azores Standard Time (GMT-01:00) Azores

83 Cape Verde Standard Time (GMT-01:00) Cape Verde Islands

85 GMT Standard Time (GMT) Greenwich Mean Time: Dublin, Edinburgh,Lisbon, London

90 Greenwich Standard Time (GMT) Casablanca, Monrovia

95 Central Europe Standard Time (GMT+01:00) Belgrade, Bratislava, Budapest,Ljubljana, Prague

100 Central European Standard Time (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb

105 Romance Standard Time (GMT+01:00) Brussels, Copenhagen, Madrid, Paris

110 W. Europe Standard Time (GMT+01:00) Amsterdam, Berlin, Bern, Rome,Stockholm, Vienna

113 W. Central Africa Standard Time (GMT+01:00) West Central Africa

115 E. Europe Standard Time (GMT+02:00) Bucharest

120 Egypt Standard Time (GMT+02:00) Cairo

125 FLE Standard Time (GMT+02:00) Helsinki, Kiev, Riga, Sofia, Tallinn,Vilnius

130 GTB Standard Time (GMT+02:00) Athens, Istanbul, Minsk

135 Israel Standard Time (GMT+02:00) Jerusalem

140 South Africa Standard Time (GMT+02:00) Harare, Pretoria

145 Russian Standard Time (GMT+03:00) Moscow, St. Petersburg, Volgograd

150 Arab Standard Time (GMT+03:00) Kuwait, Riyadh

155 E. Africa Standard Time (GMT+03:00) Nairobi

158 Arabic Standard Time (GMT+03:00) Baghdad

Chapter 1. About ssc Command

15 SigmaSystemCenter 3.5 ssc Command Reference

Page 26: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Index Name of Time Zone Time

160 Iran Standard Time (GMT+03:30) Tehran

165 Arabian Standard Time (GMT+04:00) Abu Dhabi, Muscat

170 Caucasus Standard Time (GMT+04:00) Baku, Tbilisi, Yerevan

175 Transitional Islamic State of AfghanistanStandard Time

(GMT+04:30) Kabul

180 Ekaterinburg Standard Time (GMT+05:00) Ekaterinburg

185 West Asia Standard Time (GMT+05:00) Islamabad, Karachi, Tashkent

190 India Standard Time (GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi

193 Nepal Standard Time (GMT+05:45) Kathmandu

195 Central Asia Standard Time (GMT+06:00) Astana, Dhaka

200 Sri Lanka Standard Time (GMT+06:00) Sri Jayawardenepura

201 N. Central Asia Standard Time (GMT+06:00) Almaty, Novosibirsk

203 Myanmar Standard Time (GMT+06:30) Yangon Rangoon

205 S.E. Asia Standard Time (GMT+07:00) Bangkok, Hanoi, Jakarta

207 North Asia Standard Time (GMT+07:00) Krasnoyarsk

210 China Standard Time (GMT+08:00) Beijing, Chongqing, Hong Kong SAR,Urumqi

215 Singapore Standard Time (GMT+08:00) Kuala Lumpur, Singapore

220 Taipei Standard Time (GMT+08:00) Taipei

225 W. Australia Standard Time (GMT+08:00) Perth

227 North Asia East Standard Time (GMT+08:00) Irkutsk, Ulaanbaatar

230 Korea Standard Time (GMT+09:00) Seoul

235 Tokyo Standard Time (GMT+09:00) Osaka, Sapporo, Tokyo

240 Yakutsk Standard Time (GMT+09:00) Yakutsk

245 A.U.S. Central Standard Time (GMT+09:30) Darwin

250 Cen. Australia Standard Time (GMT+09:30) Adelaide

255 A.U.S. Eastern Standard Time (GMT+10:00) Canberra, Melbourne, Sydney

260 E. Australia Standard Time (GMT+10:00) Brisbane

265 Tasmania Standard Time (GMT+10:00) Hobart

270 Vladivostok Standard Time (GMT+10:00) Vladivostok

275 West Pacific Standard Time (GMT+10:00) Guam, Port Moresby

280 Central Pacific Standard Time (GMT+11:00) Magadan, Solomon Islands, NewCaledonia

285 Fiji Islands Standard Time (GMT+12:00) Fiji Islands, Kamchatka, Marshall Islands

290 New Zealand Standard Time (GMT+12:00) Auckland, Wellington

300 Tonga Standard Time (GMT+13:00) Nuku'alofa

1.1.7 Performance Data and Metric IDsThe list shows performance data names and metric IDs to be specified in ssc command.

Chapter 1. About ssc Command

16 SigmaSystemCenter 3.5 ssc Command Reference

Page 27: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Performance data names Metric ID

CPU Usage (%) 1

CPU System Usage (%) 2

CPU User Usage (%) 3

CPU Usage (MHz) 4

Guest CPU Usage (%) 11

Guest CPU Usage (MHz) 12

Host CPU Usage (%) 13

Host CPU Usage (MHz) 14

Disk Transfer Rate (Bytes/sec) 21

Disk IO Count (IO/sec) 22

Disk Read Transfer Rate (Bytes/sec) 23

Disk Read Count (IO/sec) 24

Disk Write Transfer Rate (Bytes/sec) 25

Disk Write Count (IO/sec) 26

Disk Space (MB) 27

Disk Space Ratio (%) 28

Guest Disk Transfer Rate (Bytes/sec) 31

Guest Disk IO Count (IO/sec) 32

Guest Disk Read Transfer Rate (Bytes/sec) 33

Guest Disk Read Count (IO/sec) 34

Guest Disk Write Transfer Rate (Bytes/sec) 35

Guest Disk Write Count (IO/sec) 36

Guest Disk Usage (MB) 37

Guest Disk Usage (%) 38

Network Packet Transfer Rate (Bytes/sec) 41

Network Packet Reception Rate (Bytes/sec) 42

Network Packet Transmission Rate (Bytes/sec) 43

Guest Network Transfer Rate (Bytes/sec) 51

Physical Memory Space (MB) 61

Physical Memory Space Ratio (%) 62

Guest Memory Usage (%) 71

Guest Memory Usage (MB) 72

Host Memory Usage (%) 73

Host Memory Usage (MB) 74

Current Power (W) 101

VMNumber.Capacity 200

VMNumber.Consumed 201

VMNumber.Consumed (%) 202

Chapter 1. About ssc Command

17 SigmaSystemCenter 3.5 ssc Command Reference

Page 28: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Performance data names Metric ID

VMNumber.Unused 203

VMNumber.Unused (%) 204

VMNumber.Reserved 205

VMNumber.Reserved (%) 206

VMNumber.ActuallyConsumed 207

VMNumber.ActuallyConsumed (%) 208

CPU.Capacity (MHz) 209

CPU.Consumed (MHz) 210

CPU.Consumed (%) 211

CPU.Unused (MHz) 212

CPU.Unused (%) 213

CPU.Reserved (MHz) 214

CPU.Reserved (%) 215

CPU.ActuallyConsumed (MHz) 216

CPU.ActuallyConsumed (%) 217

vCPUNumber.Capacity 218

vCPUNumber.Consumed 219

vCPUNumber.Consumed (%) 220

vCPUNumber.Unused 221

vCPUNumber.Unused (%) 222

vCPUNumber.Reserved 223

vCPUNumber.Reserved (%) 224

vCPUNumber.ActuallyConsumed 225

vCPUNumber.ActuallyConsumed (%) 226

Memory.Capacity (MB) 227

Memory.Consumed (MB) 228

Memory.Consumed (%) 229

Memory.Unused (MB) 230

Memory.Unused (%) 231

Memory.Reserved (MB) 232

Memory.Reserved (%) 233

Memory.ActuallyConsumed (MB) 234

Memory.ActuallyConsumed (%) 235

Datastore.Capacity (GB) 236

Datastore.Consumed (GB) 237

Datastore.Consumed (%) 238

Datastore.Unused (GB) 239

Datastore.Unused (%) 240

Chapter 1. About ssc Command

18 SigmaSystemCenter 3.5 ssc Command Reference

Page 29: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Performance data names Metric ID

Datastore.Reserved (GB) 241

Datastore.Reserved (%) 242

Datastore.ActuallyConsumed (GB) 243

Datastore.ActuallyConsumed (%) 244

Machine.Count 300

Machine.Physical.Count 301

Machine.VMServer.Count 302

Machine.VM.Count 303

Machine.PowerStatus.Running.Count 304

Machine.PowerStatus.On.Count 305

Machine.PowerStatus.Off.Count 306

Machine.PowerStatus.Suspend.Count 307

Machine.PowerStatus.Unknown.Count 308

Machine.OSStatus.On.Count 309

Machine.OSStatus.Off.Count 310

Machine.OSStatus.Unknown.Count 311

Machine.HardwareStatus.Unknown.Count 312

Machine.HardwareStatus.Ready.Count 313

Machine.HardwareStatus.Faulted.Count 314

Machine.HardwareStatus.Degraded.Count 315

Machine.Failure.Count 316

1.1.8 Controllers and Location Data for Each VirtualizationInfrastructure Product

The list shows controllers and location data to be specified in ssc command.

Virtualizationinfrastructure

products

Controllers Locations (disknumbers)

Remarks

VMware IDE0, IDE1 0,1 If 0 does not exist in the disk,you cannot use 1.

VMware IDE0, IDE1 0,1 If 0 does not exist in the disk,you cannot use 1.

SCSI0, SCSI1, SCSI2,SCSI3

0 ~ 15 (except 7) DiskContoller uses 7exclusively.

SATA0, SATA1, SATA2,SATA3

0 ~ 29

Xen SCSI0 0 ~ 7

Hyper-V IDE0, IDE1 0,1

SCSI0, SCSI1, SCSI2,SCSI3

0 ~ 63

Chapter 1. About ssc Command

19 SigmaSystemCenter 3.5 ssc Command Reference

Page 30: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Virtualizationinfrastructure

products

Controllers Locations (disknumbers)

Remarks

KVM IDE0, IDE1 0,1

PCI0 0 ~ 31

• Each location is shared with other devices (NIC, CD-Rom). You cannot use all locations forvirtual disks exclusively.

• You cannot add an expanded disk to the location that each product uses (see below) as a systemdisk.

  VMware: IDE0:0/SCSI0:0/SATA0:0

  Xen: SCSI0:0

  Hyper-V: IDE0:0

  KVM: Uses PCI0 for the virtio disk of PCI devices. The locations 0, 1, 2 are unavailable.

1.1.9 Caution Notes of ssc Command• When a Resource (Machine, Host, Group etc.) Name begins with "-" (hyphen)

If an option is specified for a resource of which name begins with "-", the option and / or theresource name might be misinterpreted.

Therefore, if a name of a resource begins with "-", execute a command after changing its nameor operate the resource from the Web Console.

• About a Resource Name in a message

Even if a command is executed with specifying a host name, the host name might be changed tothe resource name (the machine name) of the host in a job progress or a message.

• Even if a job normally ends when having started action sequence of synchronous execution,

the command sometimes ends by a connection error (return value =6).

(You need to check the logs to determine which of above the cause is.)

• In the command such as "create machine" which is able to specify smart group,

if the result data of the command are across two or more operation groups,

the command execution process is divided into plural jobs correspond to the operation groups,and the jobs are processed sequentially.

When error occurred in any job, the jobs following are not processed.

In this case, fix error cause, and retry.

• When specifying a machines name in Path of a [resource] view by each command

when establishing [unit name] in machine property setting by a [resource] view of a webconsole,

please specify it by [unit name], not [machine name].

- When it's specified in Path of other views or a machines name, please specify [machinename], not [unit name].

• You cannot specify leading or trailing spaces in the equal ("=").

Chapter 1. About ssc Command

20 SigmaSystemCenter 3.5 ssc Command Reference

Page 31: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Chapter 2. Command for Setup

Contents2.1 License.......................................................................................................................................22

2.2 User ...........................................................................................................................................23

2.3 Environment Setting ..................................................................................................................26

2.4 Subsystem..................................................................................................................................29

2.5 Collect........................................................................................................................................30

2.6 Machine .....................................................................................................................................31

2.7 Machine Account .......................................................................................................................51

2.8 Group.........................................................................................................................................55

2.9 Host ...........................................................................................................................................76

2.10 IP Address................................................................................................................................83

2.11 Software ...................................................................................................................................85

2.12 Storage .....................................................................................................................................93

2.13 Network .................................................................................................................................123

2.14 Load Balancer ........................................................................................................................145

2.15 Logical Machine ....................................................................................................................148

2.16 Smart Group...........................................................................................................................156

2.17 Profile ....................................................................................................................................169

2.18 API Key .................................................................................................................................190

2.19 Custom Setting.......................................................................................................................192

2.20 CIM Indication Setting...........................................................................................................196

2.21 Custom Object .......................................................................................................................196

2.22 External Resource ..................................................................................................................200

Chapter 2. Command for Setup

21 SigmaSystemCenter 3.5 ssc Command Reference

Page 32: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This chapter explains commands regarding setting up SigmaSystemCenter.

2.1 License2.1.1 Adding License

Adds a license.

Register an edition license first. To enable the setting, you need to restart

SystemProvisioning. However, if you add only target licenses, you do not need to

restart SystemProvisioning.

[Syntax]

ssc add license <LicenseKey | -filepath FilePath>

[Parameters and Options]

  

<LicenseKey | -filepath FilePath> Specify a target license key or the path of the text file.

[Syntax examples]

>ssc add license XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

2.1.2 Deleting LicenseDeletes a license.

[Syntax]

ssc delete license LicenseKey

[Parameters and Options]

LicenseKey(Required)

Specify a target license key.

[Syntax examples]

>ssc delete license XXXXX-XXXXX-XXXXX-XXXXX-XXXXX

2.1.3 Displaying LicensesDisplays licenses.

[Syntax]

ssc show license

[Parameters and Options]

No parameters or options.

[Syntax examples]

Chapter 2. Command for Setup

22 SigmaSystemCenter 3.5 ssc Command Reference

Page 33: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc show license

2.2 User2.2.1 Creating User Account

Creates a user account.

[Syntax]

ssc create user UserName [Password] [-permission AuthorityType | -role RoleName | -norole] [-description Description] [-type CertificationType]

[Parameters and Options]

UserName(Required)

Specify a user name.You can enter any character up to 32 characters, except the following symbols:* + , / : ; < = > ? \ | [ ]

[Password] Specify a password.You can enter up to 128 alphabetic characters, numerals, and symbols, except spaces.You can specify a password when the -type option is "Local".

[-permission AuthorityType] Specify the authority level from the following types:Administrator, Operator and Observer.

[-role RoleName] Specify an initial role.You can specify the role whose setting object is"All Resource / System" or "System".

[-norole] Creates a user without authority.

[-description Description] Enter a description of the user.Up to 128 characters are available.

[-type CertificationType] Specify the certification type from the following types:"Local", "SystemLDAP".If you do not specify this option, "Local" is set to it.

[Syntax examples]

>ssc create user User01 xxxxxx -permission Administrator >ssc create user User01 xxxxxx -role admin-users >ssc create user User01 xxxxxx -description "User01 is Administrator." >ssc create user User01 -type "SystemLDAP"

[Note]

• If you do specify neither -permission nor -role option,

an Administrator user account will be created.

• If you specify both -permission and -role, the initial role that you specify by the -role optionbecomes invalid and the role which corresponds to the permission you specified in the -permission option is assigned.

2.2.2 Deleting User AccountDeletes a user account.

[Syntax]

Chapter 2. Command for Setup

23 SigmaSystemCenter 3.5 ssc Command Reference

Page 34: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc delete user UserName

[Parameters and Options]

UserName(Required)

Specify a user name of a target user account.

[Syntax examples]

>ssc delete user User01

2.2.3 Displaying User AccountDisplays the user account information in the CSV format.

[Syntax]

ssc show user

[Parameters and Options]

No parameters or options.

[Syntax examples]

>ssc show user

[Display examples]

>ssc show user UserName,Permission,LoginDate,LoginIPAddress,Disabled,DisabledType,InitialRole,EmailAddress,CertificationType,CertificatedDate,DomainName,Description "admin","Administrator","2013/01/08 3:56:35","192.168.1.123","False","","Administrator","","LocalUser","2013/01/08 3:56:35","","admin user" "admin2","Administrator","2013/01/08 4:56:35","","False","","Administrator","","LocalUser","2013/01/08 4:56:35","","second admin user" "oper","Operator","2013/01/08 5:56:35","","False","","Operator","","LocalUser","2013/01/08 5:56:35","","" "user","Observer","2013/01/08 6:56:35","","False","","Observer","","LocalUser","2013/01/08 6:56:35","","" "user-a","UserSetting","2013/01/08 7:56:35","","False","","RoleA","","LocalUser","2013/01/08 7:56:35","",""

2.2.4 Changing User Account PasswordChanges a password of a user account or VM server.

[Syntax]

ssc change-passwd Type Name NewPassword [-l Account] [-p Password]

[Parameters and Options]

Type(Required)

Specify the target type to be changed its password:"manager": Specify in the case of changing a password of a VM server."user": Specify in the case of changing a password of a user account.

Name Specify the target name.

Chapter 2. Command for Setup

24 SigmaSystemCenter 3.5 ssc Command Reference

Page 35: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required) Specify the host name or the full path of the target virtual machine server if "manager" is specifiedin Type.(E.g.: VirtualCenter/DataCenter/ESX)If the same host name exists, specify the host with its path.Specify a user name when "user" is specified in Type.

NewPassword(Required)

Specify a new password.

[-l Account] Specify the account name.Specify the account name of the VM Server when "manager" is specified in Type. If you do notspecify it, the account name is not changed.Specify an administrator user name when "user" is specified in Type.If you do not specify it, specify an old password in the -p option as authentication information.

[-p Password] You can specify this option when "user" is specified in Type.Specify an administrator user password if the -l option is specified.Specify an old password of target user if the -l option is not specified.

[Syntax examples]

Changes a password of VM server. >ssc change-passwd manager Host1 "*****" -l user1 >ssc change-passwd manager "VirtualCenter/New DataCenter/Esx1" "****"

Change a password of a user. 1) Authentication is old password of user. >ssc change-passwd user user1 "****" -p "****"

2) Authentication is administrator user account. >ssc change-passwd user user2 "****" -l Administrator -p "****"

2.2.5 Acquiring User Account and GroupConnects to the LDAP Server that is set in the LDAPConfig.xml and

registers the acquired information of the user/group on the SigmaSystemCenter.

To execute this command, you must configure the following settings beforehand.

・Exist a valid Administrator User Account in SigmaSystemCenter.

・Complete the "Edition" license registration.

・Confugure the LDAP information, which is to be connected, to LDAPConfig.xml.

 Refer to NEC SigmaSystemCenter Overview Reference Guide for details of the description.

[Syntax]

ssc sync ldapuser Account Password

[Parameters and Options]

Account Specify an account name for authentication which exists in the LDAP server.This account should be existed in the LDAP server while it is not necessary to be existed inSigmaSystemCenter.You can enter any character up to 32 characters,except the following symbols:* + , / : ; < = > ? \ | [ ]

Chapter 2. Command for Setup

25 SigmaSystemCenter 3.5 ssc Command Reference

Page 36: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

For the use of characters the LDAP server, please refer to the related manuals of the LDAP server.

Password Specify an account password for authentication which exists in the LDAP server.You can enter up to 128 alphabetic characters, numerals,and symbols, except spaces.For the use of characters the LDAP server, please refer to the related manuals of the LDAP server.

[Syntax examples]

>ssc sync ldapuser username password

2.3 Environment Setting2.3.1 Updating Environment Setting

Configures environment settings.

[Syntax]

ssc update environment <Key Value | -maintenance>

[Parameters and Options]

Key (Description)• VMSDefaultCapacity: The capacity value of a virtual machine server.

Specify in the range of 1 to 100000.• VMDefaultCost: The initial cost value of a virtual machine.

Specify in the range of 1 to 1000.• VMSRootPassword: The root password of a virtual machine server.• ULogSize: The maximum number of an operation log.

Specify 1000 or more.• ULogDay: The maximum number of days to keep operational logs (day).

Specify in the range of 1 to 1000.• DLogSize: The maximum size of a debug log (MB).

Specify in the range of 1 to 16.• DLogLevel: The level of a debug log.

Specify in the range of 0 to 7.0: acquires error logs1: acquires warning logs2: acquires information logs3-7: acquires trace logs (trace levels 1-5)

• EventHistorySize: The maximum number of an event history.Specify 1000 or more.

• EventHistoryDay: The maximum number of days to keep event histories (day).Specify in the range of 1 to 1000.

• EnableMACAddressRange: Enables or disables the MAC address pool feature (only for Hyper-V).Specify True or False.

• TempWorkingDir: A temporary folder for a file transfer.• MaxLoginAttempts: The number of failed login attempts.

Specify in the range of 0 to 999.

Chapter 2. Command for Setup

26 SigmaSystemCenter 3.5 ssc Command Reference

Page 37: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• HidePortalView: The display setting of a Portal View.Specify True or False.

• RescueAccessPoint: The host name or IP address of a RescueVM.• RescueAccount: The login account of a RescueVM.• RescuePassword: The login password of a RescueVM.• Polling: The interval of a periodical collection (minute).

Specify in the range of 1 to 3600.Specify 0 to stop periodical collection.

• UpdateLatestJobInterval: The interval of job update (second).Specify 5, 10, or 30.

• UpdateLatestLogInterval: The interval of log update (second).Specify 5, 10, or 30.

• MonitorInterval: The interval of screen update (second).Specify the renge of 5 to less than the AutoUpdateMaxPeriod value.

• AutoUpdateMaxPeriod: The maximum number of screen update (second).Specify in the range of 5 to 36000.

• JobResultDisplayPeriod: The display period of job results (minute).Specify in the range of 1 to 10000.

• EnableAutoUpdate: Enables or disables the auto update of a screen.Specify True or False.

• CommunityName: An SNMP community name for NEC ESMPRO Manager.• MappingRetryCount: The retry count for registering a machine to NEC ESMPRO Manager.• MappingRetryWait: The retry interval for registering a machine to NEC ESMPRO Manager.• MappingTimeOut: The connection timeout for NEC ESMPRO Manager.• ESMPRO_Password: The connection password for NEC ESMPRO Manager.• Mail: Enables or disables email reporting.

Specify True or False.• MailFrom: A source email address.• MailTo: A destination email address.• SMTPServer: An SMTP server name.• SMTP_Port: An SMTP port number.• SMTP_Send_Password: Enables or disables SMTP authentication.

Specify True or False.• SMTP_UserName: An SMTP user name.• SMTP_Password: An SMTP password.• SMTP_EnableSsl: Enables or disables SSL/TSL for sending email.

Specify True or False.• BmcEnableAliveMonitor: Enables or disables routine alive monitoring.

Specify True or False.• BmcDefaultEnableMonitor: Enables or disables alive monitoring by default.

Specify True or False.• BmcMonitoringInterval: The interval of alive monitoring (minute).

Specify in the range of 10 to 1440.• BmcMonitoringSkipInterval: A time to skip the next alive monitoring (minute).

Specify in the range of 1 to 30.- If an elapsed time from the last alive monitoring is within the range, the next monitoring will

be skipped.

Chapter 2. Command for Setup

27 SigmaSystemCenter 3.5 ssc Command Reference

Page 38: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• BmcMonitoringRetry: The retry count of per alive monitoring.Specify in the range of 1 to 15.

• BmcMonitoringRetryInterval: The interval of BmcMonitoringRetry (second).Specify in the range of 10 to 60.

• BmcMonitoringThreads: The capable number of alive monitoring simultaneously.Specify in the range of 1 to 30.

• BmcCommandTimeout: The number of an IPMI command timeout (second).Specify in the range of 1 to 30.

• BmcMonitoringPolicy: The name of an alive monitoring policy.

Value Specify the values of Keys.

-maintenance This option switches from the current mode to a maintenance mode to control outputting event logsthat ID from 520 to 522.After performing the command:• Select 2:add/update• Follow "Input key name," input EventLog_Disable_520, EventLog_Disable_521, or

EventLog_Disable_522 depending on which ID you want to update.• Follow "Input key value," input False or True. If you want to output the event log of the selected

ID in above, select False. If not, select True.Note that this option is only for maintenance purpose. Do not use except the above.

[Syntax examples]

>ssc update environment vmsdefaultcapacity 1 >ssc update environment vmdefaultcost 100 >ssc update environment vmsrootpassword xxxxxx >ssc update environment enablemacaddressrange True >ssc update environment tempworkingdir D:/Work

>ssc update environment -maintenance Caution: Before this command execution, please backup database 1:show 2:add/update 3:remove other:exit 2

Input key name EventLog_Disable_520 Input key value False Update key EventLog_Disable_520 : (True) to (False) ? (y/n) y Success (EventLog_Disable_520).

2.3.2 Start Up Collecting SettingChanges a collect mode in the stratup.

[Syntax]

ssc startup-collect-mode < on | off >

[Parameters and Options]

< on | off >(Required)

on:The collection when the PVMService starts is turned ON.off:The collection when the PVMService starts is turned OFF.

Chapter 2. Command for Setup

28 SigmaSystemCenter 3.5 ssc Command Reference

Page 39: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc startup-collect-mode on >ssc startup-collect-mode off

2.4 Subsystem2.4.1 Adding Subsystem

Adds a subsystem.

[Syntax]

ssc add manager Type [-name HostName] [-account Account]

[-port PortNumber] [-url URL] [-p Password]

[Parameters and Options]

Type(Required)

Specify a subsystem to add from the following Types:"dpm": DPM Server"vcenter" "virtualcenter": VMware vCenter Server"esxi": ESXi"xen": Citrix XenServer Pool Master"hyper-v": Hyper-V"hyper-v-cluster": Hyper-V Cluster"kvm": KVM"network": MasterScope Network Manager"slb": Software Load Balancer"pfc": ProgrammableFlow Controller"necstorage": NEC Storage Manager"clariion":EMC CLARiiON"symmetrix": EMC Symmetrix"netappstorage": NetApp Manager"smi-s": SMI-S Service"vcns": VMware vCloud Network and Security

[-name HostName] Specify a host name or IP address of a server on which the target is installed.If you specify its URL, a host name is automatically created, and you do not need to specifythis item.

[-account Account] Specify an account name or domain name of the target.

[-port PortNumber] Specify a port number of the target.

[-url URL] Specify a URL of the target.If you specify HostName, a URL is automatically generated, and you do not need to specifythis item.

[-p Password] Specify a password registered to the target.

• If you specify "esxi", "hyper-v", "kvm", "clariion", "symmetrix" or "netappstorage" in Type,

 you cannot specify the options; -name, -account, -port, -url, and -p.

• If you specify "dpm", "network", "slb", "pfc" or "vcns" in Type,

Chapter 2. Command for Setup

29 SigmaSystemCenter 3.5 ssc Command Reference

Page 40: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 you need to specify the options; -name.

• If you specify "vcenter" or "xen" in Type,

 you need to specify the options; -account and -p.

• If you specify "smi-s" in Type, you need to specify the options; -account, -url and -p.

[Syntax examples]

>ssc add manager esxi >ssc add manager hyper-v >ssc add manager dpm -name 192.168.1.50 –p xxxxx >ssc add manager vcenter -name 192.168.1.100 -account user01 -port 443 -url "https://192.168.1.100:443/sdk" -p xxxxx >ssc add manager xen -name 192.168.1.200 -account user02 –p xxxxx >ssc add manager hyper-v-cluster -name 192.168.1.100 -account domain/userA -p xxxxx >ssc add manager smi-s -account user01 -url "http://172.16.0.69" -p xxxxx

2.5 Collect2.5.1 Collecting Information

Collects information.

[Syntax]

ssc collect Type [-name Name... | -uuid Uuid... | -path Path] [-target < basic | sensor | software | all >][-priority < high | middle | low >]

[Parameters and Options]

Type(Required)

Specify the target that you want to collect information from the following Types:"all": All subsystems"vms": VM Servers on subsystems."machine": Physical machines, VM Servers, and virtual machines."group": Machines under the group that is specified with -path."dpm": DPM Server"virtual": Virtual Manager"storage": Storage"network": Network

[-name Name...] This value is enabled if the Type is "vms", "dpm", "virtual", "storage", "network" or"machine"."vms", "dpm", "virtual", "storage", "network": Specify the subsystem's host name (or IPaddress)."machine": Specify the Machine Name.Multiple parameters can be specified.

[-uuid Uuid...] Specify the UUID of the target.This value is enabled if the Type is "machine".Multiple parameters can be specified.

[-path Path] This value is enabled if the Type is "machine", "vms" or "group".

Chapter 2. Command for Setup

30 SigmaSystemCenter 3.5 ssc Command Reference

Page 41: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Specify the full path of the collection target, including each View."machine"Virtual View : virtual:/VC1/DataCenter1/VMServer1/VM001Resource View : resource:/Group1/VM001"vms"Virtual View : virtual:/VC1/DataCenter1/VMServer1Resource View : resource:/Group1/VMServer1"group"Virtual View : virtual:/VC1/DataCenter1/Resource View : resource:/Group1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-target < basic |sensor | software |all >]

This value is enabled if the Type is "machine" or "group".Select the division to collect from the following:"basic" : Essential information is collected."sensor" : Momentary values of the sensor are collected."software" : Essential information is collected."all" : All machine information is collected.

[-priority < high |middle | low >]

This value is enabled if the Type is "machine" or "group".Specify the priority of the collection processing.

[Syntax examples]

>ssc collect all >ssc collect vms –name 192.168.1.1 >ssc collect vms -path virtual:/Manager/DataCenter/VMServer >ssc collect machine –uuid xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

2.6 Machine2.6.1 Registering Machine

Registers unmanaged machine(s) in a specified resource group or rack.

Also, you can create a new machine and register it for DPM.

[Syntax]

ssc register machine GroupName MachineName... [-e [GroupType]] [-n | < -c [DPMServerAddress] -uuid UUID [-mac PrimaryMacAddress] [-force] >]

[Parameters and Options]

GroupName(Required)

Specify the path to a resource group or a rack in which you want to register amachine.

MachineName...(Required)

Specify target machine name(s).Note: You cannot specify managed machine(s).Also, you can specify only one machine when you create it.

[-e [GroupType]] Create a new group or rack which you specified in GroupName.[GroupType]

Chapter 2. Command for Setup

31 SigmaSystemCenter 3.5 ssc Command Reference

Page 42: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Select path type from "group" or "rack"(default is "group").

[-n] Move machine(s) to the specified group from the root node(which is directly below Machine icon in the System Resource tree.)If you specify all machines in the root node, specify "/" in MachineName.

[-c [DPMServerAddress]] Specify DPM Server's IP address. You must specify this option when you create anew machine.If you manage two or more DPM servers, select the most appropriate DPM server andspecify it's IP address.Note: You cannot specify this option together with [-n] option.

[-uuid UUID] Specify the UUID of the machine. You must specify this option when you create anew machine.

[-mac PrimaryMacAddress] Specify the MAC address of the machine.

[-force] When you register the machine that exists in SigmaSystemCenter to DPM Server,you can register even though the machine is running.You can specify this option when you create a new machine.Note: The running machine must be in the Maintenance mode.

[Syntax examples]

>ssc register machine Group1 machine01 >ssc register machine Group1/Rack01 machine02 machine03 >ssc register machine Group1/Group2 machine04 >ssc register machine Group1/Group2/Group3 machine05 -e >ssc register machine Group1 / -n >ssc register machine Group2 blade1 -e -c -uuid 30381C00-D797-11DD-0000-001697A70000 >ssc register machine Group2 blade1 -c 192.168.1.101 -uuid 30381C00-D797-11DD-0000-001697A70000 >ssc register machine Group2 blade1 -c 192.168.1.101 -uuid 30381C00-D797-11DD-0000-001697A70000 -mac 00:16:97:A7:00:00 >ssc register machine Group2 blade1 -c 192.168.1.101 -uuid 30381C00-D797-11DD-0000-001697A70000 -mac 00:16:97:A7:00:00 -force

2.6.2 Unregistering MachineUnregisters a machine from a resource group or rack.

Also, you can delete a machine and unregister it from DPM.

[Syntax]

ssc unregister machine GroupName MachineName... [-d]

[Parameters and Options]

GroupName(Required)

Specify a resource group or rack in which a machine that you want to unregister belongs.Specify a path to the resource group or rack.If you specify only "/", all managed machines in the Machine icon in the System Resource treebecome the targets.

MachineName...(Required)

Specify a target machine name.You cannot specify a machine running in an operation group or standing by.You can specify multiple machines.

[-d] Specify it when you delete the machine for SigmaSystemCenter and the DPM server.

Chapter 2. Command for Setup

32 SigmaSystemCenter 3.5 ssc Command Reference

Page 43: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc unregister machine / machine01 >ssc unregister machine Group1 machine02 >ssc unregister machine Group1/Rack01 machine03 machine04 >ssc unregister machine Group1/Group2 machine05 >ssc unregister machine Group1/Group2 machine05 -d

2.6.3 Allocating Machine, Registering Master Machine, orAdding Machine to Pool

Executes Allocate Machine, Register Master Machine, or Add Machine to Pool.

[Syntax]

ssc assign machine GroupName [MachineName...] [-sharedpool | -master | -addpool | -import]

[-host HostName] [-resource ResourcePoolName]

[-type Type][-filePath FilePath][-vms VmsName]

[-datastore DatastoreName][-newhost NewHostName]

[Parameters and Options]

GroupName(Required)

Specify the group to which you intend to allocate a machine, register a machine, or towhose pool you intend to add a machine.Specify a path to the group or model. You cannot specify a tenant, category or group.(E.g. Tenant/Category/Group/Model, Group/Model)

[MachineName...] Specify a machine name that you want to allocate, register, or add to a pool.If you do not specify MachineName, machines in a group pool become targets.If you specify -sharedpool, -master, or -addpool, you cannot omit this option.You can specify multiple machines when add a machine to a pool.

[-sharedpool] Specify this option to add a machine in the shared pool to a group.If you do not specify this option, a machine in a group pool is added to a group.You cannot specify this option along with -master and -addpool.

[-master] Specify this option to execute Register Master Machine.If you do not specify this option, a machine in a group pool is added to a group.You cannot specify this option along with -sharedpool and -addpool.

[-addpool] Specify this option to add a machine to a pool.You cannot specify this option along with -sharedpool, -master, and -host HostName.

[-import] Specify this option to importing VM and Register Machine.

[-host HostName] Specify a name of a host where a target machine is activated.If you specify -master, you cannot omit this option.You cannot specify this option along with -addpool.

[-resourceResourcePoolName]

Specify the name of the resource pool to be used.This option is enabled if a model type of GroupName is VM.You cannot specify this option along with -addpool.

[-type Type] Specify the file type of importing.If you specify option -import, you can specify this option.

[-filePath FilePath] Specify the path of file that you want to import.

Chapter 2. Command for Setup

33 SigmaSystemCenter 3.5 ssc Command Reference

Page 44: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When you don't specify -import, file type will auto-detect.

[-vms VmsName] Specify the VM server.If you specify -import, you cannot omit this option.

[-datastoreDatastoreName]

Specify the datastore.If you specify -import, you cannot omit this option.

[-newhost NewHostName] Specify a new host name when you make a new host.If you do not specify this option, create new host by MachineName.If you specify option -master, you can specify this option.You cannot specify this option along with -hostname.

[Syntax examples]

1) Allocate Machine by auto selection >ssc assign machine Category/Group1/Model001

2) Allocate Machine from a group pool >ssc assign machine Category/Group1/Model001 machine001 >ssc assign machine Category/Group1/Model001 machine002 -host host002 >ssc assign machine Category/Group1/Model001 -host03

3) Allocate Machine from the shared pool >ssc assign machine Category/Group1/Model001 machine001 -sharedpool >ssc assign machine Category/Group1/Model001 machine002 -sharedpool -host host002

4) Register Master Machine >ssc assign machine Category/Group1/Model001 machine001 -master -host host001

5) Add Machine to Pool >ssc assign machine Category/Group1/Model001 machine001 machine002 -addpool

6) Allocate Machine with the resource pool name >ssc assign machine Category/Group1/Model001 machine002 -host host002 -resource MyPool

2.6.4 Releasing or Deleting From PoolReleases assignment of a machine or deletes a machine from a pool.

[Syntax]

ssc release machine GroupName <[HostName...] [-sharedpool] [-force] < [-c] [-x [lm]] | [-t] > | -delMachineName... [-model ModelName]>

[Parameters and Options]

GroupName(Required)

Specify the group from which you intend to release or delete a machine.Specify a path to the group. You cannot specify a tenant, category or model.(E.g. Tenant/Category/Group)

[HostName...] Specify a name of a host with which a target machine is running.

Chapter 2. Command for Setup

34 SigmaSystemCenter 3.5 ssc Command Reference

Page 45: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you do not specify this option, a running machine is selected automatically and is returnedto a group pool.If you specify -sharedpool or -force, you cannot omit this option.You cannot specify this option along with -del.You can specify multiple hosts.

[-sharedpool] Returns a running machine from group to the shared pool.If you do not specify this option, the machine is returned to a group pool.If you specify this option, you cannot omit HostName.You cannot specify this option along with -del.

[-force] Releases assignment forcedly by operating the database.If you do not specify this option, a Job is executed.If you specify this option, you cannot omit HostName. However, you cannot specify multiplehost names.You cannot specify this option along with -sharedpool and -del.

[-c] Specify this parameter to take apart machine.If you specify this option for VirtualMachine, the VirtualMachine is deleted.If you specify this option for VirtualMachine, you cannot specify along with [-sharedpool].

[-x [lm]] Specify part that not take apart.This option supports a case that not take apart LogicalMachine.Specify this option along with [-c]

[-t] Specify this option a case that not take apart machine.

-delMachineName...

Specify this parameter to delete a target machine from a pool.You cannot specify this option along with HostName, -sharedpool, and -force.When the target machine is registered in the group pool more than one,if you omit the [-model], the machine that is not registered in the model will be deleted.When the target machine is registered in more than one models,You cannot omit [-model].

[-modelModelName]

Specify the models that registered in all of the machine is specified by [-del].If machines that in a group pool are registered in more than one models, please specify thisoption.

[Note]

• "ssc release machine" executes "Scale In" until SSC2.1u3.

But "Scale In" is executed by "ssc scalein" with SSC3.0.

[Syntax examples]

============================================================Wait in a group pool. Taka a part machine.Take a part logical machine.(For Physical Machine and Virtual Machine Server)============================================================>ssc release machine Category/Group1 -c

In case Physical Machine,the following statements are also available.

>ssc release machine Category/Group1

Chapter 2. Command for Setup

35 SigmaSystemCenter 3.5 ssc Command Reference

Page 46: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc release machine Category/Group1 host001

============================================================Wait in a group pool. Take a part machine.Not take a part logical machine.(For Physical Machine and Virtual Machine Server)============================================================>ssc release machine Category/Group1 -c -x lm>ssc release machine Category/Group1 host001 -c -x lm

============================================================Wait in a group pool. Not take a part machine.(For Physical Machine and Virtual Machine)============================================================>ssc release machine Category/Group1 -t>ssc release machine Category/Group1 host001 -t

In case Virtual Machine,the following statements are also available.

>ssc release machine Category/Group1>ssc release machine Category/Group1 host001

============================================================Return to the shared pool. Take a part machine.Take a part logical machine.(For Physical Machine and Virtual Machine Server)============================================================>ssc release machine Category/Group1 host001 -sharedpool -c

In case Physical Machine,the following statement is also available.

>ssc release machine Category/Group1 host001 -sharedpool

============================================================Return to the shared pool. Take a part machine.Not take a part logical machine.(For Physical Machine and Virtual Machine Server)============================================================>ssc release machine Category/Group1 host001 -sharedpool -c -x lm

============================================================Return to the shared pool. Not take a part machine.(For Physical Machine and Virtual Machine and Virtual Machine Server)============================================================>ssc release machine Category/Group1 host001 -sharedpool -t

In case Virtual Machine,the following statement is also available.

>ssc release machine Category/Group1 host001 -sharedpool

In case Virtual Machine Server,the following statements are also available.

>ssc release machine Category/Group1

Chapter 2. Command for Setup

36 SigmaSystemCenter 3.5 ssc Command Reference

Page 47: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc release machine Category/Group1 host001>ssc release machine Category/Group1 host001 -sharedpool>ssc release machine Category/Group1 -t>ssc release machine Category/Group1 host001 -t

============================================================Delete Virtual Machine.(For Virtual Machine)============================================================>ssc release machine Category/Group1 -c>ssc release machine Category/Group1 host001 -c

============================================================In case Virtual Machine,you cannot use the following statements.============================================================>ssc release machine Category/Group1 -c -x lm>ssc release machine Category/Group1 host001 -c -x lm>ssc release machine Category/Group1 host001 -sharedpool -c>ssc release machine Category/Group1 host001 -sharedpool -c -x lm

============================================================Return from a pool to the shared pool============================================================>ssc release machine Category/Group1 –del machine001 machine002

============================================================Wait in a group pool.(Force) ============================================================>ssc release machine Category/Group1 host001 -force

============================================================Return to the shared pool.(Force)============================================================>ssc release machine Category/Group1 host002 -sharedpool -force

2.6.5 Displaying MachineDisplays machine information.

[Syntax]

ssc show machine [ -ms [on | off] ] [ [-vms [VMSName] ] [ -vm [VMName] ] | [-smartgroupSmartGroupName] ]

 [ [-perf] [-resource] | [-spec] | [-property] | [-osservice] | [-summaryhint] | [-storage] ]

 [-vertical]

[Parameters and Options]

[-ms [on | off]] Specify the management status of machines to be displayed.If omitted, all machines are displayed.If you specify "on", machines being managed are displayed.If you specify "off", machines not being managed are displayed.If you do not specify "on" and "off", all machines are displayed.

Chapter 2. Command for Setup

37 SigmaSystemCenter 3.5 ssc Command Reference

Page 48: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-vms [VMSName]] Specify a VM Server to be displayed.If you do not specify VMSName, all VM Servers are displayed.If you specify VMSName, a list of virtual machines and templates under the VM Serverare displayed.

[-vm [VMName]] Specify a virtual machine to be displayed.If you do not specify VMName, all virtual machines are displayed.

[-smartgroupSmartGroupName]

Specify a smart group path in the Operations or Resource view in order to displayinformation of machines correspond to the condition of the specified smart group.You must specify an existing path for the group.Specify the following as prefixes:*Operations: the operations view*resource: the Resource view (below the machine node)Examples:[operations:/category1/group11/smartgroup101]Specify Smartgroup101 just below the group11 node of the category1 of the Operationsview is specified.[resource:/smartgroup102]Specify smartgroup102 just below the machine node of the Resource view.

[-perf] Performance information (Performance) is displayed.The target machine types are VM Servers and virtual machines.It may take time to obtain the latest information.

[-resource] Performance information (Virtual resource) is displayed.The target machine types are VM Servers and virtual machines.It may take time to obtain the latest information.

[-spec] Specification information is displayed.

[-property] The names and values of the construction parameters specified in a virtual machine aredisplayed.You must specify just one virtual machine by using [-vm].You cannot specify this option along with [-ms], [-vms], and [-smartgroup].

[-osservice] The OS service and the daemon settings of a virtual machine are displayed.You must specify just one virtual machine by using [-vm].You cannot specify this option along with [-ms], [-vms], [-smartgroup] or [-property].

[-errorevent Status] The triggered event of an error status is displayed.Available statuses are the following: executestatus: execute status hardwarestatus: hardware statusYou can specify this option along with [-vms] or [-vm].

[-summaryhint] The hint message is displayed for summary status.You must specify just one virtual machine.You cannot specify this option along with [-ms], [-vms], [-smartgroup], [-property] or [-osservice].

[-storage] Display the storage settings are displayed (HBA Address, Connector).You cannot specify this option along with [-perf], [-resource], [-spec], [-property], [-osservice], [-errorevent] or [-summaryhint].

[-vertical] The display format is changed. -vertical: Item : Value

Chapter 2. Command for Setup

38 SigmaSystemCenter 3.5 ssc Command Reference

Page 49: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc show machine -ms >ssc show machine -ms on >ssc show machine -ms on -perf >ssc show machine -vms HYPER-V222 -perf >ssc show machine -vm -vertical >ssc show machine -vm -resource >ssc show machine -smartgroup resource:/smartgroup102 >ssc show machine -ms on -smartgroup resource:/smartgroup102 -spec >ssc show machine -vms XenServer01 -vm VM-W2K8 >ssc show machine -vm vm01 -property >ssc show machine -vm vm01 -errorevent hardwarestatus

[Display examples]

>ssc show machine -ms on

#Name,ManagedStatus,Uuid,MacAddress,Type,SummaryStatus,RunningStatus,ExecuteStatus,PowerStatus,EventPolicyStatus,OperatingSystemStatus,HardwareStatus,MaintenanceStatus,OperatingSystem,OperatinGroup,HostName "192.168.10.174","Managed","80dfbf4d-2de0-d811-8001-003013f10162","00:30:13:F1:01:62","Blade, VMware, VM Server","-","Running","-","-","Off","-","Off","VMware ESX","","" "MasterMachine","Managed","42043949-9fde-6cb5-297c-bc5cd39a6de7","00:50:56:84:78:F6","VMware, Virtual Machine","-","-","-","On","-","On","-","Off","Microsoft Windows Server 2003, Standard Edition (32-bit)","","" "MasterVM","Managed","42049b63-168e-86d0-83c8-e57319cb622d","00:50:56:84:09:86","VMware, Virtual Machine","-","-","-","On","-","On","-","Off","Microsoft Windows Server 2003, Standard Edition (32-bit)","",""

>ssc show machine -ms on -vms 192.168.10.174 -resource [VMServer] #MachineName,MachineType,Uuid,MacAddress,ProductName,ModelName,ManagedStatus,SummaryStatus,PowerState,HardwareStatus,MaintenanceStatus,RunningStatus,ExecuteStatus,EventPolicyStatus,OperatingSystem,OSVersion,HostName,IPAddress,ConnectionStatus,VmsTotalCost,Capacity,VmCount,MemorySize (MB),Processor,CPUCount,CPULimit (MB),CPUShare,DiskUsage (GB) "192.168.10.174","Blade, VMware, VM Server","80dfbf4d-2de0-d811-8001-003013f10162","00:30:13:F1:01:62","","","Managed","-","Running","-","Off","-","-","-","VMware ESX","4.0.0 Build-208167","","192.168.10.174,192.168.10.58","","0","200","0","3071","4( 2 ) Socket * 3.0GHz","","","","0"

[VirtualMachine] #MachineName,MachineType,Uuid,MacAddress,ProductName,ModelName,ManagedStatus,SummaryStatus,PowerState,HardwareStatus,MaintenanceStatus,RunningStatus,ExecuteStatus,EventPolicyStatus,OperatingSystem,OSVersion,HostName,IPAddress,MachineSubType,Cost,MemorySize (MB),Processor,CPUCount,CPULimit (MB),CPUShare,DiskUsage (GB) "MasterMachine","VMware, Virtual Machine","42043949-9fde-6cb5-297c-bc5cd39a6de7","00:50:56:84:78:F6","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","Microsoft Windows Server 2003, Standard Edition (32-bit)","","","","-","0","1024","","1","Unlimited","1000","1.0" "MasterVM","VMware, Virtual Machine","42049b63-168e-86d0-83c8-e57319cb622d

Chapter 2. Command for Setup

39 SigmaSystemCenter 3.5 ssc Command Reference

Page 50: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

","00:50:56:84:09:86","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","Microsoft Windows Server 2003, Standard Edition (32-bit)","","","","-","0","1024","","1","Unlimited","1000","1.0"

[Template] #SoftwareName,CreateTime,SoftwareCost,SoftwareType,VMServerName,SoftwareLocation,ImageName,DiskSize (MB),Description "FullCloneTemplate","","0","Template, FullClone","192.168.10.174","Storage1","FullCloneTemplate","",""

>ssc show machine -ms on -vms 192.168.10.174 -perf -vertical

[VMServer-01] MachineName : 192.168.10.174 MachineType : Blade, VMware, VM Server Uuid : 80dfbf4d-2de0-d811-8001-003013f10162 MacAddress : 00:30:13:F1:01:62 ProductName : ModelName : ManagedStatus : Managed SummaryStatus : - PowerState : Running HardwareStatus : - MaintenanceStatus : Off RunningStatus : - ExecuteStatus : - EventPolicyStatus : - OperatingSystem : VMware ESX OSVersion : 4.0.0 Build-208167 HostName : IPAddress : 192.168.10.174,192.168.10.58 ConnectionStatus : VmsTotalCost : 0 Capacity : 200 VmCount : 0 MemorySize (MB) : 3071 Uptime : 1 days, 06:52:49 LastStartTime : 2010/07/12 9:29:19 CpuUsage (%) : 5 HostCpuUsage (%) : 0 MemoryUsage (%) : 24 HostMemoryUsage (%) : 0

[VirtualMachine-01] MachineName : MasterMachine MachineType : VMware, Virtual Machine Uuid : 42044847-c340-8ec6-a0bf-36b248db25eb : : : [VirtualMachine-02] : : :

[Template-01] SoftwareName : FullCloneTemplate CreateTime :

Chapter 2. Command for Setup

40 SigmaSystemCenter 3.5 ssc Command Reference

Page 51: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

SoftwareCost : 0 SoftwareType : Template, FullClone VMServerName : 192.168.10.174 SoftwareLocation : Storage1 ImageName : FullCloneTemplate DiskSize (MB) : Description :

>ssc show machine -ms on -smartgroup resource:/"Usable ESX" -spec

#UnitName,Uuid,MachineType,MacAddress,SummaryStatus,HardwareStatus,VendorID,MachineTag,MemorySize (MB),Family,ClockSpeed (GHz),NumCores,LogicalProcessors,NumSockets,NumThreads "esx41-1.local","1b29e313-3000-0180-dc11-f0e92b2e8004","Unitary, VMware, VM Server","00:30:13:E3:29:1D","Normal","Ready","NEC","","2046","Intel(R) Xeon(R) CPU 5110 @ 1.60GHz","1.6","4","4","2","4" "esx41-9.local","1429e313-3000-0180-dc11-be70a8d0808a","Unitary, VMware, VM Server","00:30:13:E3:29:18","Normal","Ready","NEC","","2046","Intel(R) Xeon(R) CPU 5110 @ 1.60GHz","1.6","4","4","2","4"

>ssc show machine -vms XenServer01 -vm VM-W2K8

[VirtualMachine]#Name,ManagedStatus,Uuid,MacAddress,Type,SummaryStatus,RunningStatus,ExecuteStatus,PowerStatus,EventPolicyStatus,OperatingSystemStatus,HardwareStatus,MaintenanceStatus,OperatingSystem,OperatinGroup,HostName"VM-W2K8","Managed","f72af3f3-5a91-27a9-c555-6a3021a58854","96:62:7A:57:23:BC","Unitary, Xen, Virtual Machine","Normal","On","Wait","On","On","On","Ready","Off","Microsoft Windows Server 2008 R2 Enterprise","//XenTarget/Win2008R2SP1/VM","VM-W2K8"

[VMServer]#Name,ManagedStatus,Uuid,MacAddress,Type,SummaryStatus,RunningStatus,ExecuteStatus,PowerStatus,EventPolicyStatus,OperatingSystemStatus,HardwareStatus,MaintenanceStatus,OperatingSystem,OperatinGroup,HostName"XenServer01","Managed","ae3cd500-c0ca-11da-8001-001d924476bb","00:1D:92:44:78:91","Unitary, Xen, VM Server","Normal","On","Wait","On","On","On","Ready","Off","XenServer","//XenServer/XS","XenServer01"

[Datastore]#DatastoreName,DatastoreSize (GB),DatastoreUsage (GB),DatastoreFree (GB),DatastoreUtilization (%),DataCenterPath,VmsManagerName"SAN1","200.0","98.5","101.5","49","virtual:/172.16.0.16/XS61","XenServer01,XenServer02"

[Note]

• If a virtual machine server cannot be connected or the virtual machine server's informationcannot be obtained temporarily, the virtual machine server or its performance data(performance, virtual resources) may be displayed as a space.

• If omitted, all machines are displayed.

2.6.6 Updating MachineEdits and updates settings of a machine.

[Syntax]

Chapter 2. Command for Setup

41 SigmaSystemCenter 3.5 ssc Command Reference

Page 52: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc update machine < -name Machine | -uuid UUID > [-model ModelName] [-location Location] [-unitname name] [-tag Tag...] [-slot SlotNo] [-type Type] [-network NICNo,MAC,Switch,Port[...]] [-storage HBANo,WWN[...]] [-vendor [Vendor]] [-cpu [Clock(MHz),ProductName]] [-socketSocketCount] [-thread ThreadCount] [-lcpu LCPUCount] [-core CoreCount] [-memory [size(MB)] [-newuuid Uuid]] [-subtype SubType] [-onlypvm] [-esm]

[Parameters and Options]

<-name Machine | -uuid UUID>(Required)

Specify the name or UUID of the machine.

[-model ModelName] Specify the model name of the machine.

[-location Location] Specify the location of the machine.You can not specify this option for virtual machines.

[-unitname name] Specify the unit name.

[-tag Tag...] Specify the tag. You can specify multiple tags.

[-slot SlotNo] Specify the slot number of the machine.

[-type Type] Specify the type of the machine.You can specify "unitary" or "blade".You can specify this option only for Unitary or Blade machine.

[-networkNICNo,MAC,Switch,Port[...]]

Specify the following network information:NIC No, MAC address, switch, port.Separate the data with "," (comma).Multiple options can be specified.Specify the NIC number in the range of numbers from 1 to 10.You can not specify this option for virtual machines.

[-storage HBANo,WWN[...]] Specify the following storage information:HBA No., address.Separate the data with "," (comma).Multiple options can be specified.Specify the HBA number in the range of numbers from 0 to 9999.You can not specify this option for virtual machine.

[-vendor [Vendor]] Specify the vendor of the machine.You can specify "IBM", "HP", "NEC", "DELL", "Cisco".You can also specify the number corresponding to the vendor.[http://www.iana.org/assignments/enterprise-numbers]If you do not specify Vendor, Unknown(0) will be set as the vendor.You can not specify this option for virtual machines and virtual machineservers.

[-cpu [Clock(MHz),ProductName]] Specify the following CPU information:CPU clock speed, CPU typeSeparate the data with "," (comma).Specify the CPU clock speed in MHz.If you do not specify both Clock and ProductName, the CPU info isdeleted.However, CPU socket count, CPU thread count, logical CPU count andCPU core count are not deleted.

Chapter 2. Command for Setup

42 SigmaSystemCenter 3.5 ssc Command Reference

Page 53: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

You can not specify this option for virtual machines and virtual machineservers.

[-socket SocketCount] Specify the CPU socket count of the machine.You can not specify this option for virtual machines and virtual machineservers.

[-thread ThreadCount] Specify the CPU thread count of the machine.You can not specify this option for virtual machines and virtual machineservers.

[-lcpu LCPUCount] Specify the logical CPU count of the machine.You can not specify this option for virtual machines and virtual machineservers.

[-core CoreCount] Specify the CPU core count of the machine.You can not specify this option for virtual machines and virtual machineservers.

[-memory [size(MB)]] Specify the memory size(MB) of the machine.If you do not specify size, the memory info is deleted.You can not specify this option for virtual machines and virtual machineservers.

[-newuuid Uuid] Specify the UUID.

[-subtype SubType] Specify the sub type of the machine.You can specify "none", "ssc", "vcenter", "rescue".

[-onlypvm] UUID update notice to DPM is restrained.

[-esm] UUID on ESMPRO/ServerManager is renewed.Only -uuid and -newuuid can be specified.

• The information is updated for each information item.

If any error is included in an information item, the information item is not updated, and theupdating process is stopped at that point.

[Syntax examples]

setting the general information>ssc update machine -name machine1 -model "Express5800 110Rd-1" -location web>ssc update machine -uuid 00B9771D-29BB-DB11-8001-003013B8F50D -slot 1 -type blade

setting the network information>ssc update machine -name machine1 -network 1,00:31:13:B8:F6:1D,switch1,lan2>ssc update machine -name machine1 -network 1,00:31:13:B8:F6:1D,switch1,lan2 2,00:31:13:B8:F6:1E

setting the storage information>ssc update machine -name machine1 -storage 0,00:10:48:60:69:00:60:48>ssc update machine -name machine1 -storage 0,00:10:48:60:69:00:60:48 1,00:10:48:60:68:00:60:48

setting the machine specs information>ssc update machine -name machine1 -vendor NEC -cpu 1600,"Intel(R) Xeon(R) CPU 5110 @ 1.60GHz"

Chapter 2. Command for Setup

43 SigmaSystemCenter 3.5 ssc Command Reference

Page 54: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc update machine -name machine1 -socket 2 -thread 4 -lcpu 4 -core 4 -memory 2048

2.6.7 Control of Power to the MachineControls power to a host running in a group, or a machine being managed.

[Syntax]

ssc power-control machine Operation <GroupName [HostName[...]] |

<-name MachineName[...] | -path Path[...] | -uuid UUID[...] | -mac MAC[...]>> [-status < wait | abort>] [-quick]

[Parameters and Options]

Operation(Required) Specify the operation of machine power control.startup : Start up machinesshutdown : Shutdown machinesreboot : Reboot machinessuspend : Suspend machines (enabled only for the virtual machines).

GroupName Specify the target group name.Specify the path to the Tenant, Category, Group, or Model.(E.g. Category, Category/Group/Model)If "HostName" is specified, the Group must be specified for this option.

[HostName] Specify the name of an activated host.Multiple hosts that exist in the specified group (for GroupName) can be specified.If you do not specify this option, all the machines activated in the group are thetargets.

-name MachineName | -path Path | -uuid UUID | -mac ''MAC

Specify the target to be set.Specify at least one of -name, -path, -uuid, and -mac.Multiple parameters can be specified.-name : Specify the name of the machine.-path : Specify the path to the target.E.g.)When specifying a machine, specify it as follows:Operations view: operations:/Category/Group/MachineResource view: resource:/Group/Machine Group/MachineVirtual view: virtual:/VC/DC/VMS/VMWhen specifying a group or rack, specify it as follows:Resource view: resource:/Group/Rack Group/RackOperations view: operations:/Category/GroupYou can omit View Type ("resource:/").-uuid : Specify the uuid of the machine.

Chapter 2. Command for Setup

44 SigmaSystemCenter 3.5 ssc Command Reference

Page 55: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-mac : Specify the primary mac address of the machine.If you specify -path and do not specify any view, the specified path is treated as thepath to the Resource view.About specification of a path, refer to "1.1.5 About Path and GroupPathSpecification (page 11)".

[-status < wait | abort >] Specify the status of the target.wait : The target is machines that are not executed.abort : The target is machines that failed executions.

[-quick] Check the statuses of machines for facility starts at the machine start up.The processing is completed in a shorter time than that of when this option is notspecified.This option is enabled only for the VMware virtual machines.

[Note]

The quick start by the -quick option executes simplified completion confirmation process after thepower on. So such possibility that the machine cannot be used after the operation completion, or thatthe operation is ended with an error becomes higher compared to the normal start operation.However, the process of the operation is completed in a short time.

[Syntax examples]

>ssc power-control machine on Category1>ssc power-control machine on Category1/Group1

>ssc power-control machine shutdown Category1/Group1 Host01>ssc power-control machine shutdown Category1/Group1 Host01 Host02 Host03

>ssc power-control machine on -path resource:/VMGroup -quick

>ssc power-control machine reboot -name machine1>ssc power-control machine reboot -uuid 00B9771D-29BB-DB11-8001-003013B8F50D>ssc power-control machine reboot -mac 00:31:13:B8:F6:1D

2.6.8 BackupBacks up a machine.

[Syntax]

ssc machine backup Path -host HostName... [-concurrent Value] [-interval Value] [-descriptionBackupDescription]

[Parameters and Options]

Path(Required)

Specify the full path to the group.

-host HostName...(Required)

Specify the running host name.(You can specify multiple hosts.)

[-concurrent Value] Specify the max number of a concurrent Processing.(The default value is 1)Specify a value in the range of 1 to 100.

[-interval Value] Specifies an execution interval. (The default value is 0)

Chapter 2. Command for Setup

45 SigmaSystemCenter 3.5 ssc Command Reference

Page 56: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Specify the value in the range of 0 to 99999 seconds.

[-descriptionBackupDescription]

Specify the description of a backup image.(The value must be enclosed in doublequotation marks.)When this option is specified the -host option can be specified only one hostname.

[Syntax examples]

>ssc machine backup category1/group1 -host host1 >ssc machine backup category1/group1 -host host1 host2 host3 >ssc machine backup category1/group1 -host host1 host2 host3 -concurrent 2 -interval 500 >ssc machine backup category1/froup1 -host host1 -description "This is the backup image of host1."

2.6.9 RestoreRestores a machine.

[Syntax]

ssc machine restore Path -host HostName... [-concurrent Value] [-interval Value] [-imagenameImageName] [-force]

[Parameters and Options]

Path(Required)

Specify the full path to the group.

-host HostName...(Required)

Specify a running host name.(You can specify multiple hosts.)

[-concurrent Value] Specify the max number of a concurrent Processing.(The default value is 1)Specify the range of 1-100.

[-interval Value] Specifies an execution interval. (The default value is 0)Specify the value in the range of 0 to 99999 seconds.

[-imagenameImageName]

Specify the image name of a backup you want to restore.To specify the image name, please enter enclosed in the image name of "" in the BackupImage of Software at the Resource view on the Web console.When you perform a restore using this option you will see a message of executionconfirmation. Please specify the -force option if forced to run.Restore of using this option can not be run only one at the same time.

[-force] Specify the -imagename option and run the forced restore by the -force when run a restore.

[Syntax examples]

>ssc machine restore category1/group1 -host host1 >ssc machine restore category1/group1 -host host1 host2 host3 >ssc machine restore category1/group1 -host host1 host2 host3 -concurrent 2 -interval 500 >ssc machine restore -host host1 -iamgename "D:/DeployBackup/image1.lbr"

Chapter 2. Command for Setup

46 SigmaSystemCenter 3.5 ssc Command Reference

Page 57: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.6.10 Registering HardwareRegisters hardware to be managed.

[Syntax]

ssc register hardware Type HardwareName [-account Account] [-p Password] [-scope Scope] [-serialno SerialNumber]

[Parameters and Options]

Type(Required)

Specify a hardware type.[Network Devices]"switch": Switch"lb": LoadBalancer"firewall": Firewall[Storage Devices]"necstorage": NEC Storage"symmetrix": Symmetrix"smi-s": SMI-S"clariion": CLARiiON"netappstorage": NetApp

HardwareName(Required)

Specify a host name or IP address of the target.If you specify "firewall", "clariion" or "netappstorage" in Type,you must specify the IP address.If you specify other types of storage in Type, you must specifythe disk array name.

[-account Account] Specify an account name or domain name of the target.If you specify "firewall", "clariion" or "netappstorage" in Type,you can specify this option.

[-p Password] Specify a password of the target.If you specify "firewall", "clariion" or "netappstorage" in Type,you can specify this option.

[-scope Scope] Specify a scope."0": global, "1": local, "2": LDAP(The default value is 0)If you specify "clariion" in Type, you can specify this option.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.If you specify "necstorage", "symmetrix", "smi-s" in Type, you can specify this option.

[Syntax examples]

>ssc register hardware switch Switch01 >ssc register hardware lb LB01 >ssc register hardware firewall 192.168.1.2 -account root -p xxxxx >ssc register hardware smi-s 0123456789ABCDEF >ssc register hardware necstorage M100 -serialno 0123456789ABCDEF >ssc register hardware clariion 192.168.1.3 -account root -p xxxxx -scope 1 >ssc register hardware netappstorage 192.168.1.4 -account root -p xxxxx

Chapter 2. Command for Setup

47 SigmaSystemCenter 3.5 ssc Command Reference

Page 58: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.6.11 Operation of Maintenance to the MachineMaintains a specified machine.

[Syntax]

ssc maintenance machine Operation <-name MachineName | -fullpath FullPath | -uuid UUID | -macMAC>

[Parameters and Options]

Operation(Required)

Specify the operations of a maintenance machine.poweron: Power on the machine.poweroff: Force to shut down the machine.reset: Reset the machine.powercycle: Execute the power cycle of the machine.dump: Dump the machine.ledon: Turn on an LED of the machine.ledoff: Turn off an LED of the machine.acpishutdown: Execute ACPI shutdown to the machine.

-name MachineName|-fullpath FullPath |-uuid UUID |-mac MAC

Specify a target machine.One of the following options must be specified: -name, -fullpath, -uuid, and -mac.-name: Specify the name of the target machine.-fullpath: Specify the full path to the target machine. The path string must begin with the specified view. If you omit View Type, the specified path is treated as the path to the Resource view. About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".-uuid: Specify the UUID of the target machine. The input format for UUID is:  dddddddd-dddd-dddd-dddd-dddddddddddd  d:0-9, a-f or A-F-mac: Specify the primary MAC address of the target machine. The input format for MAC address is:  xx:xx:xx:xx:xx:xx or xx-xx-xx-xx-xx-xx  x:0-9, a-f or A-F

[Note]

The usable operations are different depending on the type of machine in this command. This tabledescribes the detail.

Type of machine poweron poweroff reset powercycle dump ledon ledoff acpishutdown

Physical machine(including Virtual machine server)

Yes Yes Yes Yes Yes Yes Yes Yes

Virtual machine Yes Yes Yes Yes No No No No

If you want to operate a physical machine (including a virtual machine server), you have to set up anOOB account in advance.

The running machine must be in the Maintenance mode.

[Syntax examples]

Chapter 2. Command for Setup

48 SigmaSystemCenter 3.5 ssc Command Reference

Page 59: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc maintenance machine poweron -name machine1 >ssc maintenance machine poweroff -fullpath resource:/Group1/machine1 >ssc maintenance machine reset -fullpath virtual:/VC1/DataCenter/ESXi1 >ssc maintenance machine powercycle -fullpath operation:/Category/Group/host1 >ssc maintenance machine dump -fullpath Group1/machine1 >ssc maintenance machine ledon -uuid 00B9771D-29BB-DB11-8001-003013B8F50D >ssc maintenance machine ledoff -mac 00:31:13:B8:F6:1D >ssc maintenance machine acpishutdown -name machine1

2.6.12 Configuration Change to the MachineChanges configuration of the activated machine.

[Syntax]

ssc machine chcfg GroupName HostName

[-storage] [-vlan] [-pflow] [-virtualnetwork] [-lb] [-shutdown]

[Parameters and Options]

GroupName(Required)

Specify the path to the group.You cannot specify a tenant, category or model.(E.g.: Tenant/Category/Group, Group)

HostName(Required)

Specify the running host name.

[-storage] Configuration change in storage is executed.You cannot specify this option for a virtual machine.

[-vlan] Configuration change in a VLAN is executed.You cannot specify this option for a virtual machine.

[-pflow] Configuration change in P-Flow is executed.You cannot specify this option for a virtual machine.

[-virtualnetwork] Configuration change in a virtual network is executed.You cannot specify this option for a virtual machine.

[-lb] The machine is detached from the load balancer before the configuration change.

[-shutdown] The machine is shut down before the configuration change.You cannot specify this option for a virtual machine.

[Syntax examples]

>ssc machine chcfg Tenant/Category/Group Host >ssc machine chcfg Tenant/Category/Group Host -shutdown >ssc machine chcfg Group2 Host -vlan -virtualnetwork

[Note]

• If you omit all the configuration options (-storage, -vlan, -virtualnetwork and -lb), theconfiguration change is executed to all configurations.

If you specify one or more of the configuration options, the configuration change correspondingto the specified options is executed.

Chapter 2. Command for Setup

49 SigmaSystemCenter 3.5 ssc Command Reference

Page 60: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.6.13 Search for a MachineSearch for a machine.

[Syntax]

ssc search machine Keyword [-all] [-vertical]

[Parameters and Options]

Keyword Specify a keyword. Specify it within 100 characters.

[-all] Specify when searching for all machines.If omitted, the machines that assigned to the host are searched.

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc serch machine xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx >ssc search machine xx:xx:xx:xx:xx:xx -all >ssc search machine machine01 -vertical

2.6.14 Displays Machine Status and Machine Place HistoryDisplays machine status and machine place history.

[Syntax]

ssc machinehistory show [MachinePath ...] [-start StartTime] [-end EndTime] [-period TimeSpan]

[Parameters and Options]

[MachinePath ...] Specify the path of target machines.If omitted, all machines are targeted.

[-start StartTime] The history that logged since the specified date and time is displayed.If omitted, the history that logged since oldest date and time is displayed.Format: [yyyy/mm/dd] hh:mm[:ss] In case of 12:34:56, January 23, 2016:  "2016/01/23 12:34:56" In case of 12:34, on the current date:  12:34

[-end EndTime] The history that logged before the specified date and time is displayed.If omitted, the history that logged before the current time is displayed. Format: [yyyy/mm/dd] hh:mm[:ss] In case of 12:34:56, January 23, 2017:  "2017/01/23 12:34:56" In case of 12:34:56, on the current date:  12:34:56

[-period TimeSpan] Specify a display period.Format: d | [d.]hh:mm[:ss] In case of 3 days: 3 In case of 3 hours: 03:00

Chapter 2. Command for Setup

50 SigmaSystemCenter 3.5 ssc Command Reference

Page 61: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 In case of one day, 12 hours, 34 minutes, and 56 seconds:  1.12:34:56

[Syntax examples]

>ssc machinehistory show>ssc machinehistory show opration:/Group/Machine01 resource:/MachineGroup/Machine02>ssc machinehistory show opration:/Group/Machine01 resource:/MachineGroup/Machine02 -start "2016/01/23 12:34:56">ssc machinehistory show -start "2016/01/23 12:34" -end 12:34>ssc machinehistory show -start "2016/01/23 12:34" -period 14>ssc machinehistory show -end 12:34 -period 14.12:34

[Display examples]

#DateTime,JobId,EventId,MachineName,Revision,SummaryStatus,PowerStatus,HardwareStatus,HardwarePartsStatus,ManagedStatus,ManagedSubStatus,VMServer,ConnectionStatus"2016/01/23 12:34:56","00099","UC11111","vm01","1","Normal","On","Ready","Normal","vms02","-""2016/02/23 12:34:56","00099","UC11111","vm02","1","Normal","On","Ready","Normal","vms03","-""2016/03/23 12:34:56","00098","RE11110","vm03","1","Normal","On","Ready","Abnormal","-","Connected"

2.7 Machine Account2.7.1 Creating Machine Account

Creates the account of a managed machine or unmanaged machine.

In SigmaSystemCenter, you can configure the account for each connection type used in

management, monitoring, and controlling managed machines.

[Syntax]

ssc machine-account create < -uuid UUID | -machine MachineName > -type ConnectionType [-ipIPAddress] -u UserName [-p Password] [-overwrite] [-mon on|off]

[Parameters and Options]

< -uuid UUID | -machineMachineName >(Required)

Specify UUID of a machine or a name of the machine to which you intend toregister an account. You can specify an unmanaged machine.

-type ConnectionType(Required)

Specify a connection type. Only "oob" or "ib" is supported.OOB is used for Out-of-Band-Management.

[-ip IPAddress] Specify an IP address when -type is "oob".

-u UserName(Required)

Specify a user name. Depending on a login system of a connection destination, aspecification might be case sensitive.

[-p Password] Specify a password. If you do not specify this option, no password is specified.

Chapter 2. Command for Setup

51 SigmaSystemCenter 3.5 ssc Command Reference

Page 62: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you specify a null character ("") in Password, the password is regarded as notspecified.

[-overwrite] If a machine account is already registered, the account is overwritten. If you do notspecify this option, if an account is already registered, an error occurs.

[-mon on|off] Specify a Monitoring Setting.-type is effective in case of "oob" only.

[Syntax examples]

>ssc machine-account create -machine SV0100 -type oob -ip 192.168.1.100 -u User01 -p xxxxxx >ssc machine-account create -uuid 7DEB0F09-0BC6-495f-9CF6-A15EBC88BCC9 -type oob -ip 192.168.1.101 -u User02 >ssc machine-account create -machine SV0200 -type oob -ip 192.168.1.102 -u User01 -p "" -overwrite >ssc machine-account update -uuid 1CC9EBCC-7091-498d-84D2-B2F168690BC8 -type oob -p xxxxxxx >ssc machine-account create -machine SV0100 -type oob -ip 192.168.1.100 -u User01 -p xxxxxx -mon on

2.7.2 Updating Machine AccountUpdates the account of a managed machine or unmanaged machine.

[Syntax]

ssc machine-account update < -uuid UUID | -machine MachineName > -type ConnectionType [-ipIPAddress] [-u UserName] [-p Password] [-mon on|off]

[Parameters and Options]

< -uuid UUID | -machineMachineName >(Required)

Specify the UUID of a target machine or machine name.

-type ConnectionType(Required)

Specify a connection type. Only "oob" or "ib" is supported.OOB is used for Out-of-Band-Management.

[-ip IPAddress] Specify an IP address to update when -type is "oob".

[-u UserName] Specify the user name to update when -type is "oob". Depending on a loginsystem of a connection destination, a specification might be case sensitive.

[-p Password] Specify a password to update. If you specify a null character (""), the passwordis deleted.

[-mon on|off] Specify a Monitoring Setting.-type is effective in case of "oob" only.

• Specify at least one of the -ip, -u, -p and -mon options.

[Syntax examples]

>ssc machine-account update -machine SV0100 -type oob -ip 192.168.1.100 -u User01a -p xxxxxx >ssc machine-account update -uuid 1CC9EBCC-7091-498d-84D2-B2F168690BC8 -type oob -ip

Chapter 2. Command for Setup

52 SigmaSystemCenter 3.5 ssc Command Reference

Page 63: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

192.168.1.200 >ssc machine-account update -machine SV0200 -type oob -u User02a >ssc machine-account update -uuid 3571C728-EE55-4a43-A8AE-DDDA3ED8EBA0 -type oob -p xxxxxxx >ssc machine-account update -machine SV0100 -type oob -mon off

2.7.3 Deleting Machine AccountDeletes an account of a managed machine or unmanaged machine.

[Syntax]

ssc machine-account delete < -uuid UUID | -machine MachineName > -type ConnectionType

[Parameters and Options]

< -uuid UUID | -machine MachineName >(Required)

Specify a UUID of a target machine or machine name.

-type ConnectionType(Required)

Specify a connection type. Only "oob" or "ib" is supported.OOB is used for Out-of-Band-Management.

[Syntax examples]

>ssc machine-account delete -machine SV0100 -type oob >ssc machine-account delete -uuid 503BDAA8-19A1-793F-8A39-198D1EFEC439 -type oob

2.7.4 Displaying Machine AccountDisplaying information of an account of a managed machine or unmanaged machine.

[Syntax]

ssc machine-account show [ -uuid UUID | -machine MachineName ] [-setting]

[Parameters and Options]

[ -uuid UUID | -machineMachineName ]

Specify the UUID of a target machine or machinename.If you do not specify UUID or MachineName, all registered machines becometargets

[-setting] Displays in the csv format.

[Syntax examples]

>ssc machine-account show >ssc machine-account show -setting >ssc machine-account show -machine SV0100 >ssc machine-account show -machine SV0100 -setting >ssc machine-account show -uuid 503BDAA8-19A1-793F-8A39-198D1EFEC439 >ssc machine-account show -uuid 503BDAA8-19A1-793F-8A39-198D1EFEC439 -setting

Chapter 2. Command for Setup

53 SigmaSystemCenter 3.5 ssc Command Reference

Page 64: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Display examples]

>ssc machine-account show

[1] MachineName : SV0100 UUID : 503BDAA8-19A1-793F-8A39-198D1EFEC439 MachineAccount UserName : user01 HostName : 192.168.1.100

Connection Status : Connected [2009/06/09 13:00:00] Monitoring : ON

[2] MachineName : SV0101 UUID : 555BDAA8-19A1-793F-8A39-198D1EFEEEEE MachineAccount UserName : user02 HostName : 192.168.1.101

Connection Status : Connected [2009/06/09 13:15:00] Monitoring : OFF

>ssc machine-account show -setting

#MachineName,UUID,UserName,HostName,Connection Status,Monitoring SV0100,503BDAA8-19A1-793F-8A39-198D1EFEC439,user01,192.168.1.100,Connected [2009/06/09 13:00:00],ON SV0101,555BDAA8-19A1-793F-8A39-198D1EFEEEEE,user02,192.168.1.101,Connected [2009/06/09 13:15:00],OFF

>ssc machine-account show -machine SV0101

MachineName : SV0101 UUID : 555BDAA8-19A1-793F-8A39-198D1EFEEEEE MachineAccount UserName : user02 HostName : 192.168.1.101

Connection Status : Connected [2009/06/09 13:15:00] Monitoring : ON

>ssc machine-account show -uuid 555BDAA8-19A1-793F-8A39-198D1EFEEEEE

MachineName : SV0101 UUID : 555BDAA8-19A1-793F-8A39-198D1EFEEEEE MachineAccount UserName : user02 HostName : 192.168.1.101

Connection Status : Connected [2009/06/09 13:15:00] Monitoring : OFF

Chapter 2. Command for Setup

54 SigmaSystemCenter 3.5 ssc Command Reference

Page 65: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc machine-account show -uuid 555BDAA8-19A1-793F-8A39-198D1EFEEEEE -setting

#MachineName,UUID,UserName,HostName,Connection Status,Monitoring SV0101,555BDAA8-19A1-793F-8A39-198D1EFEEEEE,user02,192.168.1.101,Connected [2009/06/09 13:15:00],ON

2.8 Group2.8.1 Creating Group

Creates a tenant, category, group or model.

[Syntax]

ssc create group GroupName <[-tenant] | [-category] | [-ostype OperatingSystemType] | [-modeltypeModelType]> [-machinetype MachineType] [-count Count] [-priority Priority] [-pool <group |shared>] [-dpmmanager DPMManager] [-vnet VirtualNetworkName...] [-optimized <on | off | none>][-dc DatacenterName] [-prestriction] [-resource ResourcePoolName] [-resourceid Id] [-scaleoutgroup<off | [max=Value] [min=Value] [scaleoutcount=Value] [scaleincount=Value] [shutdown=<on |off>]>] [-mailto E-mailAddress]

[Parameters and Options]

GroupName(Required)

Specify the name of the tenant, category, group or model to be created.GroupName must be specified with a path to a category, group or model.(E.g. Tenant, Category, Category/Group, Category/Group/Model)Note: If there is an uncreated category in the path of a category or group, thecategory is created. In addition, a group in the path of a model must be an existinggroup.If you specify the -tenant option, a tenant is created;if you specify the -category option, a category is created;if you specify the -ostype option, a group is created;if you specify the -modeltype option, a model is created.

[-tenant] Specify this option to create a tenant.

[-category] Specify this option to create a category.

[-ostypeOperatingSystemType]

Specify the OS type.You cannot omit this option to create a group.You can specify one of the following OperatingSystemTypes.OperatingSystemType : OS type"Linux": Linux"Windows-client": Windows Client"Windows": Windows Server

[-modeltype ModelType] Specify a model type that you configure to a model from the following types:ModelType: a model type"Physical": Creating a Physical model"VM": Creating a VM model"VMServer": Creating a VM Server model"PublicCloud": Creating a Public Cloud modelYou cannot omit this option to create a model.

Chapter 2. Command for Setup

55 SigmaSystemCenter 3.5 ssc Command Reference

Page 66: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you do not specify this option, a group is created.

[-machinetype MachineType] Specify a machine type that you configure to a group from the following types:MachineType: a machine type"Physical": Physical"VM": VM"VMServer": VM Server"PublicCloud": Public CloudIf you do not specify -machinetype, "VM" is specified.

[-count Count] Specify the number of groups or models.Specify the number greater than 0.If you specify the number greater than 1, GroupName is sequentially numberedstarting with 1.The default number is 1.

[-priority Priority] Specify priority of a group or model in the range of the number from 1 to 10.The default priority is 1.

[-pool <group | shared>] Specify a search mode of a pool machine.You can specify this option only when you create a group."group": To search only machines in a group pool. (GroupOnly)"shared": To search the shared pool if the target machine cannot be found in thegroup pool. (GroupAndShared)

[-dpmmanagerDPMManager]

Specify an IP address of DPM Server.This option is enabled if ModelType / MachineType is VM, or tenant / categoryoption is specified.

[-vnetVirtualNetworkName...]

Specify a virtual network name.This option is enabled if the ModelType or the MachineType is VM or PublicCloud.You can specify up to four names dividing them with a space.NICs are assigned in the specified order from NIC #1.Note: Even if an error occurred in configuring a virtual network setting, a model iscreated.In that case, you need to reconfigure a virtual network setting of the target modelthrough the Web Console.

[-optimized <on | off |none>]

Specify whether Optimized Startup is enabled, disabled, or not-set.This option is enabled if ModelType / MachineType is VMServer / VM, or tenant /category option is specified.

[-dc DatacenterName] Specify a datacenter name.Specify a path of the Virtual view.This option is enabled if the ModelType or the MachineType is VMServer.(E.g. Virtual manager/Datacenter)

[-prestriction] Enables the Optimized Placement Rule.If you do not specify this option, the setting of the Optimized Placement Rule isdisabled.This option is enabled if the ModelType or the MachineType is VMServer.

[-resourceResourcePoolName]

Specify the resource pool name to be used.This option is enabled if ModelType / MachineType is VM, or tenant / categoryoption is specified.

[-resourceid Id] Specify a resource management ID.

Chapter 2. Command for Setup

56 SigmaSystemCenter 3.5 ssc Command Reference

Page 67: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This option is enabled if the GroupType is tenant.

[-scaleoutgroup <off |[max=Value][min=Value][scaleoutcount=Value][scaleincount=Value][shutdown=<on | off>]>]

Configures the group as a scale out group.You cannot specify leading or trailing spaces in the equal ("=").off : The group is not configured as a scale out group.You cannot specify this option along with the other options.max=Value : Specify the maximum running machine count in the range of thenumber from 1 to 10000.min=Value : Specify the minimum running machine count in the range of thenumber from 0 to 10000.scaleoutcount=Value : Specify the running machine count at scale-out in the range ofthe number from 1 to 100.scaleincount=Value : Specify the running machine count at scale-in in the range ofthe number from 1 to 100.shutdown=<on | off> : Specify whether the running machine is shut down at scalein.on : Shuts down the machine.off : Does not shut down the machine.

[-mailto E-mailAddress] Specify an e-mail address.You can specify this option only when you create a group.

[Available options for each create type]

Create Types Options

Tenant -tenant-resourceid-dpmmanager-optimized

Category -category-resource-dpmmanager-optimized

Group(Physical)

-ostype-machinetype-count-priority-pool-scaleoutgroup-mailto

Group(VM)

-ostype-machinetype-count-priority-pool-scaleoutgroup-mailto-dpmmanager-resource-vnet

Chapter 2. Command for Setup

57 SigmaSystemCenter 3.5 ssc Command Reference

Page 68: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-optimized

Group(VMServer)

-ostype-machinetype-count-priority-pool-scaleoutgroup-mailto-dc-prestriction-optimized

Group(PublicCloud)

-ostype-machinetype-count-priority-pool-vnet-scaleoutgroup-mailto

Model(Physical)

-modeltype-count-priority

Model(VM)

-modeltype-count-priority-dpmmanager-resource-vnet-optimized

Model(VMServer)

-modeltype-count-priority-dc-prestriction-optimized

Model(PublicCloud)

-modeltype-count-priority-vnet

[Syntax examples]

>ssc create group VMGroup -ostype Windows -machinetype VM -resource ResourcePool -dpmmanager 127.0.0.1 >ssc create group Category1/Group001/model1 -modeltype vm -count 2 -priority 3 -vnet "VM Network" >ssc create group Category1/Group001/model2 -modeltype vm

Chapter 2. Command for Setup

58 SigmaSystemCenter 3.5 ssc Command Reference

Page 69: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-dpmmanager 192.168.1.1 >ssc create group Group003 -ostype windows -count 2 >ssc create group Group003/model1 -modeltype vm -priority 4 >ssc create group Category1/Group01/VmsModel01 -modeltype VMServer -dc VC/Datacenter1 -prestriction

2.8.2 Updating Group SettingEdits or updates a setting for a tenant, category, group or model.

[Syntax]

ssc update group GroupName [-pool <group | shared>] [-policy PolicyName...] [-higherpolicy <on |off>] [-priority Priority] [-dpmmanager [DPMManager]] [-vnet VirtualNetworkName...] [-optimized<on | off | none>] [-dc [DatacenterName]] [-vmoptimize <on | off>] [-loadbound <[low=value][high=value] [dl=value] [du=value]>] [-reserve ReserveMachineNumber] [-prestriction <on | off>] [-domain name [account] [password]] [-dns [primary] [secondary] [tertiary]] [-resource[ResourcePoolName]] [-balancelevel n] [-scaleoutgroup <off | [on] [max=Value][min=Value] [scaleoutcount=Value] [scaleincount=Value] [shutdown=<on | off>]>] [-mailto E-mailAddress]

[Parameters and Options]

GroupName(Required)

Specify The Tenant, Category, Group or Model to be updated.Specify the path to the group or model.E.g.) Tenant, Category, Category/Group, Category/Group/Model

[-pool <group | shared>] Specify the search mode of the pool machine.This option is enabled when you specify the group in GroupName."group" : Searche machines in the group pool (GroupOnly)."shared": Searche machines in the shared pool if the target machine cannot befound in the group pool (GroupAndShared).

[-policy [PolicyName]] Updates the policy name. If you do not specify PolicyName, the policy setting isnot configured.

[-higherpolicy <on | off>] Specify whether you use the policy setting of the group.This option is enabled if GroupName is Model.on: Enable the use of the policy setting in the group.off: Disable the use of the policy setting in the group.

[-priority Priority] Update priority of the group or model.Specify it in the range of the number from 1 to 10.

[-dpmmanager[DPMManager]]

Specify the IP address of DPM Server.If you do not specify DPMManager, the setting is not configured.This option is enabled if model type or machine type of GroupName is VM.

[-vnet[VirtualNetworkName...]]

Specify the virtual network name.This option is enabled if the model type or machine type of GroupName is VM orPublicCloud.You can specify up to four names (from NIC#1 to NIC#4).This option deletes all configured settings and configures newly specified settings.You cannot add, edit, or delete the existing settings.In configuring, you need to include a virtual network name that you do not intendto change.

Chapter 2. Command for Setup

59 SigmaSystemCenter 3.5 ssc Command Reference

Page 70: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you do not specify VirtualNetworkName, the virtual network name is notconfigured.

[-optimized <on | off | none>] Configure the Optimized Startup.This option is enabled if the model type or machine type of GroupName is VM orVM Server.on: Enable the Optimized Startup.off: Disable the Optimized Startup.none: Inherit from the upper layer. If all the upper layers are set to "none", thisoption is disabled.

[-dc [DatacenterName]] Specify the datacenter name. Specify the path to the Virtual view.(E.g. Virtual manager/Datacenter)If you do not specify DatacenterName, the datacenter name is not configured.This option is enabled if the model type or machine type of GroupName is VMServer.

[-vmoptimize <on | off>] Configures the VM Optimized Placement.This option is enabled if the model type or machine type of GroupName is VMServer.on: Enable the VM Optimized Placement.off: Disable the VM Optimized Placement.

[-loadbound <[low=value][high=value] [dl=value][du=value]>]

Configure the load balancing and power save of the VM Optimized Placement.Specify the value with the number in the range of 0 to 100.You cannot specify leading or trailing spaces in the equal ("=").You need to specify "low", "high", "dl", or "du".This option is enabled if the model type or machine type of GroupName is VMServer."low": Specify the low-load border."high": Specify the high-load border."dl": Specify the lower limit of activation target range."du": Specify the upper limit of activation target range.

[-reserveReserveMachineNumber]

Specify the number of spare machines for the VM Optimized Placement.Specify it in with the number in the range of 0 to 9.This option is enabled if the model type or machine type of GroupName is VMServer.

[-prestriction <on | off>] Configure the Optimized Placement Rule.This option is enabled if the model type or machine type of GroupName is VMServer.on: Enable the Optimized Placement Rule.off: Disable the Optimized Placement Rule.

[-domain name [account][password]]

Specify the domain (suffix) name.If your environment is Windows, specify account and password as well.

[-dns [primary][secondary][tertiary]]

Specify the IP address of the DNS server."primary": Specify the primary DNS."secondary": Specify the secondary DNS (Windows, Linux)."tertiary": Specify a tertiary DNS (Linux).If you do not specify the IP Address, the dns setting is not configured.

[-resource[ResourcePoolName]]

Specify the resource pool name to be used. If you do not specifyResourcePoolName, the resource pool name is not configured. This option is

Chapter 2. Command for Setup

60 SigmaSystemCenter 3.5 ssc Command Reference

Page 71: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

enabled if the GroupName is category or a model type or machine type ofGroupName or a model that belongs to GroupName is VM.

[-balancelevel n] Specify the balance level for Optimized Startup.This option is enabled if the model type or machine type of GroupName is VM orVM Server.The value of n can be 0, 1, 2, 3, or "none".0: When starting VM, the current VM Server, whose hosts are the target VM, isgiven priority.-If total value of active VM's cost exceeds capacity value in the current VM server,the target VM will start on another VM server. In this case, active VM servers withlarge capacity remaining are given priority.-If the current VM server is inactive, active VM servers with large capacityremaining are given priority.-Neither CPU usage nor memory usage is considered when searching thedestination VM Server.1: When starting VM, the current VM Server, whose hosts are the target VM, isgiven priority.-If the total value of active VM's cost exceeds the capacity value at the current VMServer, the target VM will start on another VM Server. In this case, the active VMServers with low CPU usage are given priority.-If the current VM server is inactive, active VM servers with low CPU usage aregiven priority.-If CPU usage exceeds upper limit of target range or memory usage exceeds upperlimit in the current VM server, active VM servers with low CPU usage are givenpriority.2: When starting VM, the active VM servers with low CPU usage are givenpriority.3: When starting VM, the VM servers with low CPU usage, including inactiveones, are given priority. The inactive VM servers are likely to be selected becausetheir CPU usage are considered to be zero.none: Inherits from the upper layer. If all the upper layers are set to "none", defaultlevel "1" is used.

[-scaleoutgroup <off | [on][max=Value][min=Value][scaleoutcount=Value][scaleincount=Value][shutdown=<on | off>]>]

It's established as a scale out group.You cannot specify leading or trailing spaces in the equal ("=").off : Disables the setting for the scale out group.You cannot specify this option with other options.on : Enables the setting of the scale out group.max=Value : Specify the maximum number of running machines in the range ofthe number from 1 to 10000.min=Value : Specify the minimum number of running machines in the range of thenumber from 0 to 10000.scaleoutcount=Value : Specify the number of running machines at scale-out in therange of the number from 1 to 100.scaleincount=Value : Specify the number of running machines at scale-in in therange of the number from 1 to 100.shutdown=<on | off> : Specify whether the running machine is shut down atscalein.on : Shut down the machine.off : Not shut down the machine.

[-mailto E-mailAddress] Specify the report destination e-mail address.This option is enabled when you specify the group in GroupName.

Chapter 2. Command for Setup

61 SigmaSystemCenter 3.5 ssc Command Reference

Page 72: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Available options for each group type]

Group Type Options

Tenant -tenant-dpmmanager-optimized

Category -category-resource-dpmmanager-optimized

Group(Physical)

-priority-pool-policy-domain-dns-scaleoutgroup-mailto

Group(VM)

-priority-pool-policy-domain-dns-scaleoutgroup-mailto-dpmmanager-vnet-optimized-resource-balancelevel

Group(VMServer)

-priority-pool-policy-domain-dns-scaleoutgroup-mailto-dc-vmoptimize-loadbound-reserve-prestriction

Group(PublicCloud)

-priority-pool-policy-vnet-domain

Chapter 2. Command for Setup

62 SigmaSystemCenter 3.5 ssc Command Reference

Page 73: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-dns-scaleoutgroup-mailto

Model(Physical)

-priority-policy-higherpolicy

Model(VM)

-priority-policy-higherpolicy-dpmmanager-vnet-optimized-resource-balancelevel

Model(VMServer)

-priority-policy-higherpolicy-dc-vmoptimize-loadbound-reserve-prestriction

Model(PublicCloud)

-priority-policy-higherpolicy-vnet

[Syntax examples]

>ssc update group VMGroup -resource ResourcePool -dpmmanager 127.0.0.1 >ssc update group Category/group1 -pool shared -policy "PolicyName" >ssc update group Category/group1 -priority 2 -policy >ssc update group Category/group1/model -dpmmanager 192.168.1.1 -optimized on >ssc update group Category/group1/model -dpmmanager -optimized off

2.8.3 Deleting GroupDeletes a Tenant, Category, Group or Model.

[Syntax]

ssc delete group GroupName [GroupName...] [-i]

[Parameters and Options]

GroupName(Required)

Specify the path to the Tenant, Category, Group or Model.(E.g. Tenant,Tenant/Category,Category/Group,Category/Group/Model)When there are groups in the Tenant or Categorywhich you specify, you cannot delete it.When there are activated machines in the group, or a stand by machine in the group pool,

Chapter 2. Command for Setup

63 SigmaSystemCenter 3.5 ssc Command Reference

Page 74: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

you cannot delete this group.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete group Category1/Group01 >ssc delete group Group-A001 Group-B001 >ssc delete group Group-C001 Group-D001 -i

2.8.4 Displaying Group SettingDisplays the setting of a tenant, a category, or a group.

[Syntax]

ssc show group GroupName [-group] [-model [ModelName...]] [-path]

[Parameters and Options]

GroupName Specify a group to display.Specify a path to a tenant, a category, or a group.When you specify a path to a tenant or a category, the groups under the tenant or thecategory are targeted.To display the settings of all groups, specify "/."(E.g., Category, Category/Group)

[-group] Displays the contents of a group setting.

[-model[ModelName…]] Displays the contents of a model setting.You can display a specific model setting by specifying the model name.

[-path] Displays the path.If you do not specify GroupName, the list of tenant, category, and group of the tophierarchy are displayed.

[Syntax examples]

>ssc show group Category1 >ssc show group Category1/Group01 >ssc show group Group-A001 -group >ssc show group Group-B001 -model >ssc show group Group-B001 -model Model-B001 Model-B002 >ssc show group Category1 -path

2.8.5 Setting Machine ProfileSets a machine profile.

[Syntax]

ssc set profile Path <ProfileName | [-cost costValue] [-cpu count=value [share=value][reservation=value] [limit=value]] [-mem size=value [share=value] [reservation=value][limit=value]] [-vnet VirtualNetworkName...] [-vnettype <vlan | network | edit>...] [-bandcontrolnic=value [type=value] [limit=value burstlimit=value burstsize=value], ...] [-systemdisk [size=value][type=<thin | thick>] [independent] [datastoretag=value | datastore] [file=value] [share=value][reservation=value] [limit=value]] [-extdisk [size=value] [ctrl=value [position=value]] [type=<thin |

Chapter 2. Command for Setup

64 SigmaSystemCenter 3.5 ssc Command Reference

Page 75: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

thick | rdm-p | rdm-v>] [independent] [datastoretag=value | datastore] [lun] [file=value][share=value] [reservation=value] [limit=value] , ...] | -delete [cost | cpu | mem | vnet | systemdisk |extdisk]> [-host HostName]

[Parameters and Options]

Path(Required)

Specify the full path to the target operation group, model or host.You can omit View Type ("operations:/").The Tenant and Category cannot be specified.E.g.:When specifying the group name: Category/GroupWhen specifying the model name: Category/Group/ModelWhen specifying the host name: Category/Group/HostWhen specifying the host name (When View Type is specified): operations:/Category/Group/Host

ProfileName Specify the name of the named machine profile.You can specify this option along with [-host] only.

[-cost costValue] Specify the cost value.Specify a value in the range of 1-1000.You cannot specify this option along with ProfileName and -delete.

[-cpu count=value[share=value][reservation=value][limit=value]]

Specify the number of CPUs, the shared value, the reservation value and the limitvalue.The number of CPUs must be specified.You cannot specify leading or trailing spaces in the equal ("=").You cannot specify this option along with ProfileName and -delete.count: Specify the number of CPUs.Specify a value in the range of 1-9999. (E.g.: count=2)share: Specify the CPU shared value.The CPU shared value settings for each virtualization infrastructure are as follows:VMware Setting * CPU countHyper-V Setting/10Xen Setting * 256/1000KVM Setting * 1024 / 1000Specify one of the following values:"he": Highest (4000)"h": High (2000)"n": Normal (1000)"l": Low (500)"le": Lowest (250)"1" - "99999": Manual(E.g.: share=h, share=30)Optional. The default value is "n".reservation: Specify the CPU reservation value (MHz).Specify a value in the range of 0-99999.(E.g.: reservation=1000)

Chapter 2. Command for Setup

65 SigmaSystemCenter 3.5 ssc Command Reference

Page 76: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Optional. The default value is 0.limit: Specify the upper limit of a CPU resource assignment (MHz).Specify a value in the range of 0-99999.(E.g.: limit=1500)Optional. The default value is 0 (unlimited).

[-mem size=value[share=value][reservation=value][limit=value]]

Specify the memory size, the shared value, the reservation value, and the limitvalue.You cannot specify leading or trailing spaces in the equal ("=").You cannot specify this option along with ProfileName and -delete.size: Specify the memory size (MB).Specify a value in the range of 1-99999999 (MB).(E.g.: size=512)share: Specify the memory shared value.The memory shared value settings for each virtualization infrastructure are asfollows:VMware Setting * the Memory size / 100Hyper-V Setting * 5Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h": High (2000)"n": Normal (1000)"l": Low (500)"0" - "10000": Manual(E.g.: share=h, share=100)Optional. The default value is "n".reservation: Specify the memory reservation value (MB).Specify the value in the range of 0-99999999.(E.g.: reservation=2048)Optional. The default value is 0.limit: Specify the upper limit of a memory size (MB).Specify the value in the range of 0-99999999.(E.g.: limit=4096)Optional. The default value is 0 (unlimited).

[-vnetVirtualNetworkName...]

Specify the virtual network name.You can specify up to ten names divided by a space.NICs are assigned in the specified order from NIC #1.You cannot specify this option along with ProfileName and -delete.The upper limit of the setting number of possible NICs uses the reflecting machine-specific information of DeploymentManager. And for Windows Vista or later, it's"8", for Windows 2000, Windows Server 2003 and Windows XP, it's "4".

[-vnettype <vlan | network |edit>...]

Specify the network type.Enter the same number as the number of virtual networks that you specified for the -vnet option.NICs are assigned in the specified order from NIC #1.When you want to specify a VLAN name, set "vlan."When you want to specify a logical network name, set "network."

Chapter 2. Command for Setup

66 SigmaSystemCenter 3.5 ssc Command Reference

Page 77: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When you want to specify arbitrary network name, set "edit".When omitted, it'll be VLAN or the arbitrary network.You cannot specify this option along with ProfileName and -delete.

[-bandcontrol nic=value[type=value] [limit=valueburstlimit=valueburstsize=value], ...]

Specify the presence of Network Band Control.nic :Specify the NIC number.type : Specify the control type for the virtual NIC.Specify either of in / out.Optionale. The default type is out.Hyper-V can be set out only.limit : Specify the upper [kbits/s] of Band Width.burstlimit : Specify the upper [kbits/s] of Band Width when burst.burstsize : Specify the burst size [kbytes].Specify values for the limit, burstlimit, and burstsize,to specify the presence of Network Band Control.You cannot omit.Specify 0 for the limit, burstlimit or burstsize value,to specify unrestrictedly.You cannot omit.Not specify a limit, burstlimit or burstsize value,to disable Network Band Control.

[-systemdisk [size=value][type=<thin | thick>][independent][datastoretag=value |datastore] [file=value][share=value][reservation=value][limit=value]]

Set the system disk information.You cannot specify this option along with ProfileName and -delete.size: Specify the size of a system disk in megabytes (MB).type: Specify the type of system disk.Specify either of thin or thick.Optional. The default type is thick.independent: A disk is set to the Independent mode by specifying "independent" forthis option.The Independent mode is only enabled in the VMware environment.datastore: Specify the datastore name of the system disk.datastoretag: Specify the datastore tag of the system disk.Specify either of "datastore" or "datastoretag". Optional.file: Specify the existing path of disk file. Optional.share: Specify a disk shared value.The disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.

Chapter 2. Command for Setup

67 SigmaSystemCenter 3.5 ssc Command Reference

Page 78: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The default value is "n".reservation : Specify the disk allocation value(IOPS).Specify a value in the range of 0-2147483647.The reservation is only enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment (IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-extdisk [size=value][ctrl=value [position=value]][type=<thin | thick | rdm-p |rdm-v>][independent][datastoretag=value |datastore][lun] [file=value][share=value][reservation=value][limit=value], ...]

Set the extended disk information.(You can specify multiple items.)When you specify multiple items, separate the data with commas (","). (Max 6)You cannot specify this option along with ProfileName and -delete.size: Specify the disk size.Specify a value in the range of 10-99999999 (MB).When the Disk Type is specified "rdm-p" or "rdm-v",specify a value in the range of 1-10000000 (GB) and a multiple of the LUN sizerange (default value is 10).ctrl: Specify the controller to which an extended disk is connected.Specify the following value:PCIxIDExSCSIxSATAxAutoDetect (auto detection)x: Bus Numberposition: Specify the position where an extended disk is connected.You can specify the following values:0-31 (for PCI)0-1 (for IDE)0-63 (for SCSI)0-29 (for SATA)When 'ctrl' is 'AutoDetect', it cannot be specified.The possible value for controllers and positions where the extended disk is attacheddepends on virtualization infrastructures.For possible values, refer to the "1.1.8 Controllers and Location Data for EachVirtualization Infrastructure Product (page 19)".type: Specify the type of extended disk.Specify one of thin / thick / rdm-p / rdm-v.Optional. The default type is thick.rdm-p: RDM (physical)rdm-v: RDM (virtual)independent: A disk is set to the Independent mode by specifying "independent" forthis option.The Independent mode is enabled in the VMware environment.

Chapter 2. Command for Setup

68 SigmaSystemCenter 3.5 ssc Command Reference

Page 79: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When you specify the disk type is RDM(physical), you cannot specify"Independent" for the mode.*case of type=thick / thindatastoretag: Specify the datastore tag of the extended disk.datastore: Specify the location of the extended disk.Specify either of "datastore" or "datastoretag".Optional.The extended disk is created in the same location as where the system disk is createdby default.*case of type=rdm-p / rdm-vlun: Specify the target LUN (Tag).file: Specify the path of the disk file.share: Specify the disk shared value.The disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify the disk reservation value (IOPS).Specify a value in the range of 0-2147483647.The reservation is enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment (IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

-delete[cost | cpu | mem | vnet |systemdisk | extdisk]

Delete the specified option values.You can specify this option only when you intend to delete other option values.Note: If you do not specify any option name, all option values are deleted.You can specify this option along with [-host] only.

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Path.Specify this option if there is a model with the same name as the target host.

[Note]

Chapter 2. Command for Setup

69 SigmaSystemCenter 3.5 ssc Command Reference

Page 80: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• If you specify the -cpu option, the -mem option, the -systemdisk option and the -extdisk option,be sure to specify all of their option settings.

[Syntax examples]

>ssc set profile Group1 middle >ssc set profile Group1 -cost 100 >ssc set profile Group1 -cpu count=2 share=h >ssc set profile Group1/model -cpu count=2 share=600 -mem size=1024 >ssc set profile Group1/model -vnet "VM Network" >ssc set profile Group1/hostl -systemdisk type=thin Storage1 >ssc set profile Group1/hostl -extdisk size=2048 >ssc set profile Group1 -systemdisk type=thick independent tag1 >ssc set profile Group1 -extdisk size=100 ctrl=SCSI0 position=0 type=rdm-p LUN1, size=100 ctrl=AutoDetect type=rdm-v independent LUN2 >ssc set profile Group1 -delete >ssc set profile operations:/Group1/model -delete cpu

2.8.6 Setting Host ProfileSets a host profile.

[Syntax]

ssc set hostprofile Path <ProfileName | [-ostype OsType][-os [osname=<name | code>][password=value] [SysprepFile=value] [owner=value] [orgname=value] [timezone=value][productkey=value] [ConnectedNumber=value] [DomainType=<workgroup | domain>][DomainName=value] [DomainAccount=value] [DomainPassword=value] [License=value][AccountName=value] [Roles=value, ...]] [-dnsNICNo,<Primary,Secondary,PrimaryWINS,SecondaryWINS | Primary,Secondary,Tertiary> ...] [-extend Command=value] | -delete [os | dns | extend | osservice | account] [-dns4 NICNo,<Primary |Primary,Secondary | Primary,Secondary,Tertiary> ...] [-dns6 NICNo,<Primary | Primary,Secondary |Primary,Secondary,Tertiary> ...] [-wins4 NICNo,<Primary | Primary,Secondary> ...]> [-hostHostName] [-osservice ServiceName ...] [-account Name=value Password=value [Roles=value, ...][Groups=value, ...], ...]

[Parameters and Options]

Path(Required)

Specify a path to a target operation group, model, or host.The View Type ("operations:/") is optional.The Tenant and Category cannot be specified.E.g.)When specifying a group name:Category/GroupWhen specifying a host name:Category/Group/HostWhen specifying a host name (full path):operations:/Category/Group/Host

ProfileName(Required)

Specify the name of a named host profile.You can specify this option along with only [-host].

[-ostype OsType] Specify an OS type.You can specify one of the following OS Types:OsType : OS type"Linux": Linux

Chapter 2. Command for Setup

70 SigmaSystemCenter 3.5 ssc Command Reference

Page 81: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

"Windows-client": Windows Client"Windows": Windows Server

[-os[osname=<name | code>][password=value][SysprepFile=value][owner=value][orgname=value][timezone=value][productkey=value][ConnectedNumber=value][DomainType=<workgroup | domain>][DomainName=value][DomainAccount=value][DomainPassword=value][License="value"][AccountName=value][Roles=value, ...]]

Specify the OS information.You cannot specify leading or trailing spaces in equals ("=").You cannot specify this option along with ProfileName and -delete.osname: OS nameSpecify the OS name's code or the strings displayed on the WebUI.Refer to "Reference materials" in "1.1.6 OS Lists and Timezones (page 13)" in this document.When releasing, specify a value of 0 to this option.password: PasswordSysprepFile: Sysprep file to be importedYou can specify it only when the OS type is Windows.owner: Owner nameYou can specify it only when the OS type is Windows.orgname: The name of an organizationYou can specify it only when the OS type is Windows.timezone: Time zoneYou can specify it only when the OS type is Windows.Specify the time zone's code or the strings displayed on the WebUI.Refer to "Reference materials" in "1.1.6 OS Lists and Timezones (page 13)" in this document.The default value is the same as the value of"Microsoft Time Zone Index Values."productkey: Product keyYou can specify it only when the OS type is Windows.Enter it in the xxxxx-xxxxx-xxxxx-xxxxx-xxxxx format.ConnectedNumber: The number of connected serversYou can specify it only when the OS type is Windows Server.When omitted, the license mode is "Connected Client".DomainType: Workgroup settingSpecify "workgroup" for the WorkGroup, "domain" for theDomain.You can specify it only when the OS type is Windows.DomainName: The name of a Domain (WorkGroup)DomainAccount: Domain accountYou can specify it only when the OS type is Windows.DomainPassword: Domain passwordYou can specify it only when the OS type is Windows.License: licenseYou can specify it when the OS type is Linux and the Model typeof the Group is VMServer.Enter it in the xxxxx-xxxxx-xxxxx-xxxxx-xxxxx format.AccountName : Builtin administrator nameYou can specify a builtin administrator name.

Chapter 2. Command for Setup

71 SigmaSystemCenter 3.5 ssc Command Reference

Page 82: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Roles : RoleYou can specify "Controller", "WSMan" or "None".You specify "Controller" for operating the OS. You specify"WSMan" for registering to ESMPRO/ServerAgentService. Youspecify "None" for resetting the Roles.

[-dns NICNo, <Primary,Secondary,PrimaryWINS,SecondaryWINS |Primary,Secondary,Tertiary>...]

Specify DNS information.You cannot specify this option along with ProfileName and -delete.NICNo: NIC NumberPrimary: Primary DNSSecondary: Secondary DNSTertiary: Tertiary DNSYou can specify it only when the OS type is Linux.PrimaryWINS: Primary DNS WINSYou can specify it only when the OS type is Windows.SecondaryWINS: Secondary DNS WINSYou can specify it only when the OS type is Windows.You cannot specify this option along with [-dns4], [-dns6] and [-wins4].

[-extend Command=value] Specify extended information.You cannot specify leading or trailing spaces in the equal ("=").You cannot specify this option along with ProfileName and -delete.Command: Specify the command names to be added separatingthem with "," (comma).

-delete [os | dns | extend | osservice | account] Specify this option if the setting information should be deleted.If you specify the option name, the setting information of thatoption is deleted.If not, all setting information will be deleted.You cannot delete only the OS information.You can specify this option along with only [-host].

[-dns4 NICNo,<Primary,Secondary |Primary,Secondary,Tertiary> ...]

Specify DNS (IPv4) information.You cannot specify this option along with ProfileName and -delete.NICNo: NIC NumberPrimary: Primary DNSSecondary: Secondary DNSTertiary: Tertiary DNS  You can specify it when the OS type is Linux.You cannot specify this option along with [-dns].

[-dns6 NICNo,<Primary,Secondary |Primary,Secondary,Tertiary> ...]

Specify DNS (IPv6) information.You cannot specify this option along with ProfileName and -delete.NICNo: NIC NumberPrimary: Primary DNSSecondary: Secondary DNSTertiary: Tertiary DNS  You can specify it when the OS type is Linux.

Chapter 2. Command for Setup

72 SigmaSystemCenter 3.5 ssc Command Reference

Page 83: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

You cannot specify this option along with [-dns].

[-wins4NICNo,<PrimaryWINS,SecondaryWINS ...]

Specify the WINS (IPv4) information.You can specify it when the OS type is Windows.You cannot specify this option along with ProfileName and -delete.NICNo: NIC NumberPrimaryWINS: Primary WINSSecondaryWINS: Secondary WINSYou cannot specify this option along with [-dns].

[-host HostName] Specify the host name of a target.If you specify this option, specify the operation group for thePath.Specify this option if there is a model with the same name as thetarget host.

[-osservice ServiceName ...] Specified the service name of waiting for startup, when themachine is started.

[-account Name=value Password=value[Roles=value, ...][Groups=value, ...], ...]

Specified a local user account.Name : Specified the account name.you cannot specifiy "Administrator" or "root".Password : Specified the password.Roles : Specified the role that you use to control.You can specify "Controller" or "WSMan".You specify "Controller" for operating the OS. You specify"WSMan" for registering to ESMPRO/ServerAgentService.Groups : Specified the group names.When you specify multiple items, separate the data with commas(",").

[Note]

• If you specify the -os option, be sure to specify all of its settings.

[Syntax examples]

Public Profile >ssc set hostprofile category1/wingroup1 PublicHostProfile

Windows OS >ssc set hostprofile category1/wingroup1 -os osname=11 password="pass" owner="ABC Corporation" orgname="1st section" timezone=235 productkey=12345-67890-ABCD1-EFG21-HI123 DomainType=workgroup DomainName="WorkGroup" -dns 1,192.168.1.1,192.168.1.2 2,10.108.110.1,10.108.110.2,10.108.110.3 >ssc set hostprofile category1/wingroup1 -os osname="Windows Server 2008 Enterprise (x64)" password="pass" owner="ABC Corporation" orgname="1st section" timezone=235 productkey=12345-67890-ABCD1-EFG21-HI123 ConnectedNumber=10 DomainType=domain DomainName="Domain1" DomainAccount="admin" DomainPassword=adminpass -dns 1,192.168.1.1,192.168.1.2 2,10.108.110.1,10.108.110.2,10.108.110.3 >ssc set hostprofile category1/wingroup1 -os osname="Windows Server 2008 Enterprise (x64)" password="pass" owner="ABC Corporation" orgname="1st section" timezone=235

Chapter 2. Command for Setup

73 SigmaSystemCenter 3.5 ssc Command Reference

Page 84: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

productkey=12345-67890-ABCD1-EFG21-HI123 ConnectedNumber=10 DomainType=domain DomainName="Domain1" DomainAccount="admin" DomainPassword=adminpass -dns4 1,192.168.1.100,192.168.1.101 -dns6 1,::192.168.1.150 3,::192.168.1.152 -wins4 1,192.168.1.200 2,192.168.1.201

Linux OS >ssc set hostprofile category1/linuxgroup1 -os osname="SUSE Linux Enterprise Server 9" password="pass" DomainName="Domain1" -dns 1,192.168.1.1,192.168.1.2,192.168.1.3 >ssc set hostprofile category1/linuxgroup1 -os osname="SUSE Linux Enterprise Server 9" password="pass" DomainName="Domain1" -dns4 1,192.168.1.100,192.168.1.101,192.168.1.102 -dns6 1,::192.168.1.150,::192.168.1.151

-extend >ssc set hostprofile category1/wingroup1 -extend Command=startcmd1,startcmd2

-delete >ssc set hostprofile -delete os dns >ssc set hostprofile -delete

2.8.7 Replacing MachineReplaces the specified machine.

[Syntax]

ssc replace machine GroupName HostName [ -pool MachineName | -shared MachineName ]

[Parameters and Options]

GroupName(Required)

Specify a group or model.

HostName(Required)

Specify the name of the host where a source machine is activated.

[-pool MachineName] Specify a machine in a group pool as the destination machine.You cannot specify this option along with -shared.

[-shared MachineName] Specify a machine in a shared pool as the destination machine.You cannot specify this option along with -pool.

[Note]

• If a unit name is set, specify the unit name for MachineName.

[Syntax examples]

When you do not specify a destination machine >ssc replace machine Category1/Group1 Host01 >ssc replace machine Category1/Group1/Model1 Host01

When you specify a machine which belongs to a group pool as a destination machine. >ssc replace machine Category1/Group1 Host01 -pool PoolMachine1 >ssc replace machine Category1/Group1/Model1 Host01 -pool PoolMachine1

Chapter 2. Command for Setup

74 SigmaSystemCenter 3.5 ssc Command Reference

Page 85: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When you specify a machine which belongs to a shared pool as a destination machine. >ssc replace machine Category1/Group1 Host01 -shared SharedMachine1 >ssc replace machine Category1/Group1/Model1 Host01 -shared SharedMachine1

2.8.8 Executing ScaleInExecutes ScaleIn.

[Syntax]

ssc scalein GroupName

[Parameters and Options]

GroupName(Required)

Specify the group to which you intend to scale in.Specify a path to the group.You cannot specify a tenant, category or model.(E.g.: Category/Group, Group)

[Syntax examples]

>ssc scalein category1/wingroup1 >ssc scalein tenant1/vmgroup1 >ssc scalein vmsgroup1

2.8.9 Executing ScaleOutExecutes ScaleOut.

[Syntax]

ssc scaleout GroupName

[Parameters and Options]

GroupName Specify the group to which you intend to scale out.Specify a path to the group.You cannot specify a tenant, category or model.(E.g.: Category/Group, Group)

[Syntax examples]

>ssc scaleout category1/wingroup1 >ssc scaleout tenant1/vmgroup1 >ssc scaleout vmsgroup1

2.8.10 Notifying a Tree of the Specified Group to DPMNotifies a tree of the specified group to DPM.

[Syntax]

ssc dpm-location notify <Path | -all>

[Parameters and Options]

Path Specify the path to the target operations tenant, category or group.

Chapter 2. Command for Setup

75 SigmaSystemCenter 3.5 ssc Command Reference

Page 86: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-all Specify this option if you notify trees of all tenant, category and group.

[Note]

Either Path or -all (option) must be specified.

[Syntax examples]

>ssc dpm-location notify category1/group1 >ssc dpm-location notify -all

2.9 Host2.9.1 Creating Host

Creates a host in a group.

[Syntax]

ssc create host GroupName HostName [IPAddress <SubnetMask | [SubnetPrefixLength]>[DefaultGateway] [-monitor]] [-hc HostCount] [-product ProductKey] [-p Password] [-priority n] [-emergency <on | off | opened>] [-evacuationpolicy <open | keep>] [-autostartup <on | off>]

[Parameters and Options]

GroupName(Required)

Specify the group in which you intend to create a host.Specify the path to the group. You cannot specify the Tenant, Category or Model.(E.g. Category/Group, Group)

HostName(Required)

Specify the name of the host that you intend to create in the group.Up to 63 characters are available in this option.Up to 9 digits are available for the host name that consists only of numbers or can beadded to the end of the host name.

[IPAddress] Specify the IP address for the host.This value is for NIC #1.If you specify a number equal to or greater than two in HostCount, an IP address isincremented from the specified IP address a specified number of times by HostCount.You cannot omit this option if you specify SubNetMask, DefaultGateway, or -</w2d_b>monitor</w2d_i>.

SubNetMask Specify the subnet mask for the IP address of the host.You need to specify IPAddress.If you specify IPAddress(IPv4), you cannot omit this option.

[SubnetPrefixLength] Specify the subnet prefix length.If you do not specify this option, the subnet prefix length is set to 64.You cannot specify this option along with [SubNetMask].

[DefaultGateway] Specify the default gateway.You need to specify IPAddress.

[-monitor] If you specify this option, IPAddress is configured as an IP address for management.You need to specify IPAddress.

[-hc HostCount] Specify the number of hosts to be created in the group.

Chapter 2. Command for Setup

76 SigmaSystemCenter 3.5 ssc Command Reference

Page 87: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you specify two or a greater number, a serial number from one is added toHostName.If you specify IPAddress, specify a value in the range that the IP address can beassigned.

[-product ProductKey] Specify the product key.If the OS type of the group is either of the following, you can specify this option.Windows Client / Windows Server for IPF / Windows Server

[-p Password] Specify the Administrator password.Specify this option to use the administrator password configured to the host setting.If you do not specify this option, a password configured for the group is used.

[-priority n] Specify the priority value of the host.Range : 1 (highest) <= n <= 5 (lowest)

[-emergency <on | off |opened>]

Configure the host as an Emergency Host.on: Enable the setting of an Emergency Host.off: Disable the setting of an Emergency Host.opened: Enables the setting of Emergency Host with opened status.

[-evacuationpolicy <open |keep>]

Configures the policy of the Emergency Host when VM Evacuation is executed.open: Opens the Emergency Host.keep: Never open the Emergency Host.

[-autostartup <on | off>] Configures the setting whether startup of the VM assigned to this host would beexecuted automatically when startup of the VM Server is executed.This option can be specified only for virtual machines.on: Enables auto-startup.off: Disables auto-startup.

[Syntax examples]

>ssc create host Category/group1 vmhost -hc 3 192.168.1.10 255.255.255.0 192.168.1.1 –monitor

<An example of network setting configured to a host and a host to create> test1/group1 vmhost1 <-Host 192.168.1.10: IP address for management 255.255.255.0: Subnet mask 192.168.1.1: Default gateway vmhost2 192.168.1.11: IP address for management 255.255.255.0: Subnet mask 192.168.1.1: Default gateway vmhost3 192.168.1.12: IP address for management 255.255.255.0: Subnet mask 192.168.1.1: Default gateway

>ssc create host Category/group1 vmhost4 -hc 3 –product xxxxx-xxxxx-xxxxx-xxxxx-xxxxx –p xyz

2.9.2 Updating HostEdits or updates a host setting.

Chapter 2. Command for Setup

77 SigmaSystemCenter 3.5 ssc Command Reference

Page 88: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc update host GroupName HostName [-name NewHostName] [-product ProductKey] [-tagTagName] [-changegroup DestinationGroupName] [-p Password] [-priority n] [-emergency <on | off |opened>] [-evacuationpolicy <open | keep>] [-autostartup <on | off>]

[Parameters and Options]

GroupName(Required)

Specify the group in which the host to be edited or updated exists.Specify the path to the group. You cannot specify the Tenant, Category or Model(E.g. Category/Group).

HostName(Required)

Specify the host name to be edited or updated.

[-name NewHostName] Update the contents of HostName setting to NewHostName.

[-product ProductKey] Update the product key.If the OS type of the group is one of the following, the product key can beupdated.Windows Client / Windows Server

[-tag TagName] Update tag.

[-changegroupDestinationGroupName]

Move the host between groups (virtual machine maintenance). You can specifythis option only for virtual machines. Specify the destination group ofHostName. This option updates the host settings to move the host of the virtualmachine running in the group move to the other group. Specify the path to themodel. The host needs to be running (a machine is assigned). You cannotspecify this option along with the other options(E.g. Category/Group/Model,Category/Group/Model).

[-p Password] Specify the password to use the administrator password that is set for the host.

[-priority n] Specify the priority value of the host.Range : 1 (highest) <= n <= 5 (lowest)

[-emergency <on | off | opened>] Configure the host as an Emergency Host.on: Enable the setting of an Emergency Host.off: Disable the setting of an Emergency Host.opened: Enables the setting of Emergency Host with opened status.

[-evacuationpolicy <open |keep>]

Configure the policy of the Emergency Host when VM Evacuation is executed.open: Open the Emergency Host.keep: Never open the Emergency Host.

[-autostartup <on | off>] Configure the setting whether startup of the VM assigned to this host would beexecuted automatically when startup of the VM Server is executed.This option can be specified only for virtual machines.on: Enable auto-startup.off: Disable auto-startup.

• Specify at least one of the following options: -name, -product, -tag, -changegroup, -p, -priority, -emergency, -evacuationpolicy, or -autostartup.

[Note]

Chapter 2. Command for Setup

78 SigmaSystemCenter 3.5 ssc Command Reference

Page 89: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• To move the host between groups (-changegroup), your environment must meet all thefollowing conditions. Check the destination group, source group, and settings of the modelbefore running the command:

- The model type of both the source group and the destination group is VM.

- The OS types and virtual network settings of the source group and the destination groupare the same.

- No host with the same name as the target exists in the destination group.

- No same virtual machine as the target virtual machine to be moved exists in the pool of thetarget destination model group.

• The hosts are moved only by the database operation. So, the actions of storage, load balancer,network, power control, and the moving of groups on DeploymentManager are not executed forthe target host.

[Syntax examples]

>ssc update host Category/group1 hostABC –name host001 >ssc update host Category/group1 host001 –tag Tag_host001 –p >ssc update host Category/group1 host002 –p abc01 >ssc update host Category/group1 host002 –product xxxxx-xxxxx-xxxxx-xxxxx-xxxxx >ssc update host Category/group1 host001 –changegroup Category/group2/model02

2.9.3 Deleting HostDeletes a host in a group.

[Syntax]

ssc delete host GroupName [HostName...] [-i]

[Parameters and Options]

GroupName(Required)

Specify the path to the group.The Tenant, Category, or Model cannot be specified.

[HostName...] Specify logical group host name.If you do not specify the [HostName] option, all hosts which belong to the specified group aredeleted.You cannot delete the host when there are activated machines in this host.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete host Category1/Group01 HOST-01 >ssc delete host Group-A001 Group-A002 >ssc delete host Group-B001 -i

2.9.4 Displaying Host DefinitionDisplays a setting of host definition.

[Syntax]

Chapter 2. Command for Setup

79 SigmaSystemCenter 3.5 ssc Command Reference

Page 90: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc show host <GroupName [HostName...] | SmartGroupName> [-net] [-storage] [-software] [-vertical]

[Parameters and Options]

GroupName Specify a group name that a target host belongs to.Specify a tenant name, category name, or group name including the path. You cannot specify amodel.(E.g. Category, Category/Group, Group)

[HostName...] Specify a target host name.

SmartGroupName Specify a smart group's path in the Operations view in order to display definitions of hostscorrespond to the condition of the specified smart group.Note:* The group path must exist.Setting examples:[category1/group11/smartgroup101]Smartgroup101 below the group11 node of the category1 of the Operations view is specified.[smartgroup102]smartgroup102 below the operation node of the Operations view is specified.

[-net] Display network settings.You cannot specify this option along with [-storage] or [-software].

[-storage] Display storage settings.You cannot specify this option along with [-net] or [-software].

[-software] Display software settings.You cannot specify this option along with [-net] or [-storage].

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc show host Category1/Group01 HOST-01 >ssc show host Group-A001 -vertical >ssc show host category1/group11/smartgroup101 >ssc show host Category1/Group01 HOST-01 -net >ssc show host Group-A001 -storage -vertical >ssc show host category1/group11/smartgroup101 -software

2.9.5 Creating Dependency Setting for HostsCreates dependency setting for hosts.

[Syntax]

ssc dependency create-setting DependencyName

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting (100 characters or less).

[Syntax examples]

Chapter 2. Command for Setup

80 SigmaSystemCenter 3.5 ssc Command Reference

Page 91: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc dependency create-setting dependency1

2.9.6 Deleting Dependency Setting for HostsDeletes dependency setting for hosts.

[Syntax]

ssc dependency delete-setting DependencyName

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting.

[Syntax examples]

>ssc dependency delete-setting dependency1

2.9.7 Updating Dependency Setting for HostsChanges dependency setting for hosts.

[Syntax]

ssc dependency update-setting DependencyName <[-name NewName] [-enabled expression] [-autoexpression] [-weak expression]>

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting.

[-name NewName] Specify the new name of dependency setting (100 characters or less).

[-enabled expression] Specify if dependency is enabled or not, following the format of expression described below.

[-auto expression] Specify if dependee or dependent should be added or not as target automatically, followingthe format of expression described below.

[-weak expression] Specify if operation should be executed or not regardless of the status of dependee ordependent, following the format of expression described below.

• expression : Specify in the flag format or operator format.

- flag format : Specify each flag number (1:ON, 0:OFF) corresponding to Startup,Shutdown, Reboot, and VM Evacuation from left.

ex) Startup:ON, Shutdown:ON, Reboot:OFF, VM Evacuation:OFF -> 1100

- operator format : Specify change request for each operation by using operator (+:ON,-:OFF).

* Startup -> startup(u)

* Shutdown -> shutdown(d)

* Reboot -> reboot(r)

* VM Evacuation -> evacuate(e)

ex) Changes the value for Startup to ON and the value for Shutdown to OFF -> +startup -shutdownor +u -d

[Note]

Chapter 2. Command for Setup

81 SigmaSystemCenter 3.5 ssc Command Reference

Page 92: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• The -auto value for VM Evacuation depends on the -weak value (The -auto value is set to ONautomatically if -weak value is OFF, and the -auto value is set to OFF automatically if -weakvalue is ON).

[Syntax examples]

>ssc dependency update-setting dependency1 -name dependency2 -enabled 1101 -auto +u -d -weak +d +e

2.9.8 Displaying Dependency Setting for HostsShows dependency setting for hosts.

[Syntax]

ssc dependency show-setting

[Parameters and Options]

No parameters or options.

[Syntax examples]

>ssc dependency show-setting

[Display examples]

>ssc dependency show-setting #Name,Enabled,Auto,Weak "dependency1","udre","ud-e","udr-" "dependency2","u--e","u---","---e"

• u, d, r, and e indicates that the flag is ON for Startup, Shutdown, Reboot, and VM Evacuationoperation respectively.

2.9.9 Adding Dependency Between HostsAdds dependency between hosts.

[Syntax]

ssc dependency add DependencyName SourceName DestinationName

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting.

SourceName(Required)

Specify the name of host which depends on another.

DestinationName(Required)

Specify the name of host which is depended on by another.

[Syntax examples]

>ssc dependency add dependency1 group/host1 group/host2

2.9.10 Deleting Dependency Between HostsDeletes dependency between hosts.

Chapter 2. Command for Setup

82 SigmaSystemCenter 3.5 ssc Command Reference

Page 93: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc dependency delete DependencyName SourceName DestinationName

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting.

SourceName(Required)

Specify the name of the host which depends on another.

DestinationName(Required)

Specify the name of the host which is depended on by another.

[Syntax examples]

>ssc dependency delete dependency1 group/host1 group/host2

2.9.11 Displaying Dependency Between HostsShows dependencies between hosts.

[Syntax]

ssc dependency show DependencyName

[Parameters and Options]

DependencyName(Required)

Specify the name of dependency setting.

[Syntax examples]

>ssc dependency show dependency1

[Display examples]

>ssc dependency show dependency1 #SourceHost,DestinationHost "group/host1","group/host2" "group/host3","group/host4"

2.10 IP Address2.10.1 Adding IP Address Information

Adds an IP address (network) to a host in a group.

[Syntax]

ssc add ipaddress GroupName HostName NicNumber IPAddress <SubnetMask |[SubnetPrefixLength]> [DefaultGateway] [-monitor] [-hc HostCount]

[Parameters and Options]

GroupName(Required)

Specify the group to which you intend to add the IP address information.Specify the path to the group. You cannot specify a tenant, category or model.

Chapter 2. Command for Setup

83 SigmaSystemCenter 3.5 ssc Command Reference

Page 94: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(E.g. Category/Group, Group)

HostName(Required)

Specify the name of the host to which you intend to add an IP address.If you specify 2 or greater number in -hc, HostName must end with a number.

NicNumber(Required)

Specify the target NIC number.

IPAddress(Required)

Specify an IP address.You cannot omit this option if you specify SubNetMask, DefaultGateway, or -monitor.

SubNetMask(Required)

Specify a subnet mask.You cannot omit this option if you specify IPAddress (IPv4) and cannot specify along withSubnetPrefixLength.

[SubnetPrefixLength] Specify a subnet prefix length.If you do not specify this option, the subnet prefix length is set to 64.You cannot specify this option along with [SubNetMask].

[DefaultGateway] Specify the default gateway.You need to specify IPAddress.

[-monitor] If you specify this option, IPAddress is configured as an IP address for management.You need to specify IPAddress.

[-hc HostCount] Specify the number of hosts to create in a group,If you specify 2 or a greater number, a serial number from 1 is added to HostName.If you specify IPAddress, specify the value in the range that the IP address can be assigned.

[Syntax examples]

>ssc add ipaddress Category/group1 host001 2 192.168.2.100 255.255.255.0 >ssc add ipaddress Category/group1 host002 3 192.168.3.100 255.255.255.0 192.168.3.1 –monitor >ssc add ipaddress Category/group1 host003 2 192.168.2.200 255.255.255.0 –hc 3

2.10.2 Deleting IP Address InformationDeletes an IPAddress in a host.

[Syntax]

ssc delete ipaddress GroupName HostName NicNumber <-ipaddress IPAddress | -all> [-i]

[Parameters and Options]

GroupName(Required)

Specify the target group name.

HostName(Required)

Specify the target host name.

NicNumber(Required)

Specify the target NIC number.

-ipaddress IPAddress Specify the target IP address.It cannot be specified with -all.

-all All IP Addresses of the specified NicNumber are deleted.

Chapter 2. Command for Setup

84 SigmaSystemCenter 3.5 ssc Command Reference

Page 95: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

It cannot be specified with -ipaddress.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete ipaddress Category1/Group01 HOST-01 1 -ipaddress 192.168.100.100 >ssc delete ipaddress Group-A001 Host-A001 2 -ipaddress 192.168.1.100 -i >ssc delete ipaddress Group-A001 Host-A001 2 -all

2.11 Software2.11.1 Adding Software

Adds software to a group (group or model), host or machine.

Software is added at a distribution point.

[Syntax]

ssc add software Path [-host HostName] -soft SoftwareName [-point PointNumber]

[Parameters and Options]

Path(Required)

Specify a path to group, model, or machine to which you want to add software.(Setting Example)In the case of a group or a model (The view type is "operations:/")operations:/category1/group11/smartgroup101In the case of a resource group (The view type is "resource:/")resource:/rack/machineAYou can omit View Type ("operations:/").If you omit View Type, the specified path is treated as the path to the Operation view.If you specify -host, specify a path to a group name.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-host HostName] Specify a host name. Software is added to a specified host.You can specify this option when Path is specified a group path.

-softSoftwareName(Required)

Specify software to be added.

[-pointPointNumber]

Specify a distribution point of software to add.This is unnecessary if software is a logical software.

If you specify a group or a model, you can specify the following distribution point:PointNumber: A distribution point "1": Distributed when a machine is activated "2": Distributed when a machine is set to the standby state "3": Standby / after shutdown "4": Replacing a machine "5": Assigning a machine on group "6": Back up of the image

Chapter 2. Command for Setup

85 SigmaSystemCenter 3.5 ssc Command Reference

Page 96: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 "7": Restore of the image "8": Applying configuration of the logical machine "9": Release configuration of the logical machine "10": Start of the machineIf you specify a host, you can specify the following distribution point:PointNumber: A distribution point "1" : Operating / before group distribution "2" : Operating / distribution "3" : Operating / after group distribution "4" : Standby / before group distribution "5" : Standby / distribution "6" : Standby / after group distribution "7" : Standby / after shutdown "8" : Replacing a machine "9" : Assigning a machine on group "10": Back up of the image "11": Restore of the image "12": Applying configuration of the logical machine "13": Release configuration of the logical machine  "14": Start of the machine If you specify a machine, you can specify the following distribution point:PointNumber: A distribution point "1": Operating / before group distribution "2": Operating / after group distribution "3": Standby / before group distribution "4": Standby / after group distribution "5": Standby / after shutdown "6": Create replica VM "7": Backup of the image "8": Restore of the image "9": Start of the machine

[Syntax examples]

>ssc add software operations:/Category1/Group01 -soft Soft-001 -point 1 >ssc add software operations:/Category1/Group01/Model001 -soft Soft-002 -point 2 >ssc add software operations:/Group-A001 -host Host01 -soft Soft-001 -point 1 >ssc add software resource:/SmartGroup01/Machine-A -soft Soft-001 -point 5

2.11.2 Deploying SoftwareDeploys software to the specified machines.

[Syntax]

ssc deploy software < GroupName [HostName[...]] | < -name MachineName[...] | -path path[...] | -uuid UUID[...] | -mac MAC[...] > > [-s SoftwareName[...]] [-package [SoftwareName/]

Chapter 2. Command for Setup

86 SigmaSystemCenter 3.5 ssc Command Reference

Page 97: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[PackageName=]Option] [-packageresult] [-force] [-seq] [-description BackupDescription] [-imagename ImageName] [-forcerestore]

[Parameters and Options]

GroupName Specify a target group name.Specify a path to a group or the model. You cannot specify a tenant or category.If HostName is specified, the group name must be specified for this option.(E.g. Category/Group/Model)

[HostName] Specify the name of an activated host.Multiple hosts can be specified only when they are in the specified group (inGroupName).If you do not specify this option, all the hosts activated in the specified group are thetargets.

-name MachineName | -pathPath | -uuid UUID | -macMAC

Specify the target to distribute software.At least one of the following options must be specified: -name, -path, -uuid, and -mac.Multiple parameters can be specified.-name : Specify the name of a machine.-path : Specify the path of the target.E.g.When specifying the machine, specify as follows: Operations view:  operations:/Category/Group/Machine Resource view:  resource:/Group/Machine  Group/Machine Virtual view:  virtual:/VC/DC/VMS/VMWhen specifying a group or the rack, specify as follows: Resource view:  resource:/Group/Rack  Group/Rack Operations view:  operations:/Category/Group-uuid : Specify the UUID of the machine.-mac : Specify the primary MAC address of the machine.When the view is not specified in –path, the specified path is treated as the path tothe Resource view.About specification of a path, refer to "1.1.5 About Path and GroupPathSpecification (page 11)".

[-s SoftwareName] Specify software to be distributed.The specified software doesn't have to be registered in a group or host.Specify the software name displayed in the Resource view on the Web Console. (Thevalue must be enclosed in double quotation marks.)Several pieces of software can be specified by separating the data with spaces.Regardless of the distribution status of the software registered to the group, only thespecified software is distributed.If the -name, -path, -uuid, and -mac are specified, this option must be specified.

Chapter 2. Command for Setup

87 SigmaSystemCenter 3.5 ssc Command Reference

Page 98: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-package [SoftwareName/][PackageName=]Option]

Specify options for each package. The software name must be specified for the -soption if you specify the options.SoftwareName/ : Specify software to set options. Enter a value enclosed in doublequotation marks, and add a slash at the end of the software name to separate it fromthe package name. The value may be omitted if you specify only one software namein the -s option.PackageName= : Specify the package name to set options. Enter the value enclosingit in double quotation marks, and add an equal sign at the end of the package name toseparate it from the option. The value may be omitted if specified software has onepackage.Option: Specify an option for the package in the software. The value must beenclosed in double quotation marks.

[-packageresult] Specify if you want to reflect a package execution result to a job execution result.The job execution result is failed when all the package executions are regarded asfailures. When specified, it is enabled to all software for the applications or theupdates.

[-force] Forcibly redistributes the software registered to the group (including alreadydistributed software).This option is enabled if SoftwareName is not specified.

[-seq] Distributes software sequentially (one by one in order).When you do not specify this option, the software is distributed all at once.

[-descriptionBackupDescription]

Specify the description of a backup image.(The value must be enclosed in doublequotation marks.)When this option is specified the -host option can be specified only one host name.The software name must be specified for the -s option if you specify the options.

[-imagename ImageName] Specify the image name of the backup you want to restore.The software name must be specified for the -s option if you specify the options.To specify the image name, please enter enclosed in the image name of "" in theBackup Image of Software at the Resource view on the Web console.When you perform a restore using this option you will see a message of executionconfirmation. Please specify the -force option if forced to run.Restore of using this option can not be run only one at the same time.

[-forcerestore] Forcibly distribute software of restore with the -imagename option.

[Syntax examples]

Software is deployed to the whole group of operations view.>ssc deploy software Category1/Group1>ssc deploy software Category1/Group1 -s "Software [1]" "Patch-1">ssc deploy software Category1/Group1 -force

Software is deployed to the specified host of operations view.>ssc deploy software Category1/Group1 Host01>ssc deploy software Category1/Group1 Host01 Host02 Host03>ssc deploy software Category1/Group1 Host01 Host02 Host03 -s "Software [1]" "Patch-1"

Software is deployed to the whole group of resource view.>ssc deploy software -path resource:/VMGroup -s "Software [1]" "Patch-1" -seq

Software is deployed to the specified machine (specified name).>ssc deploy software -name machine1 machine2 -s "Software [1]" "Patch-1"

Chapter 2. Command for Setup

88 SigmaSystemCenter 3.5 ssc Command Reference

Page 99: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Software is deployed to the specified machine (specified uuid).>ssc deploy software -uuid 00B9771D-29BB-DB11-8001-003013B8F50D -s "Software [1]" "Patch-1"

Software is deployed to the specified machine (specified MAC address).>ssc deploy software -mac 00:31:13:B8:F6:1D -s "Software [1]" "Patch-1"

Software with option is deployed to the specified machine (specified name).>ssc deploy software -name machine1 -s "Software [1]" -package "Software [1]"/"Package1"="Option" -packageresult "Software [1]" : It refres to the software name displayed in the Resource view on the Web Console. "Package1" : It refers to the package name to be included in the software.When run the package "Package1", part of the "Option" is passed as an argument.

Backup software is deployed to the specified machine with the backup description.> ssc deploy software -name machine1 -s "Backup [1]" -description "This is the backup image of host1."

Restore software is deployed to the specified machine by specifying the backup image name.> ssc deploy software -name machine1 -s "Restore [1]" -iamgename "D:/DeployBackup/image1.lbr"

2.11.3 Deleting SoftwareDeletes Software in a group.

[Syntax]

ssc delete software GroupName [-host HostName] [-soft SoftwareName] -point PointNumber [-i]

[Parameters and Options]

GroupName(Required)

Specify the path to the group or model.(E.g. Category/Group, Group, Group/Model)Specify the path to the group when you specify the -host option.

[-host HostName] Specify the target host name.

[-soft SoftwareName] Specify the target software name.

-point PointNumber Specify the target PointNumber for the distribution timing.When "all" is specified for the PointNumber,all the software of the PointNumber are deleted.When delete it from group or modelPointNumber: distribution timing1 : When a machine is Active2 : When a machine is Standby3 : When turn into Standby (after shutdown)4 : Replacing a machine5 : Assigning a machine on group6 : Backup of the image7 : Restore of the image

Chapter 2. Command for Setup

89 SigmaSystemCenter 3.5 ssc Command Reference

Page 100: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

8 : Applying configuration of the logical machine9 : Release configuration of the logical machineWhen delete it from hostPointNumber: distribution timing1 : When turn into Active (before group distribution)2 : When turn into Active3 : When turn into Active (after group distribution)4 : When turn into Standby (before group distribution)5 : When turn into Standby6 : When turn into Standby (after group distribution)7 : When turn into Standby (after shutdown)8 : Replacing a machine9 : Assigning a machine on group10 : Backup of the image11 : Restore of the image12 : Applying configuration of the logical machine13 : Release configuration of the logical machine

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete software Category1/Group01 -soft Soft-001 -point 1 >ssc delete software Category1/Group01/Model001 -soft Soft-002 -point 2 >ssc delete software Group-A001 -soft Soft-001 -point 1 -i >ssc delete software Group-A001 -host Host-A001 -soft Soft-001 -point 1 >ssc delete software Group-B001 -host Host-B001 -point 1 >ssc delete software Group-B001 -point all

2.11.4 Displaying Software InformationDisplays software information.

[Syntax]

ssc show software

[Parameters and Options]

No parameters or options.

[Syntax examples]

>ssc show software

2.11.5 Create Logical SoftwareCreate logical software.

[Syntax]

ssc logicalsoftware create Name -relate expand

[Parameters and Options]

Name(Required)

Specify the name of the logical software to be created.

Chapter 2. Command for Setup

90 SigmaSystemCenter 3.5 ssc Command Reference

Page 101: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-relate expand(Required)

Specify the behavior when adding the logical software to be created to the software tab.Deploy to all software comprising the logical software, and add all software to the software tab.

[Syntax example]

> ssc logicalsoftware create SoftwareA -relate expand

2.11.6 Delete Logical SoftwareDelete logical software.

[Syntax]

ssc logicalsoftware delete Name

[Parameters and Options]

Name(Required)

Specify the name of the logical software to be deleted.

[Syntax example]

> ssc logicalsoftware delete SoftwareA

2.11.7 Show Logical Software InformationShow logical software information.

[Syntax]

ssc logicalsoftware show [Name]

[Parameters and Options]

[Name] Specify the name of the logical software to be showed.

[Syntax example]

> ssc logicalsoftware show> ssc logicalsoftware show SoftwareA

[Output example]

>ssc logicalsoftware show#SoftwareName,Type,UniversalIdentifier"logical1","Expand","""logical2","Expand","""logical3","Expand","""logical4","Expand","""logical5","Expand",""

>ssc logicalsoftware show logical4#SoftwareName,Type,Point,UniversalIdentifier"app1.txt","Deploy File","3","""localscript/<localhost>","Script","3","""System_AgentUpgrade_Multicast/localhost<WinLinux>","Application and Update","3","""logical1","Logical Software, Expand","-","""t1","Disk Clone","3",""

Chapter 2. Command for Setup

91 SigmaSystemCenter 3.5 ssc Command Reference

Page 102: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

"app1.txt","Deploy File","4",""

2.11.8 Add the Software to the Logical SoftwareAdd the software to the logical software.

[Syntax]

ssc logicalsoftware add-software Name -soft SoftwareName [-point PointNumber]

[Parameters and Options]

Name(Required)

Specify the name of the logical software.

-soft SoftwareName(Required)

Specify software to be added.

[-point PointNumber ] Specify a distribution point of software to add.This is unnecessary if software is a logical software.You can specify the following distribution point:() Inside is the setting destination where a distribution point is available."1": Operating / before group distribution (a machine)"2" : Operating / before group distribution (a host)"3": Distributed when a machine is activated (a group or a model)"4" : Operating / distribution (a host)"5" : Operating / after group distribution (a host)"6": Operating / after group distribution (a machine)"7": Standby / before group distribution (a machine)"8" : Standby / before group distribution (a host)"9": Distributed when a machine is set to the standby state (a group or a model)"10" : Standby / distribution (a host)"11" : Standby / after group distribution (a host)"12": Standby / after group distribution (a machine)"13": Standby / after shutdown (a machine)"14": Create replica VM (a machine)"15": Backup of the image (a group or a model or a host or a machine)"16": Restore of the image (a group or a model or a host or a machine)"17": Applying configuration of the logical machine (a group or a model or a host)"18": Release configuration of the logical machine (a group or a model or a host)"19": Replacing a machine (a group or a model or a host)"20": Assigning a machine on group (a group or a model or a host)"21": Start of the machine (a group or a model or a host or a machine)

[Syntax example]

> ssc logicalsoftware add-software SoftwareA -soft DPMScenatio1 -point 1

2.11.9 Delete the Software from the Logical SoftwareDelete the software from the logical software.

[Syntax]

Chapter 2. Command for Setup

92 SigmaSystemCenter 3.5 ssc Command Reference

Page 103: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc logicalsoftware delete-software Name -soft SoftwareName [-point PointNumber]

[Parameters and Options]

Name(Required)

Specify the name of the logical software.

-soft SoftwareName(Required)

Specify software to be deleted.

[-point PointNumber ] Specify a distribution point of software to delete.This is unnecessary if software is a logical software.You can specify the following distribution point:() Inside is the setting destination where a distribution point is available."1": Operating / before group distribution (a machine)"2" : Operating / before group distribution (a host)"3": Distributed when a machine is activated (a group or a model)"4" : Operating / distribution (a host)"5" : Operating / after group distribution (a host)"6": Operating / after group distribution (a machine)"7": Standby / before group distribution (a machine)"8" : Standby / before group distribution (a host)"9": Distributed when a machine is set to the standby state (a group or a model)"10" : Standby / distribution (a host)"11" : Standby / after group distribution (a host)"12": Standby / after group distribution (a machine)"13": Standby / after shutdown (a machine)"14": Create replica VM (a machine)"15": Backup of the image (a group or a model or a host or a machine)"16": Restore of the image (a group or a model or a host or a machine)"17": Applying configuration of the logical machine (a group or a model or a host)"18": Release configuration of the logical machine (a group or a model or a host)"19": Replacing a machine (a group or a model or a host)"20": Assigning a machine on group (a group or a model or a host)"21": Start of the machine (a group or a model or a host or a machine)

[Syntax example]

> ssc logicalsoftware delete-software SoftwareA -soft DPMScenatio1 -point 1

2.12 Storage2.12.1 Adding Storage

Adds storage to a group, model, or host in a group.

A disk volume of a disk array is added to a group, model or host.

[Syntax]

ssc add storage GroupName [HostName] DiskArrayName DiskVolumeName [-hbanum HBANumber][-lun LUNNumber] [-after] [<-hostip ExportIPAddress | -nicno NicNumber>]

Chapter 2. Command for Setup

93 SigmaSystemCenter 3.5 ssc Command Reference

Page 104: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

GroupName(Required)

Specify a group or model to which you want to add the storage, or specify a groupincluding the host to which you want to add the storage.Specify a path to the group or model.You cannot specify a tenant or category.You cannot specify a model when you specify HostName(E.g. Category/Group, Group, Category/Group/Model).

[HostName] Specify a name of the host to which you want to add storage.

DiskArrayName(Required)

Specify a disk array name.

DiskVolumeName(Required)

Specify a disk volume name.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-hbanumHBANumber]

Specify the HBA number to be connected.You can specify the range of the number from 1 to 9999.If you do not specify this option, the system connects to all HBA numbers.For NetApp storage, this option is invalid.

[-lun LUNNumber] Specify a LUN number.You can specify zero or larger.If you specify a disk volume of EMC Symmetrix, you cannot specify this option.For NetApp storage and SMI-S services, this option is invalid.

[-after] If specified, the system connects to storage after distribution.If you do not specify this option, the system connects to storage before distribution.

[-hostipExportIPAddress]

Specify the IP address to be connected.You can specify the IP address set to host definitions.If you use DHCP, omit this option. In this case, the hostname is used.You can specify this option only when you add NetApp storage to host.

[-nicno NicNumber] Specify the NIC number that has IP address to be connected.By entering the numerical values separated by "/" like "1/2", you can specify the second orlater IP address you have assigned to the NIC.If you use DHCP, omit this option. In this case, the name of the host which is running onthe specified group or model will be used.You can specify this option only when you add NetApp storage to group or model.

[Note]

• In the case of SigmaSystemCenter 3.0 update 1, the connection setting for NetApp storage wasonly after software distribution. In SigmaSystemCenter 3.1 or later, you can also specify beforesoftware distribution as with other storage devices.

It is possible to specify whether storage connection is made before or after software distributionby the [-after] option.

• An unshared disk volume cannot be added to a host if the disk volume is already added toanother host.

• Unshared disk volume cannot be added to the group or model.

[How to specify the setting target]

This command will add the storage settings to the group, model, or host.

Chapter 2. Command for Setup

94 SigmaSystemCenter 3.5 ssc Command Reference

Page 105: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Setting target is specified as follows in how to specify the GroupName and HostName.

Setting target Value of GroupName Value of HostName

group group name -(omit)

model model name -(omit)

host the name of the group to where the host belongs host name

[Syntax examples]

>ssc add storage Category/group1 host001 DiskArray002 DiskVolume0102 –hbanum 1 -lun 5 -after >ssc add storage Category/group1 host001 DiskArray002 DiskVolume0103 >ssc add storage Category1/ESX esx200 DiskArray-002 Volume-001 -hostip 10.34.11.4

2.12.2 Deleting StorageDeletes a storage in a group, model, or host.

[Syntax]

ssc delete storage GroupName [HostName] <[DiskArrayName DiskVolumeName] | [-all]> [-i]

[Parameters and Options]

GroupName(Required)

Specify the path to the target group or model.The Tenant or Category cannot be specified.You cannot specify the Model when you delete the storage of the host.

[HostName] Specify the target host name.

[DiskArrayName] Specify the registered diskarray name.

[DiskVolumeName] Specify the registered diskvolume name.For NetApp storage and SMI-S services, the disk volume name iscase-sensitive.

[-all] All storages of the host are deleted.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete storage Category1/Group01 HOST-01 DiskArray-001 Volume-001 >ssc delete storage Group-A001 Host-A001 DiskArray-001 Volune-002 -i >ssc delete storage Group-B001 Host-B001 -all

2.12.3 Updating Disk ArrayUpdate a diskarray.

About updating a policy, see "2.21.2 Updating Custom Object (page 197)".

[Syntax]

ssc update diskarray DiskArrayName < [-ip IPAddress] [-account Account] [-p Password] [-iops on|off] [-dr on|off] > [-scope Scope] [-serialno SerialNumber]

[Parameters and Options]

Chapter 2. Command for Setup

95 SigmaSystemCenter 3.5 ssc Command Reference

Page 106: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

DiskArrayName(Required)

Specify a target disk array name.

[-ip IPAddress] Specify the IPAddress of the target disk array.

[-account Account] Specify an account name to log on to the target disk array.

[-p Password] Specify a password to log on to the target disk array.

[-iops on|off] Specify whether use or not for the IOPS function.on: use, off: not useThis option is only for NEC Storage.

[-dr on|off] Specify whether use or not for the data replication function.on: use, off: not useThis option is only for NEC Storage.

[-scope Scope] Specify a Scope.0:Global(default), 1:Local, 2:LDAPThis option is only for CLARiiON.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

*At least one of options (-ip, -account, -p, -iops, or -dr) is required.

[Syntax examples]

>ssc update diskarray DiskArray-001 -ip 192.168.0.1 -account admin -p admin >ssc update diskarray DiskArray-002 -ip 192.168.0.2 -account admin -p admin -scope 0 >ssc update diskarray DiskArray-003 -iops on >ssc update diskarray DiskArray-003 -dr off

2.12.4 Displaying Disk Array PathDisplays the disk array path.

[Syntax]

ssc show diskarraypath < DiskArrayName | < -machine [MachineName | -all | -unused] | -array[DiskArrayName] > [-vertical] > [-serialno SerialNumber]

[Parameters and Options]

DiskArrayName Specify a disk array name.

-machine[MachineName]

Specify a machine name.If you do not specify the machine name, display the machine information of all.

[-all] Display the path information of all.If you specify the -machine option, this option is valid.If you specify this option, also displays the path information not associated withmachine.

[-unused] Display the path information not associated with machine.If you specify the -machine option, this option is valid.

-array [DiskArrayName] Specify a disk array name.If you do not specify the disk array name, display the disk array information of all.

Chapter 2. Command for Setup

96 SigmaSystemCenter 3.5 ssc Command Reference

Page 107: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.If you specify -machine or -array option, this option is valid.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

[Syntax examples]

>ssc show diskarraypath CK200062700187SG01(CK200062700187/SP_A/0)SG01(CK200062700187/SP_A/1)

>ssc show diskarraypath -machine -all -vertical[1] MachineName : w2k8r2-san1 Location : 1 Address : 2003-0030-130f-47e2 ControllerName : WN:ldset_02 DiskArrayName : s1400

Location : 2 Address : 2004-0030-130f-47e2 ControllerName : WN:ldset_02 DiskArrayName : s1400

[2] MachineName : rh6-san1 Location : 1 Address : 00:16:97:a7:fc:40 ControllerName : 192.168.0.130 DiskArrayName : Ontap81

Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb ControllerName : LX:ldset_01 DiskArrayName : s1400

Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb ControllerName : SG01(CK200062700187/SP_A/0) DiskArrayName : CK200062700187

Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb ControllerName : SG01(CK200062700187/SP_A/1) DiskArrayName : CK200062700187

Location : 2 Address : 2014-0030-130f-47fb/2004-0030-130f-47fb ControllerName : LX:ldset_01 DiskArrayName : s1400

[3] MachineName : w2012-san1 Location : 1

Chapter 2. Command for Setup

97 SigmaSystemCenter 3.5 ssc Command Reference

Page 108: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Address : 2000-0000-c956-5140 ControllerName : DiskArrayName :

[4] MachineName : w2010-san1

[-] MachineName : Location : Address : 1000-0000-c956-c164 ControllerName : DF:ldset_10 DiskArrayName : s1400

[-] MachineName : Location : Address : 1000-0000-c956-c165 ControllerName : DF:ldset_10 DiskArrayName : s1400

>ssc show diskarraypath -machine -all#MachineName,Location,Address,ControllerName,DiskArrayName"w2k8r2-san1","1","2003-0030-130f-47e2","WN:ldset_02","s1400""w2k8r2-san1","2","2004-0030-130f-47e2","WN:ldset_02","s1400""rh6-san1","1","00:16:97:a7:fc:40","192.168.0.130","Ontap81""rh6-san1","1","2013-0030-130f-47fb/2003-0030-130f-47fb","LX:ldset_01","s1400""rh6-san1","1","2013-0030-130f-47fb/2003-0030-130f-47fb","SG01(CK200062700187/SP_A/0)","CK200062700187""rh6-san1","1","2013-0030-130f-47fb/2003-0030-130f-47fb","SG01(CK200062700187/SP_A/1)","CK200062700187""rh6-san1","2","2014-0030-130f-47fb/2004-0030-130f-47fb","LX:ldset_01","s1400""w2012-san1","1","2000-0000-c956-5140","","""w2010-san1","","","","""","","1000-0000-c956-c164","DF:ldset_10","s1400""","","1000-0000-c956-c165","DF:ldset_10","s1400"

>ssc show diskarraypath -array -vertical

[1] DiskArrayName : s1400 ControllerName : LX:ldset_01 Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb MachineName : rh6-san1

ControllerName : WN:ldset_02 Location : 1 Address : 2003-0030-130f-47e2 MachineName : w2k8r2-san1

ControllerName : WN:ldset_02 Location : 2 Address : 2004-0030-130f-47e2

Chapter 2. Command for Setup

98 SigmaSystemCenter 3.5 ssc Command Reference

Page 109: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

MachineName : w2k8r2-san1

ControllerName : DF:ldset_10 Location : Address : 1000-0000-c956-c164 MachineName :

ControllerName : DF:ldset_10 Location : Address : 1000-0000-c956-c165 MachineName :

ControllerName : WN:ldset_05 Location : Address : MachineName :

[2] DiskArrayName : CK200062700187 ControllerName : SG01(CK200062700187/SP_A/0) Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb MachineName : rh6-san1

ControllerName : SG01(CK200062700187/SP_A/1) Location : 1 Address : 2013-0030-130f-47fb/2003-0030-130f-47fb MachineName : rh6-san1

[3] DiskArrayName : Ontap81 ControllerName : 192.168.0.130 Location : 1 Address : 00:16:97:a7:fc:40 MachineName : rh6-san1

>ssc show diskarraypath -array#DiskArrayName,ControllerName,Location,Address,MachineName"s1400","LX:ldset_01","1","2013-0030-130f-47fb/2003-0030-130f-47fb","rh6-san1""s1400","WN:ldset_02","1","2003-0030-130f-47e2","w2k8r2-san1""s1400","WN:ldset_02","2","2004-0030-130f-47e2","w2k8r2-san1""s1400","DF:ldset_10","","1000-0000-c956-c164","""s1400","DF:ldset_10","","1000-0000-c956-c165","""s1400","WN:ldset_05","","","""CK200062700187","SG01(CK200062700187/SP_A/0)","1","2013-0030-130f-47fb/2003-0030-130f-47fb","rh6-san1""CK200062700187","SG01(CK200062700187/SP_A/1)","1","2013-0030-130f-47fb/2003-0030-130f-47fb","rh6-san1""Ontap81","192.168.0.130","1","00:16:97:a7:fc:40","rh6-san1"

2.12.5 Displaying Disk ArrayDisplays disk array information.

[Syntax]

ssc show diskarray [-vertical]

Chapter 2. Command for Setup

99 SigmaSystemCenter 3.5 ssc Command Reference

Page 110: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

[-vertical] The display format is changed. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc show diskarray >ssc show diskarray -vertical

[Display examples]

>ssc show diskarray -vertical[DiskArray-01] DiskArrayName : 200000255C3A05AA SerialNumber : 0000000941900148 Type : SMI-S Number : ManagedStatus : Managed StoragePoolCount : 3 AllDiskVolumeCount : 92 DiskVolumeCount(Managed) : 0 IPAddress : 192.168.0.100 UsesCapability : IOPS, LocalReplication

[Port-01] Port : 00-00h Address : 2100-0025-5C3A-05AA [Port-02] Port : 00-01h Address : 2200-0025-5C3A-05AA [Port-03] Port : 00-02h Address : 2300-0025-5C3A-05AA [Port-04] Port : 00-03h Address : 2400-0025-5C3A-05AA

ControllerIPAddress : 192.168.0.101,192.168.0.102

>ssc show diskarray#DiskArrayName,SerialNumber,Type,Number,ManagedStatus,StoragePoolCount,AllDiskVolumeCount,DiskVolumeCount(Managed),IPAddress,UsesCapability,Port,ControllerIPAddress"CLARiiON+CK200062700187","CK200062700187","SMI-S","","Managed","2","36","6","192.168.0.100","None","SP_A:0,5006-0160-41E0-0F99,SP_A:1,5006-0161-41E0-0F99,SP_B:0,5006-0168-41E0-0F99,SP_B:1,5006-0169-41E0-0F99","""M100","0000000941900148","iStorage","0","Managed","3","116","13","192.168.0.110","IOPS, LocalReplication","00-00h,2100-0025-5C3A-05AA,00-01h,2200-0025-5C3A-05AA,00-02h,2300-0025-5C3A-05AA,00-03h,2400-0025-5C3A-05AA","192.168.0.111,192.168.0.112""ontap805-7m","4061490-59-4","NetAppStorage","","Managed","3","1","1","192.168.0.150","None","",""

Chapter 2. Command for Setup

100 SigmaSystemCenter 3.5 ssc Command Reference

Page 111: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.12.6 Setting HBASets an HBA to a disk array.

[Syntax]

ssc set hba DiskArrayName DiskArrayPath WWPN [-wwnn WWNN] [-serialno SerialNumber]

[Parameters and Options]

DiskArrayName(Required)

Specify the disk array name.

DiskArrayPath(Required)

Specify the disk array path.

WWPN(Required)

Specify the WWPN address.

[-wwnn WWNN] Specify the WWNN address.It is required if the disk array type is "CLARiiON."

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

[Syntax examples]

>ssc set hba ck1000 "SG20(SP A/10.15.22.176/0)" 1000-0000-C96F-E240 >ssc set hba CLARiiON+CK1000 SG20 1000-0000-C96F-E240 -wwnn 2000-0000-C96F-E240

[Note]

• This command can be used when the disk array type is CLARiiON, Symmetrix or SMI-S.

• Specify alphabets that are included in the WWPN and WWNN in uppercase.

2.12.7 Releasing HBAReleases an HBA from a disk array.

[Syntax]

ssc release hba DiskArrayName DiskArrayPath WWPN [-wwnn WWNN] [-serialno SerialNumber]

[Parameters and Options]

DiskArrayName(Required)

Specify the disk array name.

DiskArrayPath(Required)

Specify the disk array path.

WWPN(Required)

Specify the WWPN address.

[-wwnn WWNN] Specify the WWNN address.It is required if the disk array type is "CLARiiON."

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

[Syntax examples]

Chapter 2. Command for Setup

101 SigmaSystemCenter 3.5 ssc Command Reference

Page 112: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc release hba CK100000 "SG20(SP A/10.15.22.176/0)" 1000-0000-C96F-E240 >ssc release hba CLARiiON+CK100000 SG20 1000-0000-C96F-E240 -wwnn 2000-0000-C96F-E240

[Note]

• This command can be used when the disk array type is CLARiiON, Symmetrix or SMI-S.

2.12.8 Creating Disk VolumeCreates a disk volume.

[Syntax]

ssc create diskvolume < DiskArrayName < PoolId | -pooltag StoragePoolTag...> > | < -pooltagStoragePoolTag... > [-num DiskVolumeNumber] [-name DiskVolumeName] [-type Type] [-serialnoSerialNumber] [-snapshot SnapshotReserve] -capacity Capacity [-thin | -thick] [-shared | -unshared][-iops [< Limit | none > < Reservation | none > < on | off >]]

[Parameters and Options of specifying "DiskArrayName"]

DiskArrayName(Required)

Specify a disk array name.

PoolId Specify a pool ID.For NetApp storage, specify the UUID.You cannot specify this option along with the -pooltag option.

[-pooltagStoragePoolTag...]

Specify a tag from those defined in StoragePool.You can specify multiple tags.The StoragePool that has the specified tag is automatically selected.The disk volume is created for the selected StoragePool.If you specify multiple tags, the StoragePool that has all of the specified tags isselected.You cannot specify this option along with PoolId.

[-numDiskVolumeNumber]

Specify a disk volume number.If you omit this option, the disk volume is automatically numbered.For NetApp storage and SMI-S services, this option is invalid.

-capacity Capacity(Required)

Specify a capacity in gigabytes (GB).The size of system areas are not included.

[-name DiskVolumeName] Specify a disk volume name.If you specify the -type option, you cannot omit this option.If you omit this option, the disk volume is automatically named.For NetApp storage, you cannot omit this option.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-type Type] Specify a disk volume type.Specify an operating system for host from among the following Types:"WN" : Specify in the case of Windows (MBR)."WG" : Specify in the case of Windows (GPT)."LX" : Specify in the case of Linux.You can specify only the disk volume of NEC Storage.If you omit the -name option, you cannot specify this option.

[-serialno SerialNumber] Specify the serial number of the disk array.

Chapter 2. Command for Setup

102 SigmaSystemCenter 3.5 ssc Command Reference

Page 113: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Use this option if there is more than one disk array with the same name of the diskarray.

[-snapshotSnapshotReserve]

Specify the disk space for a volume snapshot.You can specify from 0 percent to 100 percent.If omitted, the disk space for the volume snapshot depends on the default value of astorage device.This option is valid for NetApp storages only.

[-thin | -thick] For CLARiiON / VNXSpecify when you create a LUN(Thin / Non-thin) for StoragePool.-thin: Create a Thin LUN.-thick: Create a Non Thin LUN.It is enabled only in CLARiiON / VNX with FLARE30 or later.If you omit this option, the LUN is created to RaidGroup.If you specify these options for RaidGroup, an error occurs.If you specify this option, the LUN is created for StoragePool.If you omit this option for StoragePool, an error occurs.For SMI-S Services-thin: Create a Thin Provisioning volume.-thick: Create a normal(Non-thin Provisioning) volume.If you omit this option, the type of LUN depends on the device.For other storage devices, this option is ignored.You cannot specify this option along with the -pooltag option.If you specify the -pooltag option, the type of LUN is determined based on the type ofthe selected disk array or StoragePool automatically.

[-shared | -unshared] Specify the shared status of the disk volume.-shared: shared status-unshared: unshared statusIf omitted, the status is shared.

[-iops [< Limit | none > <Reservation | none > < on |off >]]

Enables the IOPS setting of the diskvolume.

you can specify a detail value, see below:< Limit | none > : Set the upper limit. The valid value is 10-1000000. Specify a 'none',deleted the upper limit.< Reservation | none > : Set the lower limit. the valid value is 10-1000000. Specify a'none', deleted the lower limit.< on | off > : Specify the iStorageManager practical use log record when the upperlimit control occurred. Valid value : on:Enable, off:Disable.

If omitted this option, the default values of the specified StoragePool are used.This option is valid for NEC Storage only.

[Parameters and Options of not specifying "DiskArrayName"]

-pooltag StoragePoolTag...(Required)

Specify a tag from those defined in StoragePool.You can specify multiple tags.The StoragePool that has the specified tag is automatically selected. The disk volume iscreated for the selected StoragePool.If you specify multiple tags, the StoragePool that has all of the specified tags isselected.

-capacity Capacity Specify a capacity in gigabytes (GB).

Chapter 2. Command for Setup

103 SigmaSystemCenter 3.5 ssc Command Reference

Page 114: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required) The size of system areas are not included.

-name DiskVolumeName(Required)

Specify a disk volume name.If NetApp storage and SMI-S services have been selected for a creating disk volume,the disk volume name is case-sensitive.

[-shared | -unshared] Specify the shared status of the disk volume.-shared: shared status-unshared: unshared statusIf omitted, the status is shared.

[-iops] Enables the IOPS setting of the diskvolume.The IOPS value uses storage pool default.

This option is valid for NEC Storage only.

• If you specify any of the following options, an error occurs.

• The disk array and StoragePool are selected automatically.

• The following settings are applied for creating the disk volume.

Item Option Setting to be applied Note

Disk array name DiskArrayName The disk array will be selected automatically.

Pool ID PoolId The StoragePool is automatically selected based on thespecified tag.

Disk volume number -num The disk volume is automatically numbered.

Disk volume type -type Please refer to the [Note] below.

Disk space of the volumesnapshot

-snapshot Depend on the default value of the storage device.

Thin provisioning -thin | -thick The type of LUN is determined based on the type of theselected disk array or StoragePool.

[Note]

• For Symmetrix, this command is not supported.

• Creating disk volumes by Pool of Thin Provisioning is supported in FLARE30 or later(CLARiiON and VNX).

• Control volume (CV) is not supported (NEC Storage).

• Creating disk volumes by RANK is not supported (NEC Storage).

• When this command is executed with the name of disk volume specified but it fails, the diskvolume may be created with the default name.

Update the diskvolume name if needed.

• If DiskVolumeName is specified, check the specification of each storage for the availablecharacter strings and size.

• If you omit the -type option, the result will be the following (NEC Storage):

- In the case of S/D series, the disk volume type is assumed to be "LX".

- In the case of M series, the disk volume type is assumed to be unspecified.

• For SMI-S services, the pool ID is case-sensitive.

• If you specify the '-tag' and '-iops' option, the IOPS upper limit or lower limit control selects apossible stororage pool.

Chapter 2. Command for Setup

104 SigmaSystemCenter 3.5 ssc Command Reference

Page 115: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc create diskvolume DiskArray-001 1 -capacity 200 >ssc create diskvolume DiskArray-001 1 -capacity 200 -name Volume-001 >ssc create diskvolume DiskArray-001 1 -capacity 200 -name Volume-001 -type lx >ssc create diskvolume DiskArray-001 1 -capacity 200 -num 1 >ssc create diskvolume DiskArray-002 5e0a90ca-d9c6-11e0-8c89-005056b50006 -capacity 5 -name Volume-001 -snapshot 0 >ssc create diskvolume DiskArray-001 1 -capacity 200 -name Volume-001 -type lx -iops 200 20 on

>ssc create diskvolume DiskArray-001 1 -capacity 200 -name Volume-001 -thin >ssc create diskvolume DiskArray-001 1 -capacity 200 -name Volume-001 -thick >ssc create diskvolume DiskArray-001 1 -capacity 200 -unshared

>ssc create diskvolume DiskArray-001 -pooltag Gold Tokyo -capacity 200 -name Volume-001 -unshared >ssc create diskvolume -pooltag Gold Tokyo -capacity 200 -name Volume-001 -unshared >ssc create diskvolume -pooltag Gold Tokyo -capacity 200 -name Volume-003 -shared -iops

2.12.9 Updating Disk VolumeUpdates a disk volume.

[Syntax]

ssc update diskvolume DiskArrayName

<-num DiskVolumeNumber | -name DiskVolumeName>

[-serialno SerialNumber]

<[-newname NewDiskVolumeName]

[-type Type]

[-tag Tag...]

[-shared | -unshared]

[-managed | -unmanaged]

[-capacity NewCapacity]

[-lmt [Limit]]

[-rsv [Reservation]]

[-lmtrpt on|off]>

[Parameters and Options]

DiskArrayName(Required)

Specify a disk array name in which a target disk volume exists.

-num DiskVolumeNumber Specify the target disk volume number.

Chapter 2. Command for Setup

105 SigmaSystemCenter 3.5 ssc Command Reference

Page 116: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

For NetApp storage and SMI-S services, you cannot specify this option.

-name DiskVolumeName Specify the target disk volume name.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

[-newnameNewDiskVolumeName]

Specify an updated disk-volume name.

[-type Type] Specify an updated disk-volume type.Specify the operating system for a host among the following Types:"WN" : Specify in the case of Windows (MBR)."WG" : Specify in the case of Windows (GPT)."LX" : Specify in the case of Linux.If omitted, the disk volume type is not changed. However, some models of thedisk volume type might be set to "LX".You can specify the disk volume of NEC Storage only.

[-tag Tag...] Specify a tag to be updated. You can specify multiple tags.

[-shared | -unshared] Specify the shared status of the disk volume.-shared: shared status-unshared: unshared status

[-managed | -unmanaged] Specify the management status of the disk volume.-managed: managed status-unmanaged: unmanaged status

[-capacity NewCapacity] Specify the entire disk volume capacity including the extended part in gigabytes(GB).The size of system areas is not included.This option is valid for SMI-S services only.

[-lmt [Limit]] Specify the upper limit.valid value : 10-1000000(IOPS)If omitted, the existing value will be removed.This option is valid for NEC Storage only.

[-rsv [Reservation]] Specify the lower limit.valid value : 10-1000000(IOPS)If omitted, the existing value will be removed.This option is valid for NEC Storage only.

[-lmtrpt on|off] Specify the iStorageManager practical use log record when the upper limit controloccurred.Valid value : on:Enable off:DisableThis option is valid for NEC Storage only.

• At least one of options (-newname, -type, -tag, -shared, -unshared, -managed, -unmanaged, -capacity, -lmt, -rsv, or -lmtrpt) is required.

[Note]

• In the case of Symmetrix and NetApp storage, the volume name change (-newnamespecification) with this command is not supported.

• If you omit the -type option, the result will be as follows (NEC Storage):

Chapter 2. Command for Setup

106 SigmaSystemCenter 3.5 ssc Command Reference

Page 117: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

- If the type of the target disk volume has already been specified

* Not changed.

- If the type of the target disk volume has not been specified

* In the case of a S/D series, the disk volume type is "LX".

* In the case of an M series, the disk volume type is not specified and not changed.

• You cannot use blanks in a tag. A tag including blanks-even if those are enclosed with doublequotes (")-cannot be registered.

• The -capacity option is only supported for extending the capacity of the disk volume.

• If you specify the IOPS option, require the IOPS license on the storage system.

[Syntax examples]

>ssc update diskvolume DiskArray-001 -name Volume-001 -newname Volume-001-newname >ssc update diskvolume DiskArray-001 -name Volume-001 -newname Volume-001-newname -type lx >ssc update diskvolume DiskArray-001 -num 1 -newname Volume-001-newname -type lx >ssc update diskvolume DiskArray-001 -name Volume-001 -newname Volume-001-newname -type lx -tag tag1 tag2 tag3 >ssc update diskvolume DiskArray-001 -name Volume-001 -shared -managed >ssc update diskvolume DiskArray-001 -name Volume-001 -newname Volume-001-newname -capacity 28 >ssc update diskvolume DiskArray-001 -name Volume-001 -lmt 100 -rsv 50 -lmtrpt on >ssc update diskvolume DiskArray-001 -name Volume-001 -lmt -rsv

2.12.10 Deleting Disk VolumeDeletes the disk volume.

[Syntax]

ssc delete diskvolume DiskArrayName < -num DiskVolumeNumber | -name DiskVolumeName > [-serialno SerialNumber]

[Parameters and Options]

DiskArrayName(Required)

Specify a disk array name.

-num DiskVolumeNumber Specify a disk volume number.For NetApp storage and SMI-S services, you cannot specify this option.

-name DiskVolumeName Specify a disk volume name.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

[Note]

Chapter 2. Command for Setup

107 SigmaSystemCenter 3.5 ssc Command Reference

Page 118: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• In the case of Symmetrix, this command is not supported.

• If the registry(HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/NEC/PVM/base/StrictMode/Storage) is not 0 (default value is 0)

- The specified disk volume cannot be deleted if the disk volume is already assigned to amachine.

- The specified disk volume cannot be deleted if the disk volume is already added to agroup, model, or host in a group.

[Syntax examples]

>ssc delete diskvolume DiskArray-001 -name Volume-001 >ssc delete diskvolume DiskArray-001 -num 1

2.12.11 Assigning Disk VolumeAssigns a disk volume to the machine.

[Syntax]

ssc assign diskvolume <GroupName | MachineName> DiskArrayName <-num DiskVolumeNumber...| -name DiskVolumeName...> [-ostype OperatingSystemType] [-lun LUN] [-hbanumberHBANumber...] [-serialno SerialNumber] [-hostip ExportIPAddress] [-host HostName] [-force]

[Parameters and Options]

GroupName Specify the group to be assigned.Or specify the path to the group.You cannot specify a tenant, category or model.E.g.) Category/Group, Group

MachineName Specify the path to the machine to be assigned.E.g.)Operations view: operations:/category/group/hostResource view: resource:/group/machine

DiskArrayName(Required)

Specify a disk array name.

-num DiskVolumeNumber Specify a disk volume number to be assigned.You can specify multiple numbers.For NetApp storage and SMI-S services, you cannot specify this option.

-name DiskVolumeName Specify a disk volume name to be assigned.You can specify multiple names.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-ostypeOperatingSystemType]

Specify the operating system of the host by the following Types:"WN": Specify in the case of Windows."LX": Specify in the case of Linux.For NEC storage and SMI-S services, this option is valid.If you specify the machine that is running in an operation group, you do not need tospecify this item.

[-lun LUN] Specify an LUN number.If you do not specify this option, an LUN is automatically numbered.The value more than or equal to 0 can be specified for this option.

Chapter 2. Command for Setup

108 SigmaSystemCenter 3.5 ssc Command Reference

Page 119: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you want to specify multiple disk volumes, specify the start number for this option.For NetApp storage and SMI-S services, this option is invalid.

[-hbanumber HBANumber] Specify an HBA number to be assigned.Specify a value in the range of 0-9999.If you do not specify this option, the system connects to all HBAs.For NetApp storage, this option is invalid.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

[-hostip ExportIPAddress] Specify an IP address to be assigned.You can specify the IP address set to host definition.If you use DHCP, do not specify this option. In this case, the host name is used.Only NetApp storage you can specify this option.If you specify a group name, do not use this option.

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for MachineName.Specify this option if there is a model with the same name as the target host.

[-force] Assign an unshared disk volume mandatorily to a specified machine even though thedisk volume is already assigned to another machine.

[Note]

• For Symmetrix, this command is not supported.

• For CLARiiON and NetApp storage, this command can be executed only to the runningmachine.

• If you specify the group with NetApp storage, the host name in the group is used.

If you specify the group with the -hostip option, the disk volume is only assigned to the machinewith the specified IP address.

[Syntax examples]

>ssc assign diskvolume machine001 DiskArray-001 -name Volume-001 >ssc assign diskvolume machine002 DiskArray-001 -name Volume-001 -force >ssc assign diskvolume machine001 DiskArray-001 -num 1 >ssc assign diskvolume machine001 DiskArray-001 -name Volume-001 Volume-002 Volume-003 -lun 0 -hbaNumber 1 >ssc assign diskvolume machine001 DiskArray-001 -name Volume-001 -ostype lx >ssc assign diskvolume VmServer-g/esx/esx10 DiskArray-002 -name Volume-001 -hostip 10.34.11.4 >ssc assign diskvolume VmServer-g/esx DiskArray-002 -name Volume-002

2.12.12 Releasing Disk VolumeReleases a disk volume from the machine.

[Syntax]

ssc release diskvolume <GroupName | MachineName> DiskArrayName <-num DiskVolumeNumber...| -name DiskVolumeName...> [-hbanumber HbaNumber...] [-serialno SerialNumber] [-hostHostName] [-force] [-nondetach]

Chapter 2. Command for Setup

109 SigmaSystemCenter 3.5 ssc Command Reference

Page 120: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

GroupName Specify the group to be released.Or specify the path to the group.You cannot specify a tenant, category or model.E.g.) Category/Group, Group

MachineName Specify the path to the machine.E.g.)In the Operations view: operations:/category/group/hostIn the Resource view: resource:/group/machine

DiskArrayName(Required)

Specify the disk array name.

-num DiskVolumeNumber Specify the disk volume number.You can specify multiple numbers.For NetApp storage and SMI-S services, you cannot specify this option.

-name DiskVolumeName Specify the disk volume name.You can specify multiple names.For NetApp storage and SMI-S services, the disk volume name is case-sensitive.

[-hbanumber HBANumber] Specify the HBA number.Specify the value in the range of 0-9999.If you do not specify this option, the system disconnects all HBAs from the machine.For NetApp storage, this option is invalid.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for GroupName.Specify this option if there is a model with the same name as the target host.

[-force] Release a disk volume mandatorily from a running machine.

[-nondetach] Detachment from the disk managed by the virtualization infrastructure is not executed.

[Note]

• For Symmetrix, this command is not supported.

• For CLARiiON, this command can be executed only to the running machine.

• The allocation release of the disk volume is executed even

when failing in the separation (detach) to the disk volume managed by the virtualizationinfrastructure.

• If the following registry is not 0 (default value is 0), the disk volume cannot be released fromthe running machine. If you want to release the disk volume, you have to specify -force option.

HKEY_LOCAL_MACHINE/SOFTWARE/Wow6432Node/NEC/PVM/base/StrictMode/Storage

[Syntax examples]

>ssc release diskvolume machine001 DiskArray-001 -name Volume-001 >ssc release diskvolume machine001 DiskArray-001 -num 1 >ssc release diskvolume machine001 DiskArray-001

Chapter 2. Command for Setup

110 SigmaSystemCenter 3.5 ssc Command Reference

Page 121: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-name Volume-001 Volume-002 Volume-003 -hbaNumber 1 >ssc release diskvolume machine001 DiskArray-001 -name Volume-001 -force >ssc release diskvolume VmServer-g/esx DiskArray-002 -name Volume-002

2.12.13 Displaying Disk VolumeDisplays disk volume information.

[Syntax]

ssc show diskvolume DiskArrayName [-num DiskVolumeNumber | -name DiskVolumeName] [-serialno SerialNumber] [-vertical] [-iops] [-dr]

[Parameters and Options]

DiskArrayName(Required)

Specify a disk array name.

[-num DiskVolumeNumber] Specify a disk volume number to display the disk volume information.If you do not specify this option, all disk volumes are displayed.For NetApp storage and SMI-S services, this option is invalid.

[-name DiskVolumeName] Specify a disk volume name to display the disk volume information.If you do not specify this option, all disk volumes are displayed.For NetApp storage and SMI-S services, disk volume names are case-sensitive.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

[-vertical] The display format is changed. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[-iops] IOPS items are displayed.

[-dr] Data replication items are displayed.

[Syntax examples]

>ssc show diskvolume DiskArray-001 >ssc show diskvolume DiskArray-001 -vertical >ssc show diskvolume DiskArray-001 -name Volume-001 >ssc show diskvolume DiskArray-001 -name Volume-001 -vertical >ssc show diskvolume DiskArray-001 -num 1 >ssc show diskvolume DiskArray-001 -iops >ssc show diskvolume DiskArray-001 -dr

[Display examples]

>ssc show diskvolume DiskArray-001 -vertical

[DiskVolume-01] DiskVolumeName : Volume-001 DiskVolumeNumber : 1 UniqueId : 00255c3a05aa0001 DiskVolumeSize (GB) : 250.0 Type : LX Format : - ConsumedCapacity (GB) : 12.8

Chapter 2. Command for Setup

111 SigmaSystemCenter 3.5 ssc Command Reference

Page 122: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Tag : Gold ExtendedUniqueId : 600255c00000000000255c3a05aa0001

[DiskVolume-02] DiskVolumeName : Volume-002 DiskVolumeNumber : 2 UniqueId : 00255c3a05aa0002 DiskVolumeSize (GB) : 250.0 Type : LX Format : 20% Tag : Silver ExtendedUniqueId : 600255c00000000000255c3a05aa0002

>ssc show diskvolume DiskArray-001

#DiskVolumeName,DiskVolumeNumber,UniqueId,DiskVolumeSize (GB),Type,Format,ConsumedCapacity (GB),Tag,ExtendedUniqueId"Volume-001","1","00255c3a05aa0001","250.0","LX","-","12.8","Gold","600255c00000000000255c3a05aa0001""Volume-002","2","00255c3a05aa0002","250.0","LX","20%","","Silver","600255c00000000000255c3a05aa0002"

>ssc show diskvolume DiskArray-001 -name Volume-001 -vertical

[DiskVolume-01] DiskVolumeName : Volume-001 DiskVolumeNumber : 1 UniqueId : 20000030138400540000 DiskVolumeSize (GB) : 250.0 Type : LX Format : - ConsumedCapacity (GB) : 12.8 Tag : Gold ExtendedUniqueId : 600255c00000000000255c3a05aa0001

>ssc show diskvolume DiskArray-001 -name Volume-001

#DiskVolumeName,DiskVolumeNumber,UniqueId,DiskVolumeSize (GB),Type,Format,ConsumedCapacity (GB),Tag,ExtendedUniqueId "Volume-001","1","00255c3a05aa0001","250.0","LX","-","12.8","Gold","600255c00000000000255c3a05aa0001"

>ssc show diskvolume DataONTAP -name vol1 -vertical

[DiskVolume-01] DiskVolumeName : vol1 DiskVolumeNumber : 0 UniqueId : 07c0cfc2-e187-11e0-8682-000c2989b168 DiskVolumeSize (GB) : 0.0 Type : - Format : - Tag : Bronze ExtendedUniqueId :

>ssc show diskvolume DiskArray-001 -vertical -iops[DiskVolume-01]

Chapter 2. Command for Setup

112 SigmaSystemCenter 3.5 ssc Command Reference

Page 123: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

DiskVolumeName : Volume-001DiskVolumeNumber : 1UniqueId : 00255c3a05aa0001DiskVolumeSize (GB) : 250.0Type : LXFormat : -ConsumedCapacity (GB) : 12.8Tag : GoldExtendedUniqueId : 600255c00000000000255c3a05aa0001Limit (IOPS) : 200Reservation (IOPS) : noneLimitControlReport : on

[DiskVolume-02]DiskVolumeName : Volume-002DiskVolumeNumber : 2UniqueId : 00255c3a05aa0002DiskVolumeSize (GB) : 250.0Type : LXFormat : 20%Tag : SilverExtendedUniqueId : 600255c00000000000255c3a05aa0002Limit (IOPS) : noneReservation (IOPS) : noneLimitControlReport : off

>ssc show diskvolume DiskArray-001 -iops

#DiskVolumeName,DiskVolumeNumber,UniqueId,DiskVolumeSize (GB),Type,Format,ConsumedCapacity (GB),Tag,ExtendedUniqueId,Limit (IOPS),Reservation (IOPS),LimitControlReport"Volume-001","1","00255c3a05aa0001","250.0","LX","-","12.8","Gold","600255c00000000000255c3a05aa0001","200","none","on""Volume-002","2","00255c3a05aa0002","250.0","LX","20%","","Silver","600255c00000000000255c3a05aa0002","none","none","off"

>ssc show diskvolume DiskArray-001 -vertical -dr[DiskVolume-01] DiskVolumeName : Volume-001 DiskVolumeNumber : 1 UniqueId : 00255c3a05aa0001 DiskVolumeSize (GB) : 250.0 Type : LX Format : - ConsumedCapacity (GB) : 12.8 Tag : Gold ExtendedUniqueId : 600255c00000000000255c3a05aa0001 SubType : MV

[ReplicationInfo-01] DiskVolumeName : rv_001 ReplicationStatus : Synchronized ReplicationDate : 2016/10/10 10:10:10

[DiskVolume-02] DiskVolumeName : Volume-002 DiskVolumeNumber : 2

Chapter 2. Command for Setup

113 SigmaSystemCenter 3.5 ssc Command Reference

Page 124: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

UniqueId : 00255c3a05aa0002 DiskVolumeSize (GB) : 250.0 Type : LX Format : 20% Tag : Silver ExtendedUniqueId : 600255c00000000000255c3a05aa0002 SubType : RV SourceVolumeName : Volume01 ReplicationStatus : Synchronized ReplicationDate : 2016/10/10 10:10:10

>ssc show diskvolume DiskArray-001 -dr

#DiskVolumeName,DiskVolumeNumber,UniqueId,DiskVolumeSize (GB),Type,Format,ConsumedCapacity (GB),Tag,ExtendedUniqueId,SubType,SourceVolumeName,ReplicationStatus,ReplicationDate,ReplicationInfo"Volume-001","1","00255c3a05aa0001","250.0","LX","-","12.8","Gold","600255c00000000000255c3a05aa0001","MV","-","-","-","rv_001,Synchronized,2016/10/10 10:10:10""Volume-002","2","00255c3a05aa0002","250.0","LX","20%","","Silver","600255c00000000000255c3a05aa0002","RV","Volume01","Synchronized","2016/10/10 10:10:10","-"

[Notes]

• This command does not support Symmetrix.

• WN, WG, LX, or "-" is displayed in "Type" for NEC Storage. Thin, Thick, or "-" is displayedexcept for NEC Storage.

• The percent of format progress rate of the disk volume is displayed in "Format" (NEC Storage).

- For CLARiiON, NetApp storage, and SMI-S services, "-" is always displayed.

• ConsumedCapacity is displayed only when the specified disk volume is Virtual volume.

• "Limit", "Reservation," and "LimitControlReport" are displayed when the IOPS option isspecified.

- "N/A" is displayed when IOPS values are not acquirable.

- "-" is displayed when storage systems do not support IOPS.

• "SubType", "SourceVolumeName", "ReplicationStatus", "ReplicationDate," and"ReplicationInfo" are displayed when the Data Replication option is specified.

2.12.14 Updating Storage PoolUpdates a storage pool.

[Syntax]

ssc update storagepool DiskArrayName PoolId

<[-tag Tag...] [-guide guide] [-lmtmode on|off] [-rsvmode on|off] [-thre Threshold] [-lmtdef [Limit]][-rsvdef [Reservation]]>

[-pooltype StoragePoolType]

[-serialno SerialNumber]

[Parameters and Options]

DiskArrayName Specify a disk array name.

Chapter 2. Command for Setup

114 SigmaSystemCenter 3.5 ssc Command Reference

Page 125: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required)

PoolId(Required)

Specify a pool ID.For NetApp storage, specify a UUID.

-tag Tag... Specify a tag to be updated. You can specify multiple tags.

[-guide Guide] Specify a performance guide value.Valid value : Positive integer(IOPS)This option is valid for NEC Storage only.

[-lmtmode on|off] Specify on or off for the upper limit control.This option is valid for NEC Storage only.

[-rsvmode on|off] Specify on or off for the upper lower control.This option is valid for NEC Storage only.

[-thre Threshold] Specify the lower limit control threshold.Valid value : 0-100(percentage)This option is valid for NEC Storage only.

[-lmtdef [Limit]] Specify the default of the upper limit when create a diskvolume.Valid value : 10-1000000(IOPS)If omitted, the existing value will be removed.This option is valid for NEC Storage only.

[-rsvdef [Reservation]] Specify the default of the lower limit when create a diskvolume.valid value : 10-1000000(IOPS)If omitted, the existing value will be removed.This option is valid for NEC Storage only.

[-pooltypeStoragePoolType]

Specify the pool type of a storage pool.Specify this option when the storage pool cannot be identified uniquely with thePoolId.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

• At least one of options (-tag, -guide, -lmtmode, -rsvmode, -thre, -lmtdef, or -rsvdef) is required.

[Note]

• You cannot use blanks in a tag. A tag including blanks-even if those are enclosed with doublequotes (")-cannot be registered.

• PoolID is case-sensitive.

• If you specify the IOPS option, require the IOPS license on a storage system.

[Syntax examples]

>ssc update storagepool DiskArray-001 1 -tag tag1 tag2 tag3 >ssc update storagepool DiskArray-001 1 -guide 2000 -lmtmode on -rsvmode on -thre 70 -lmtdef 500 -rsvdef 100 >ssc update storagepool DiskArray-001 1 -lmtdef -rsvdef

2.12.15 Displaying Storage PoolDisplays storage pool information.

Chapter 2. Command for Setup

115 SigmaSystemCenter 3.5 ssc Command Reference

Page 126: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc show storagepool < DiskArrayName [-num PoolId | -pooltag StoragePoolTag...] > |

< -pooltag StoragePoolTag... > [-serialno SerialNumber] [-vertical] [-iops]

[Parameters and Options]

DiskArrayName Specify a disk array name.

[-num PoolId] Specify a pool ID.Displays the storage pool information of the specified pool ID and the information of thedisk volume located under the storage pool.If you do not specify this option, all storage pools are displayed.For NetApp storage, specify a UUID.You cannot specify this option with the -pooltag option at the same time.If you specify the -num option, DiskArrayName is required.

[-pooltagStoragePoolTag...]

Specify a pool tag.You can specify multiple values.The storage pools that have the specified tag are automatically selected.You cannot specify this option with the -num option at the same time.

[-serialnoSerialNumber]

Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the disk array.

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[-iops] If you do specify this option, Displays IOPS items.

• Value of PoolType

Basic Basic Pool (NEC Storage), RaidGroup (CLARiiON and VNX), Aggregate (NetApp)

Dynamic Dynamic Pool (NEC Storage)

Thin Thin Pool (NEC Storage), StoragePool (CLARiiON and VNX), Thin Pool (SMI-S services)

Hybrid Multi Tiered Pool (NEC Storage)

- except Thin Pool (SMI-S services)

[Note]

• For Symmetrix, this command is not supported.

• RANK is not supported. (NEC Storage)

[Syntax examples]

>ssc show storagepool DiskArray-001 >ssc show storagepool DiskArray-001 -vertical >ssc show storagepool DiskArray-001 -num 1 >ssc show storagepool DiskArray-001 -num 1 -vertical >ssc show storagepool DiskArray-001 -pooltag Gold Tokyo >ssc show storagepool -pooltag Gold Tokyo -vertical

[Display examples]

Chapter 2. Command for Setup

116 SigmaSystemCenter 3.5 ssc Command Reference

Page 127: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc show storagepool DiskArray-001 -vertical

[StoragePool-01] StoragePoolName : Pool-001 StoragePoolId : 1 Capacity (GB) : 20480.0 FreeCapacity (GB) : 20255.5 PhysicalCapacity (GB) : 1066.8 ConsumedCapacity (GB) : 21.5 PoolType : Thin Tag : Gold Tokyo

[StoragePool-02] StoragePoolName : Pool-002 StoragePoolId : 2 Capacity (GB) : 130.5 FreeCapacity (GB) : 130.5 PoolType : Dynamic Tag : Silver [StoragePool-03] StoragePoolName : Pool-003 StoragePoolId : 3 Capacity (GB) : 4096.0 FreeCapacity (GB) : 1024.0 PoolType : Hybrid Tag :

>ssc show storagepool DiskArray-001

#StoragePoolName,StoragePoolId,Capacity (GB),FreeCapacity (GB),PhysicalCapacity (GB),ConsumedCapacity (GB),PoolType,Tag"Pool-001","1","20480.0","20255.5","1066.8","21.5","Thin","Gold Tokyo""Pool-002","2","130.5","130.5","","","Dynamic","Silver""Pool-003","3","4096.0","1024.0","","","Hybrid",""

>ssc show storagepool DiskArray-001 -num 1 -vertical

[StoragePool-01] StoragePoolName : Pool-001 StoragePoolId : 1 Capacity (GB) : 20480.0 FreeCapacity (GB) : 20255.5 PhysicalCapacity (GB) : 1066.8 ConsumedCapacity (GB) : 21.5 PoolType : Thin Tag : Gold Tokyo

[DiskVolume-01] DiskVolumeName : Volume-001 DiskVolumeNumber : 1 Tag : Gold

[DiskVolume-02] DiskVolumeName : Volume-002 DiskVolumeNumber : 2 Tag : Gold

Chapter 2. Command for Setup

117 SigmaSystemCenter 3.5 ssc Command Reference

Page 128: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc show storagepool DiskArray-001 -num 1

[StoragePool]#StoragePoolName,StoragePoolId,Capacity (GB),FreeCapacity (GB),PhysicalCapacity (GB),ConsumedCapacity (GB),PoolType,Tag"Pool-001","1","20480.0","20255.5","1066.8","21.5","Thin","Gold Tokyo"

[Diskvolume]#DiskVolumeName,DiskVolumeNumber,Tag"Volume-001","1","Gold""Volume-002","2","Gold"

>ssc show storagepool dataontap -vertical[StoragePool-01] StoragePoolName : aggr0 StoragePoolId : 786e2870-c3ee-11e0-a56c-005056b50006 Capacity (GB) : 0.8 FreeCapacity (GB) : 0.0 PoolType : Basic Tag : Gold

[StoragePool-02] StoragePoolName : aggr1 StoragePoolId : 8f5700ca-c641-11e0-8ca2-005056b50006 Capacity (GB) : 0.8 FreeCapacity (GB) : 0.3 PoolType : Basic Tag : Silver

[StoragePool-03] StoragePoolName : aggr2 StoragePoolId : 5e0a90ca-d9c6-11e0-8c89-005056b50006 Capacity (GB) : 2.5 FreeCapacity (GB) : 2.5 PoolType : Basic Tag : Bronze

>ssc show storagepool DiskArray-001 -pooltag Gold Tokyo

#DiskArrayName,SerialNumber,StoragePoolName,StoragePoolId,Capacity (GB),FreeCapacity (GB),PhysicalCapacity (GB),ConsumedCapacity (GB),PoolType,Tag"M100","0000000941900148","Pool-001","1","20480.0","20255.5","1066.8","21.5","Thin","Gold Tokyo"

>ssc show storagepool -pooltag Gold Tokyo -vertical

[StoragePool-01] DiskArrayName : M100 SerialNumber : 0000000941900148 StoragePoolName : Pool-001 StoragePoolId : 1 Capacity (GB) : 20480.0 FreeCapacity (GB) : 20255.5 PhysicalCapacity (GB) : 1066.8 ConsumedCapacity (GB) : 21.5

Chapter 2. Command for Setup

118 SigmaSystemCenter 3.5 ssc Command Reference

Page 129: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

PoolType : Thin Tag : Gold Tokyo

>ssc show storagepool DiskArray-001 -iops -vertical[StoragePool-01] StoragePoolName : Pool-001 StoragePoolId : 0 Capacity (GB) : 1779.3 FreeCapacity (GB) : 30.0 PoolType : Dynamic Tag : b LimitControlMode : On ReservationControlMode : Off TotalLimit (IOPS) : 1000 TotalReservation (IOPS) : 100 ReservationControlThreshold (%) : 60 ReservationControlStatus : Executing(Performing the Lower Control) DefaultLimitOfLD (IOPS) : 200 DefaultReservationOfLD (IOPS) : none

> ssc show storagepool DiskArray-003 -iops#StoragePoolName,StoragePoolId,Capacity (GB),FreeCapacity (GB),PhysicalCapacity (GB),ConsumedCapacity (GB),PoolType,Tag,LimitControlMode,ReservationControlMode,TotalLimit (IOPS),TotalReservation (IOPS),ReservationControlThreshold (%),ReservationControlStatus,DefaultLimitOfLD (IOPS),Default ReservationOfLD (IOPS)"Pool-001","1","67584.0","66009.5","1066.8","863.8","Thin","a","a b","-","-",","-","-","-","-","-"

[Note]

• PhysicalCapacity and ConsumedCapacity are displayed only when the specified pool is VirtualProvisioning Pool.

• If you specify the pool tag, the disk volume information is not output.

• If you specify the pool tag, the DiskArrayName and SerialNumber are displayed.

• "LimitControlMode", "ReservationControlMode", "TotalLimit", "TotalReservation",

"ReservationControlThreshold", "ReservationControlStatus", "DefaultLimitOfLD",

and "DefaultReservationOfLD" are output at the time of IOPS option specified.

- If can't be acquired, each outputs "N/A".

- If storage system was not supported IOPS, each outputs "-".

2.12.16 Updating the Use or the Status of the RDM DiskUpdates the use or the status of the RDM Disk.

[Syntax]

ssc rdmstorage update <[rdm | none | clean] | [-tag Tag... [-overwrite]]>

-vms VmsName [-size Size | -id UniqueId | -name LunName]

[Parameters and Options]

Chapter 2. Command for Setup

119 SigmaSystemCenter 3.5 ssc Command Reference

Page 130: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[rdm | none | clean] Specify the operation from the following:rdm : Sets the ordinary disk to the disk for RDM.none : Removes the 'unused' or 'used' disk from the RDM usage.clean : Changes the status of 'used' disk to 'unused'.

[-tag Tag...] Specify tags for the target disk. You can specify multiple tags.If you do not specify the -overwrite option, LUNs that have tags already are not selected.If you specify "-tag" only without specifying "Tag", the tag information already set to the tagwill be deleted.

[-overwrite] Specified tags is overwritten.This option is enabled if you specify the -tag option.

-vms VmsName(Required)

Specify the full path of the target virtual machine server.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-size Size] Specify the allocation size of the target disk.

[-id UniqueId] Specify the unique Id of the target disk.

[-name LunName] Specify the LUN name of the target disk.

[Note]

• Specifying a virtual machine server only:

All LUNs (except datastore) connected to the virtual machine server will become the target.

• Virtual machine server + size specifying:

The disk with the specifyed allocation size connected to the virtual machine server will becomethe target.

• Virtual machine server + UniqueId specifying:

The disk with the specifyed UniqueId connected to the virtual machine server will become thetarget.

• Virtual machine server + LUN name specifying:

If the -id / -name option is specified at the same time when the -tag option is specified,

the disks to which the Tag is already specified are also overwritten whether the -overwriteoption is specified or not.

• Tags is overwritten whether -overwrite option is specified or not,

if you specify -tag, -id and -name option dynamically.

[Syntax examples]

>ssc rdmstorage update rdm -vms vc1/datacenter1/esx1 >ssc rdmstorage update rdm -vms vc1/datacenter1/esx1 -size 50 >ssc rdmstorage update rdm -vms vc1/datacenter1/esx1 -id 20000030138400540000 >ssc rdmstorage update rdm -vms vc1/datacenter1/esx1 -name "NEC Fibre Channel Disk (eui.003013840e640021)" >ssc rdmstorage update none -vms vc1/datacenter1/esx1 >ssc rdmstorage update clean -vms vc1/datacenter1/esx1 >ssc rdmstorage update -vms 192.168.1.10/DC/192.168.1.20 -tag bronze >ssc rdmstorage update -vms 192.168.1.10/DC/192.168.1.20 -tag gold -size 20 -overwrite

Chapter 2. Command for Setup

120 SigmaSystemCenter 3.5 ssc Command Reference

Page 131: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc rdmstorage update -vms 192.168.1.10/DC/192.168.1.20 -tag gold -id 003013840e640005

2.12.17 Displaying Information of Disk for RDMDisplays information of disk for RDM

[Syntax]

ssc rdmstorage show -vms VmsName [-vertical]

[Parameters and Options]

-vms VmsName(Required)

Specify a target virtual machine server name in a full path.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc rdmstorage show -vms vc1/datacenter1/esx1 >ssc rdmstorage show -vms vc1/datacenter1/esx1 -vertical

2.12.18 Displaying Storage TopologyDisplays storage topology information.

[Syntax]

ssc show storagetopology DiskArrayName

[-poolid PoolId | -num DiskVolumeNumber | -name DiskVolumeName]

[-serialno SerialNumber]

[-all] [-vertical]

[Parameters and Options]

DiskArrayName(Required)

Specify a disk array name.

[-poolid PoolId] Specify a pool ID to display the storage topology information for it.For NetApp storage, specify a UUID.

[-num DiskVolumeNumber] Specify a disk volume number to display the storage topology information for it.For NetApp storage and SMI-S services, this option is invalid.

[-name DiskVolumeName] Specify a disk volume name to display the storage topology information for it.For NetApp storage and SMI-S services, disk volume name is case-sensitive.

[-serialno SerialNumber] Specify the serial number of the disk array.Use this option if there is more than one disk array with the same name of the diskarray.

[-all] All the storage topology information is displayed.If you do not specify this option, only the storage topology information on themanaged resource is displayed.

[-vertical] Changes the format. -vertical: Item : Value

Chapter 2. Command for Setup

121 SigmaSystemCenter 3.5 ssc Command Reference

Page 132: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

If you do not specify this option, the information is displayed in the CSV format.

[Environment which storage topology supports]

The environments which this command supports are as follows.

VMWare Hyper-V KVM Xen

NEC Storage Yes Yes No No

CLARiiON Yes Yes No No

Symmetrix No No No No

NetApp Yes No YES No

[Syntax examples]

To display the storage topology information on the managed resource only: >ssc show storagetopology M100

To display the storage topology information on all resources: >ssc show storagetopology M100 -all

[Display examples]

>ssc show storagetopology m100 #DiskArrayName,StoragePoolId,StoragePoolName,DiskVolumeName,DiskVolumeNumber,DiskVolumeType,DiskVolumeManagedStatus,DiskVolumeManagedSubStatus,DatastoreName,MachineName,MachineType,MachineManagedStatus,MachineManagedSubStatus,VmDiskName,VMName,VmMachineType,VmManagedStatus,VmManagedSubStatus "M100","1","Pool0001","st_LD02","10","LD","Managed","-","","","","","","","","","","" "M100","1","Pool0001","TopoLD04","22","Datastore","Managed","-","[HVCluster] C:/ClusterStorage/Volume2/","W2K8R2-SAN1","LogicalMachine, Hyper-V, VM Server","Managed","-","","","","","" "M100","1","Pool0001","TopoLD04","22","Datastore","Managed","-","[HVCluster] C:/ClusterStorage/Volume2/","W2K8R2-SAN2","LogicalMachine, Hyper-V, VM Server","Managed","-","[HVCluster] C:/ClusterStorage/Volume2/TopoVM102/TopoVM102-0000.vhd","TopoVM102","Hyper-V, Virtual Machine","Managed","-" "M100","2","Pool0002","st_LD00","23","LD","Managed","-","","","","","","","","","","" "M100","2","Pool0002","st_LD01","8","LD","Managed","-","","","","","","","","","","" "M100","0","SystemPool","Yamato2DataStore","7","LD","Managed","-","","","","","","","","","","" "M100","3","SC02","20008CDF9DCA40B8000C","12","VVOL","Managed","-","","ESXi600","LogicalMachine, VMware, VM Server","Managed","-","[SC02] naa.68cdf9d0000000008cdf9dca40b8000b/vm01_vvol.vmdk","vm01_vvol","VMware, Virtual Machine","Managed","-"

[Note]

• When "-all" is omitted, only the managed resource is displayed.

- When the disk volume is not a managed resource, it is not outputted to a commandexecution result.

- When the virtual machine server is not a managed resource, the information from the diskarray to the disk volume is outputted.

Chapter 2. Command for Setup

122 SigmaSystemCenter 3.5 ssc Command Reference

Page 133: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

- When the virtual machine is not a managed resource, the information from the disk arrayto the virtual machine server is outputted.

- When the physical machine is not a managed resource, the information from the disk arrayto the disk volume is outputted.

2.13 Network2.13.1 Creating VLAN

Creates a VLAN on the physical switch.

[Syntax]

ssc vlan create VlanName VlanId [-manager HostName

| -switch SwitchName [-tag PortName...] [-untag PortName...]]

[Parameters and Options]

VlanName(Required)

Specify the name of a VLAN that you create.

VlanId(Required)

Specify the VLANID of a VLAN that you create.You can configure the number of "2"-"4094".

[-manager HostName] Specify the host name or IP address of a manager.

[-switch SwitchName[-tag PortName...][-untag PortName...]]

Specify a physical switch name and port name.-tag: Specify the port name on which a VLAN tag is set.-untag: Specify the port name on which a VLAN untag is set.

[Syntax examples]

>ssc vlan create VLAN_008 8 >ssc vlan create vlan_014 14 -manager Switch-A >ssc vlan create vlan_118 18 -manager 192.168.10.1 >ssc vlan create vlan_210 20 -switch QX-S6500-XG -tag 10GigabitEthernet0/2 10GigabitEthernet0/3 >ssc vlan create vlan_210 20 -switch QX-S6500-XG -tag 10GigabitEthernet0/2 10GigabitEthernet0/3 -untag 10GigabitEthernet0/4 10GigabitEthernet0/5

2.13.2 Deleting VLANDeletes a VLAN on the physical switch.

[Syntax]

ssc vlan delete VlanName [-manager HostName]

[Parameters and Options]

VlanName(Required)

Specify the name of a VLAN that you delete.

[-manager HostName] Specify the host name or IP address of a manager.

[-switch SwitchName [PortName…]] Specify a physical switch name and port name.When omitting the port name, all ports will be targeted.

Chapter 2. Command for Setup

123 SigmaSystemCenter 3.5 ssc Command Reference

Page 134: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc vlan delete VLAN_008 >ssc vlan delete vlan_014 -manager Switch-A >ssc vlan delete vlan_118 -manager 192.168.10.1 >ssc vlan delete vlan_210 20 -switch QX-S6500-XG >ssc vlan delete vlan_210 20 -switch QX-S6500-XG 10GigabitEthernet0/2 10GigabitEthernet0/3

2.13.3 Displaying VLANDisplays information of the VLAN that is created in the physical switch.

[Syntax]

ssc show vlan

[Parameters and Options]

No parameters or options.

[Syntax examples]

>ssc show vlan

2.13.4 Creating Port GroupCreates a port group on a specifying switch (NetworkDevice).

[Syntax]

ssc portgroup create <PortGroupName NetworkDeviceName | VXLANName ScopeName >

Path VlanType [primary] [secondary]

[Parameters and Options]

PortGroupName Specify the name of a port group to create.You can enter any character up to 100 characters, except the following symbols:\ / : . ; * ? < > |

NetworkDeviceName Specify the name of the switch on which the port group is created.

VXLANName Specify the name of a VXLAN to create.You can enter any character up to 32 characters, except the following symbols:* + , / : ; < = > ? \ | [ ]

ScopeName Specify the name of the scope on which the vxlan is created.

Path(Required)

Specify the path of a virtual machine server or the datacenter in which the switch exists.Or specify the path of a vCenter server in which the VXLAN scope exists.When operating the virtual switch, a virtual machine server is specified. Virtual view : virtual:/VC1/DataCenter1/VMServer1 Resource view : resource:/Group1/VMServer1When operating the distributed virtual switch, a datacenter is specified. Virtual view : virtual:/VC1/DataCenter1/When operating the VXLAN scope, a vCenter server is specified. Virtual view : virtual:/VC1/(You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.)

Chapter 2. Command for Setup

124 SigmaSystemCenter 3.5 ssc Command Reference

Page 135: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

VlanType(Required)

Specifiy VLAN Type.A VLAN type includes the following 4 types.nonevlanprivatevxlan

[primary] Specify a VLANID(PrimaryID).When the VLAN type is "vlan", it's possible to specify 2-4094.When the VLAN type is "private", it's possible to specify 1-4094.

[secondary] Specify a SecondaryId.It's possible to specify 1-4094.

When "none" is specified as the VLAN type, both primary and secondary

are not required to be specified.

When "vlan" is specified as the VLAN type, specify primary.

When "private" is specified as the VLAN type, both primary and secondary must be specified.

When "vxlan" is specified as the VLAN type, both primary and secondary

are not required to be specified.

[Syntax examples]

>ssc portgroup create vPortGroup1 vSwitch1 VC1/DataCenter1/VMServer1 none>ssc portgroup create vPortGroup2 vSwitch1 virtual:/VC1/DataCenter1/VMServer1 vlan 2>ssc portgroup create vPortGroup3 vSwitch1 resource:/Group1/VMServer1 private 1 2>ssc portgroup create dvPortGroup1 dvSwitch1 virtual:/VC1/DataCenter1 vlan 2>ssc portgroup create vxlan01 privateScope VC1 vxlan

2.13.5 Updating Port GroupUpdates a port group on the specifying switch (NetworkDevice).

[Syntax]

ssc portgroup update PortGroupName NetworkDeviceName Path [-vlan VlanType [primary][secondary]] [-bandcontrol <on | off> [ave=value peak=value burstsize=value] [type=<in | out>]]

[Parameters and Options]

PortGroupName(Required)

Specify the updating port group name.

NetworkDeviceName(Required)

Specify the switch name which the port group exists.

Path(Required)

Specify virtual or resource path of the virtual machine server or the datacenter whichthe switch exists.

Chapter 2. Command for Setup

125 SigmaSystemCenter 3.5 ssc Command Reference

Page 136: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When operating the virtual switch, a virtual machine server is specified.Virtual view : virtual:/VC1/DataCenter1/VMServer1Resource view : resource:/Group1/VMServer1When operating the distributed virtual switch, a datacenter is specified.Virtual view : virtual:/VC1/DataCenter1/(You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".

[-vlan VlanType [primary][secondary]]

VlanTypeSpecifiy VLAN Type.VLAN type is the following 3 types.nonevlanprivate[primary]Specify VLANID(PrimaryID).When VLAN type is "vlan", it's possible to specify 2-4094.When VLAN type is "private", it's possible to specify 1-4094.[secondary]Specify SecondaryId.It's possible to specify 1-4094.When VLAN type is none specifying, specifying is unnecessary for primary andsecondary.When VLAN type is vlan specifying, primary is specified.When VLAN type is private specifying, primary and secondary is specified.

[-bandcontrol <on | off>[ave=value peak=valueburstsize=value][type=<in | out>]]

<on | off> Specify the presence of Network Band Control.on : effectiveoff : invalidave Specify average[kbits/s] of Band Width.peak Specify peak[kbits/s] of Band Width.burstsize Specify burst size[kbytes].type Specify control type for the distributed virtual switch.in : inputout : output

[Note]

• Each value of the network bandwidth control can be specified in the following range.

- ave

0 < ave < 9,000,000,000,000,000

- peak

0 < peak < 9,000,000,000,000,000

- burstsize

0 < burstsize < 9,007,199,254,740,991

• The network bandwidth control is supported only in the VMware environment.

Chapter 2. Command for Setup

126 SigmaSystemCenter 3.5 ssc Command Reference

Page 137: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The network bandwidth control(traffic shaping) can be set to the portgroup.

[Syntax examples]

>ssc portgroup update dvPortGroup1 dvSwitch1 virtual:/VC1/DataCenter1 -vlan none>ssc portgroup update VLAN1 vSwitch1 resource:/Group1/VMServer1 -vlan vlan 2>ssc portgroup update VLAN2 vSwitch1 VC1/DataCenter1/VMServer1 -vlan private 1 2>ssc portgroup update VLAN1 vSwitch1 VC1/DataCenter1/VMServer1-bandcontrol on ave=1024 peak=2048 burstsize=100>ssc portgroup update dvPortGroup1 dvSwitch1 virtual:/VC1/DataCenter1-bandcontrol on ave=1024 peak=2048 burstsize=100 type=in>ssc portgroup update dvPortGroup1 dvSwitch1 virtual:/VC1/DataCenter1-bandcontrol off type=out

2.13.6 Deleting Port GroupDeletes a port group on a specifying switch (NetworkDevice).

[Syntax]

ssc portgroup delete <PortGroupName NetworkDeviceName | VXLANName ScopeName>

Path [-vxlan]

[Parameters and Options]

PortGroupName Specify the name of a port group to delete.

NetworkDeviceName Specify the name of the switch from which the port group is deleted.

VXLANName Specify the name of a VXLAN to delete.

ScopeName Specify the name of the scope from which the vxlan is deleted.

Path(Required)

Specify the path of a the virtual machine server or datacenter in which the switch exists.Or specify the path of a vCenter server in which the VXLAN scope exists.When operating the virtual switch, a virtual machine server is specified. Virtual view : virtual:/VC1/DataCenter1/VMServer1 Resource view : resource:/Group1/VMServer1When operating the distributed virtual switch, a datacenter is specified. Virtual view : virtual:/VC1/DataCenter1/When operating the VXLAN scope, a vCenter server is specified. Virtual view : virtual:/VC1/(You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-vxlan] When the VXLAN is specified, specify this option.

[Syntax examples]

>ssc portgroup delete vPortGroup1 vSwitch1 VC1/DataCenter1/VMServer1>ssc portgroup delete vPortGroup2 vSwitch1 virtual:/VC1/DataCenter1/VMServer1>ssc portgroup delete vPortGroup3 vSwitch1 resource:/Group1/VMServer1

Chapter 2. Command for Setup

127 SigmaSystemCenter 3.5 ssc Command Reference

Page 138: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc portgroup delete dvPortGroup1 dvSwitch1 virtual:/VC1/DataCenter1>ssc portgroup delete vxlan01 privateScope VC1 -vxlan

2.13.7 Displaying Port GroupDisplays a port group list.

[Syntax]

ssc portgroup show Path [-private] [-bandcontrol] [-vxlan] [-vertical]

[Parameters and Options]

Path(Required)

When you want to display the port group list of a virtual switch,specify the virtual or resource path of a virtual machine server. Virtual view : virtual:/VC1/DataCenter1/VMServer1 Resource view : resource:/Group1/VMServer1When you want to display the port group list of the distributed virtual switch,specify the datacenter in which the switch exists. Virtual view : virtual:/VC1/DataCenter1/When you want to display the VXLAN port group list,specify the vCenter Server in which the VXLAN scope exists. Virtual view : virtual:/VC1/(You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[-private] Displays a private VLAN list when this option is specified.

[-bandcontrol] Displays Network Band Control information when specify this option.

[-vxlan] Displays a VXLAN port group list when this option is specified.

[-vertical] Specify format. If you do not specify this option,information is displayed in the csv format.

[Note]

• The network bandwidth control is supported only in the VMware environment.

The network bandwidth control(traffic shaping) information on the portgroup can be displayed.

[Syntax examples]

>ssc portgroup show virtual:/VC1/DataCenter1/VMServer1>ssc portgroup show resource:/Group1/VMServer1 -private>ssc portgroup show virtual:/VC1/DataCenter1/VMServer1 -bandcontrol>ssc portgroup show VC1/DataCenter1 -vertical>ssc portgroup show VC1 -vxlan

[Display examples]

* PortGroup list#NetworkDeviceName,PortGroupName,NetworkType,VlanType,VlanId(PrimaryId),SecondaryId"vSwitch0","Service Console","ServiceConsole","None","-","-""vSwitch0","VM Network","VirtualMachine","None","-","-""vSwitch1","VLAN10","VirtualMachine","Vlan","10","-""vSwitch1","VLAN20","VirtualMachine","Vlan","20","-"

Chapter 2. Command for Setup

128 SigmaSystemCenter 3.5 ssc Command Reference

Page 139: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

* PrivateVlan list#NetworkDeviceName,PrimaryId,SecondaryId,PrivateType"dvSwitch","10","10","Promiscuous""dvSwitch","10","11","Community""dvSwitch","10","12","Isolated""dvSwitch","10","13","Community""dvSwitch","10","14","Community"* Network bandwidth control information#NetworkDeviceName,PortGroupName,Type,AverageBandWidth(Kbits/s),PeakBandWidth(Kbits/s),BurstSize(Kbytes)"vSwitch0","VirtualVLAN","in/out","1000","2100","100""vSwitch1","VirtualVLAN","in","1500","2000","200"* VXLAN portgroup list#VxlanScopeName,VxlanName,ExtendId,PortGroupName,VlanId(PrimaryId)"Scope01","Web-Wire","9001","vxw-dvs-4791-virtualwire-4-sid-9001-Web-Wire""Scope02","App-Wire","9002","vxw-dvs-4791-virtualwire-5-sid-9002-App-Wire"

2.13.8 Creating Private VLANCreates a private VLAN in the target distributed virtual switch.

[Syntax]

ssc privatevlan create NetworkDeviceName Path PrimaryId SecondaryId PrivateVlanType

[Parameters and Options]

NetworkDeviceName(Required)

Specify the distributed virtual switch name which creates a private VLAN.

Path(Required)

Specify virtual path of the datacenter which the switch exists.When operating the distributed virtual switch, a datacenter is specified.virtual:/VC1/DataCenter1/(It's possible to omit "virtual:/".)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

PrimaryId(Required)

Specify PrimaryID of the private VLAN.It's possible to specify 1-4094.

SecondaryId(Required)

Specify SecondaryId of the private VLAN.It's possible to specify 1-4094.

PrivateVlanType(Required)

Specifiy Private VLAN Type.Private VLAN type is the following 3 types.communityisolatedpromiscuous

[Syntax examples]

ssc privatevlan create dvSwitch1 VC1/DataCenter1 1 2 communityssc privatevlan create dvSwitch1 VC1/DataCenter1 2 3 solatedssc privatevlan create dvSwitch1 virtual:/VC1/DataCenter1 3 4 promiscuous

2.13.9 Updating Private VLANUpdates a private VLAN in the target distributed virtual switch.

Chapter 2. Command for Setup

129 SigmaSystemCenter 3.5 ssc Command Reference

Page 140: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Private VLAN whose primary ID and secondary ID are identical will be edited.

It can't be changed to Promiscuous.

Private Vlan in Promiscuous can't be changed.

[Syntax]

ssc privatevlan update NetworkDeviceName Path PrimaryId SecondaryId PrivateVlanType

[Parameters and Options]

NetworkDeviceName(Required)

Specify the distributed virtual switch name which updates a private VLAN.

Path(Required)

Specify virtual path of the datacenter which the switch exists.virtual:/VC1/DataCenter1/(It's possible to omit "virtual:/".)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

PrimaryId(Required)

Specify PrimaryID of the private VLAN.It's possible to specify 1-4094.

SecondaryId(Required)

Specify SecondaryId of the private VLAN.It's possible to specify 1-4094.

PrivateVlanType(Required)

Specifiy Private VLAN Type.communityisolated

[Syntax examples]

>ssc privatevlan update dvSwitch1 VC1/DataCenter1 1 2 isolated>ssc privatevlan update dvSwitch1 virtual:/VC1/DataCenter1 2 3 community

2.13.10 Deleting Private VLANDeletes a private VLAN of the distributed virtual switch.

[Syntax]

ssc privatevlan delete NetworkDeviceName Path PrimaryId SecondaryId

[Parameters and Options]

NetworkDeviceName(Required)

Specify the distributed virtual switch name which deletes a private VLAN.

Path(Required)

Specify virtual path of the datacenter which the switch exists.When operating the distributed virtual switch, a datacenter is specified.virtual:/VC1/DataCenter1/(It's possible to omit "virtual:/".)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

PrimaryId(Required)

Specify the primary ID for private VLAN.

SecondaryId(Required)

Specify the secondary ID for private VLAN.

Chapter 2. Command for Setup

130 SigmaSystemCenter 3.5 ssc Command Reference

Page 141: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc privatevlan delete dvSwitch1 VC1/DataCenter1/ 1 2>ssc privatevlan delete dvSwitch1 virtual:/VC1/DataCenter1/ 2 3

2.13.11 Displaying VXLANDisplays a vxlan list.

[Syntax]

ssc vxlan show Path [VxlanScope] [-vertical]

[Parameters and Options]

Path(Required)

Specify a VMS server or datacenter name.Specify the path to the Virtual view.(E.g. Virtual manager/Datacenter)

[VxlanScope] Specify the VXLAN scope name.Specify this option along with [Datacenter].

[-vertical] Specify the format. (item : value)If you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc vxlan show 192.168.1.100/Datacenter >ssc vxlan show vCenterServer/Datacenter VXLANScope -vertical

2.13.12 Displaying VTNDisplays VTN information.

[Syntax]

ssc vtn show [VtnName] [-vertical]

[Parameters and Options]

[VtnName] Specify the VTN name.

[-vertical] Specify the format. (item : value)If you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc vtn show >ssc vtn show VTN1

2.13.13 Creating Firewall ProfileCreates a firewall profile.

[Syntax]

ssc firewallprofile create ProfileName [-description Description]

[Parameters and Options]

ProfileName Specify a firewall profile name.

Chapter 2. Command for Setup

131 SigmaSystemCenter 3.5 ssc Command Reference

Page 142: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required)

[-description Description] Enter the description of the firewall profile.

[Syntax examples]

>ssc firewallprofile create WebProfile >ssc firewallprofile create WebProfile -description "Web-Server Profile"

2.13.14 Deleting Firewall ProfileDeletes the firewall profile.

[Syntax]

ssc firewallprofile delete ProfileName

[Parameters and Options]

ProfileName(Required)

Specify the firewall profile name.

[Syntax examples]

>ssc firewallprofile delete WebProfile

2.13.15 Displaying Firewall ProfileDisplays the list or the detail of the firewall profile.

[Syntax]

ssc firewallprofile show [ProfileName] [-vertical]

[Parameters and Options]

[ProfileName] Specify the firewall profile name.If omitted, the list of firewall profiles is displayed.

[-vertical] Specify the format. If you do not specify this option, the information is displayed in the csv format.

[Syntax examples]

>ssc firewallprofile show >ssc firewallprofile show WebProfile >ssc firewallprofile show -vertical

2.13.16 Adding Filtering RuleAdds a filtering rule to the firewall profile.

[Syntax]

ssc firewallprofile add ProfileName Protocol Handling [-sip SourceIP] [-sport SourcePort] [-dipDestinationIP] [-dport DestinationPort] [-order OrderNumber]

[Parameters and Options]

ProfileName(Required)

Specify the firewall profile name.

Protocol Specify the protocol.

Chapter 2. Command for Setup

132 SigmaSystemCenter 3.5 ssc Command Reference

Page 143: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required) TCP: TcpUDP: UdpICMP: IcmpALL: all

Handling(Required)

Specify the packet handling.Accept: acceptDrop: dropReject: reject

[-sip SourceIP] Specify the source IP address.

[-sport SourcePort] Specify the source port number.When Protocol is "ICMP" or "ALL", you cannot specify this option.

[-dip DestinationIP] Specify the destination IP address.

[-dport DestinationPort] Specify the destination port number.When Protocol is "ICMP" or "ALL", you cannot specify this option.

[-order OrderNumber] Specify the order of the rule.If omitted, the rule is added at the end of the order.

[Syntax examples]

>ssc firewallprofile add WebProfile Tcp Accept -sip 192.168.1.10 >ssc firewallprofile add WebProfile Udp Drop -sport 22 -dip 192.168.1.100-192.168.1.120 >ssc firewallprofile add WebProfile All Reject -dip 192.168.1.0/24 -dport 23 -order 1

2.13.17 Creating Network DefinitionCreates a network.

[Syntax]

ssc network create NetworkName [-scope < public | private >] [-tenant TenantName] [-tag value] [-description value]

[Parameters and Options]

NetworkName(Required)

Specify a network name.

[-scope < public | private >] Set the open range.By default, public is set.

[-tenant TenantName] Specify the tenant to be published.If public is set for -scope, this option cannot be specified.

[-tag value] Specify a tag.

[-description value] Enter a description.

[Syntax examples]

>ssc network create VMNetwork1 >ssc network create VMNetwork1 -scope public >ssc network create VMNetwork1 -scope private >ssc network create VMNetwork1 -tenant Tenant1

Chapter 2. Command for Setup

133 SigmaSystemCenter 3.5 ssc Command Reference

Page 144: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc network create VMNetwork1 -scope private -tenant Tenant1 >ssc network create VMNetwork1 -scope public -tag resource -description cloud

2.13.18 Applying Network DefinitionApplies the setting of the network.

[Syntax]

ssc network apply NetworkName Type

[Parameters and Options]

NetworkName(Required)

Specify the network name.

Type(Required)

Specify the type of a setting to be applied.firewall: Firewall settingpflow: P-Flow settingall: All settings

[Syntax examples]

>ssc network apply Network firewall >ssc network apply Network pflow >ssc network apply Network all

2.13.19 Deleting Network DefinitionDeletes a network.

[Syntax]

ssc network delete NetworkName

[Parameters and Options]

NetworkName(Required)

Specify the network name.

[Syntax examples]

>ssc network delete Network

2.13.20 Displaying Network DefinitionDisplays the network information.

[Syntax]

ssc network show [NetworkName] [-vertical]

[Parameters and Options]

[NetworkName] Specify the network name. If you do not specify this parameter, the list of networks is displayed.

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

Chapter 2. Command for Setup

134 SigmaSystemCenter 3.5 ssc Command Reference

Page 145: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc network show >ssc network show Network >ssc network show -vertical

2.13.21 Adding VLAN(Port Group) Definition to a NetworkAdds a VLAN (a port group) definition to the network.

[Syntax]

ssc network add-vlan NetworkName SwitchType [SwitchName] -vlanname VlanName [-vlantype<vlan | private>] [-vlanid VlanId [secondaryId]]

[Parameters and Options]

NetworkName(Required)

Specify a network name.

SwitchType(Required)

Specify the type of switch.Physicals : All physical switchesPhysical : Physical SwitchVirtual : Virtual SwitchDistributed : Distributed Switch

[SwitchName] Specify a switch name.If SwitchType is Physicals, this option cannot be specified.If SwitchType is Physical or Distributed, this option must be specified.

-vlanname VlanName Specify the name of vlan.

[-vlantype <vlan | private>] Specify a vlan type.If SwitchType is Physicals or Physical, this option must be specified.vlan : VLANprivate : private VLANIf VlanName already exists in the specified switch,this option can be omitted.

[-vlanid VlanId [secondaryId]] Specify a vlan id.SecondaryId can be specified if the VLAN is a private VLAN.If SwitchType is Physicals or Physical, this option must be specified.If VlanName already exists in the specified switch, this option can be omitted.

[Syntax examples]

>ssc network add-vlan VMNetwork1 Virtual dvSwitch -vlanname vPortGroup -vlantype vlan -vlanid 1 >ssc network add-vlan VMNetwork1 Phisical Switch1 -vlanname PortGroup -vlantype private -vlanid 100 101 >ssc network add-vlan VMNetwork1 Virtual -vlanname vPortGroup -vlantype vlan -vlanid 1

2.13.22 Deleting VLAN (Port Group) Definition from theNetwork

Deletes a VLAN (a port group) definition from the network.

Chapter 2. Command for Setup

135 SigmaSystemCenter 3.5 ssc Command Reference

Page 146: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc network delete-vlan NetworkName SwitchType [SwitchName] -vlanname VlanName

[Parameters and Options]

NetworkName(Required)

Specify the network name.

SwitchType(Required)

Specify the type of the switch.Physicals :All switches (physical)Physical :Physical switchVirtual :Virtual switchDistributed:Distributed switch

[SwitchName] Specify the name of switch.Cannot specify SwitchType in the case of "Physicals".Cannot omit SwitchType in the case of "Physical" or "Distributed".

-vlanname VlanName(Required)

Specify the name of VLAN.

[Syntax examples]

>ssc network delete-vlan Network Physicals -vlanname VLAN10 >ssc network delete-vlan Network Physical Switch01 -vlanname VLAN10 >ssc network delete-vlan Network Virtual -vlanname "VM Network 1" >ssc network delete-vlan Network Distributed dvSwitch -vlanname "VM Network 1"

2.13.23 Adding Address Pool to a NetworkAdds an address pool to the network.

[Syntax]

ssc network add-addresspool NetworkName RangeName StartIP [EndIP] [Division] [-manage <off |on>] [-public StartIP EndIP] [-subnetmask SubnetMask | -prefixlength PrefixLength] [-gatewayGateway]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RangeName(Required)

Specify the IP address range name.

StartIP [EndIP] Specify the range of IP addresses.When you specify a specific address, you can specify StartIP only.(Enabled if Division is set to "exclude")

[Division] Specify the division.assign: assigning exclude: excluding If omitted, Division is set to "assign".

[-manage <off | on>] Specify whether the IP address is for management or not.If omitted, the value is set to "off."

Chapter 2. Command for Setup

136 SigmaSystemCenter 3.5 ssc Command Reference

Page 147: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(When the IPv4 address is registered, it is effective.)

[-public StartIP EndIP] Specify the range of public IP addresses.If this option is specified, the NAT conversion address rangecorresponding to the range of public IP addresses can be set.(When the IPv4 address is registered, it is effective.)

[-subnetmask SubnetMask] Specify the subnet mask.If omitted, the subnet mask is set to "255.255.255.0".(When the IPv4 address is registered, it is effective.)

[-prefixlength PrefixLength] Specify the prefix length.If omitted, the prefix length is set to "64".(When the IPv6 address is registered, it is effective.)

[-gateway Gateway] Specify the default gateway.

[Syntax examples]

>ssc network add-addresspool VMNet privateRange 192.168.1.1 192.168.1.255 assign -manage off -public 192.168.1.1 192.168.1.10 -subnetmask 255.255.127.0 -gateway 192.168.1.0 >ssc network add-addresspool VMNet privateRange 2001:dbf8::100 2001:dbf8::ffff -prefixlength 64 >ssc network add-addresspool VMNet privateRange 192.168.1.1 exclude

2.13.24 Deleting Address Pool from the NetworkDeletes an address pool from the network.

[Syntax]

ssc network delete-addresspool NetworkName RangeName [-ipversion IpVersion]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RangeName(Required)

Specify the IP address range name.

[-ipversion IpVersion] Specify the protocol.Specify this option to distinguish the IP range name between IPv4 and IPv6 if the same IPrange name is used in both IPv4 and IPv6.(E.g.: ipv4, ipv6)If omitted, all ranges with a matching name are deleted.

[Syntax examples]

>ssc network delete-addresspool Network Range1 >ssc network delete-addresspool Network Range1 -ipversion IPv6

2.13.25 Adding Static Route Setting to a NetworkAdds a static route setting to a network.

Chapter 2. Command for Setup

137 SigmaSystemCenter 3.5 ssc Command Reference

Page 148: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc network add-static-rt NetworkName -dest DestinationAddress SubnetMask -fwdForwardingAddress [-metric MetricId]

[Parameters and Options]

NetworkName(Required)

Specify the name of a network.

-dest DestinationAddress SubnetMask(Required)

Specify the IP address of a destination address.

-fwd ForwardingAddress(Required)

Specify the IP address of a forwarding address.

[-metric MetricId] Specify a metric ID.Specify a value in the range of 1 to 9999.

[Syntax examples]

>ssc network add-static-rt Network -dest 192.168.2.100 255.255.255.0 -fwd 192.168.2.2>ssc network add-static-rt Network -dest 192.168.2.200 255.255.255.0 -fwd 192.168.2.2 -metric 20

2.13.26 Deleting Static Route Setting from the NetworkDeletes a static route setting from a network.

[Syntax]

ssc network delete-static-rt NetworkName [-dest DestinationAddress SubnetMask] [-fwdForwardingAddress]

[Parameters and Options]

NetworkName(Required)

Specify the name of a network.

[-dest DestinationAddress SubnetMask] Specify the IP address of a destination address.

[-fwd ForwardingAddress] Specify the IP address of a forwarding address.

[Syntax examples]

>ssc network delete-static-rt Network>ssc network delete-static-rt Network -dest 192.168.2.0,255.255.255.0>ssc network delete-static-rt Network -fwd 192.168.2.2>ssc network delete-static-rt Network -dest 192.168.2.0,255.255.255.0 -fwd 192.168.2.2

2.13.27 Adding Firewall Setting to a NetworkAdds the firewall setting to the network.

[Syntax]

Chapter 2. Command for Setup

138 SigmaSystemCenter 3.5 ssc Command Reference

Page 149: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc network add-firewallsetting NetworkName [ProfileName] [-firewall FirewallName] [-nat] [-orderOrderNumber]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

[ProfileName] Specify the firewall profile name.

[-firewall FirewallName] Specify the firewall.You can omit this option when there is only one registered firewall or when the firewallhas already been set.

[-nat] Enable the network address translation function.

[-order OrderNumber] Specify the order of the rule.It is ignored when ProfileName is omitted.

[Note]

You cannot change the registered firewall and the network address translation setting. Delete thefirewall setting and then add it again when changes are necessary.

[Syntax examples]

>ssc network add-firewallsetting LocalNetwork WebProfile -firewall vFW30 >ssc network add-firewallsetting LocalNetwork SSHProfile -order 2 >ssc network add-firewallsetting LocalNetwork -nat

2.13.28 Deleting Firewall Setting from the NetworkDeletes the firewall setting from the network.

[Syntax]

ssc network delete-firewallsetting NetworkName [ProfileName | -order OrderNumber]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

[ProfileName | -order OrderNumber] Specify the firewall profile name or the order of the rule.If omitted, all firewall settings will be deleted.

[Note]

The rules are ordered again immediately after you deleted the firewall setting with ProfileName and -order specified. If you continue to issue the command with –order, specify the number within thenew order for –order.

[Syntax examples]

>ssc network delete-firewallsetting LogicalNetwork >ssc network delete-firewallsetting LogicalNetwork WebProfile >ssc network delete-firewallsetting LogicalNetwork -order 1

2.13.29 Adding Virtual Bridge Definition to a NetworkAdds a virtual bridge definition to the network.

Chapter 2. Command for Setup

139 SigmaSystemCenter 3.5 ssc Command Reference

Page 150: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc network add-virtualbridge NetworkName BridgeName VlanId [-controller ControllerName] [-othername VirtualNetworkName]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

BridgeName(Required)

Specify the virtual bridge name.

VlanId(Required)

Specify the VLAN ID.

[-controller ControllerName] Specify the controller name.When only one controller is managed, this option can be omitted.

[-othername VirtualNetworkName] Specified the network name for P-Flow.You can use a combination of alphabets, numbers and underscores up to 31characters long.

[Note]

• If the logical network name is against the P-Flow naming rule, please specify the other nameusing -othername.

[Syntax examples]

>ssc network add-virtualbrige Network VBR1 10 >ssc network add-virtualbrige Network VBR1 10 -controller PFC >ssc network add-virtualbrige Network VBR1 10 -othername VTN1

2.13.30 Deleting Virtual Bridge Definition from the NetworkDeletes a virtual bridge definition from the network.

[Syntax]

ssc network delete-virtualbridge NetworkName BridgeName

[Parameters and Options]

NetworkName(Required)

Specify the network name.

BridgeName(Required)

Specify the virtual bridge name.

[Syntax examples]

>ssc network delete-virtualbridge Network VBR1

2.13.31 Adding Virtual Router Definition to a NetworkAdds a router definition to the network.

[Syntax]

ssc network add-router NetworkName RouterName [Gateway]

Chapter 2. Command for Setup

140 SigmaSystemCenter 3.5 ssc Command Reference

Page 151: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RouterName(Required)

Specify the router name.You can enter up to 31 characters are as follows: alphabetic characters, numerals, and an underscore (_).

[Gateway] Specify the default gateway address.

[Syntax examples]

>ssc network add-router 1SW_Network 2Sg_Router >ssc network add-router 1SW_Network 2Sg_Router 192.168.1.2

2.13.32 Deleting Virtual Router Definition from the NetworkDeletes a router definition from the network.

[Syntax]

ssc network delete-router NetworkName

[Parameters and Options]

NetworkName(Required)

Specify a network name.

[Syntax examples]

>ssc network delete-router 1SW_Network

2.13.33 Adding Interface to a Virtual Router DefinitionAdds an interface to a router definition.

[Syntax]

ssc network add-router-if NetworkName RouterName InterfaceName IPAddress

SubnetMask -point AccessPoint [-mac MACAddress]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RouterName(Required)

Specify the router name.You can enter up to 31 characters are as follows: alphabetic characters, numerals, and an underscore (_).

InterfaceName(Required)

Specify the interface name.You can enter up to 31 characters are as follows: alphabetic characters, numerals, and an underscore (_).

IPAddress(Required)

Specify the IP address (IPv4).

SubnetMask(Required)

Specify the subnet mask.

Chapter 2. Command for Setup

141 SigmaSystemCenter 3.5 ssc Command Reference

Page 152: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-point AccessPoint(Required)

Specify the access point.

[-mac MACAddress] Specify the MAC address.

[Syntax examples]

>ssc network add-router-if 1SW_Network 2Sg_Router VIF_VBR1 192.168.1.2 255.255.255.0 -point VBR1 >ssc network add-router-if 1SW_Network 2Sg_Router VIF_VBR1 192.168.1.2 255.255.255.0 -point VBR1 -mac F0:FF:08:1A:FF:01

2.13.34 Deleting Interface from the Virtual Router DefinitionDeletes an interface from the router definition.

[Syntax]

ssc network delete-router-if NetworkName RouterName [InterfaceName]

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RouterName(Required)

Specify the router name.

[InterfaceName] Specify the interface name.If you do not specify this parameter, all the interfaces in the router definition are the targets.

[Syntax examples]

>ssc network delete-router-if 1SW_Network 2Sg_Router >ssc network delete-router-if 1SW_Network 2Sg_Router VIF_VBR1

2.13.35 Adding Static Routing to a Virtual Router DefinitionAdds a static routing to a router definition.

[Syntax]

ssc network add-router-rt NetworkName RouterName

-dest DestinationAddress,SubnetMask -fwd ForwardingAddress

[Parameters and Options]

NetworkName(Required)

Specify the network name.

RouterName(Required)

Specify the router name.You can enter up to 31 characters are as follows: alphabetic characters, numerals, and an underscore (_).

-dest DestinationAddress,SubnetMask(Required)

Specify the destination IP address (IPv4).If you specify 0.0.0.0, all the IP addresses are the targets.

-fwd ForwardingAddress(Required)

Specify the forwarding IP address (IPv4).

Chapter 2. Command for Setup

142 SigmaSystemCenter 3.5 ssc Command Reference

Page 153: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc network add-router-rt 1SW_Network 2Sg_Router -dest 0.0.0.0,0.0.0.0 -fwd 192.168.10.2 >ssc network add-router-rt 1SW_Network 2Sg_Router -dest 192.168.10.0,255.255.255.0 -fwd 192.168.1.2

2.13.36 Deleting Static Routing from the Virtual RouterDefinition

Deletes a static routing from router definition.

[Syntax]

ssc network delete-router-rt NetworkName RouterName

[-dest DestinationAddress,SubnetMask] [-fwd ForwardingAddress]

[Parameters and Options]

NetworkName(Required)

Specify a network name.

RouterName(Required)

Specify a router name.

[-dest DestinationAddress,SubnetMask] Specify a destination IP address(IPv4).

[-fwd ForwardingAddress] Specify a forwarding IP address(IPv4).

[Syntax examples]

>ssc network delete-router-rt 1SW_Network 2Sg_Router >ssc network delete-router-rt 1SW_Network 2Sg_Router -dest 0.0.0.0,255.255.255.0 -fwd 192.168.10.2 >ssc network delete-router-rt 1SW_Network 2Sg_Router -fwd 192.168.10.2

2.13.37 Adding Network SettingAdds a network setting to a group.

[Syntax]

ssc group set-network GroupName NicNumber <SwitchName VlanName | -network Networkname> [-tag <on | off>]

[Parameters and Options]

GroupName(Required)

Specify a path to the group or model.You cannot specify the vm group and vm model.(E.g. Category/Group, Group/Model)

NicNumber(Required)

Specify a NIC number in the range of 1 to 10.

SwitchName Specify a switch name.

VlanName Specify a VLAN name.

-network Network Specify network name.

Chapter 2. Command for Setup

143 SigmaSystemCenter 3.5 ssc Command Reference

Page 154: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-tag <on | off>] Configures the tag information."on": A VLAN is tagged"off": A VLAN is untaggedIf you do not specify this option, "off" isset to the tag setting.

[Syntax examples]

>ssc group set-network Category/group1 2 SW003 VLAN0102 >ssc group set-network Category/group1 3 SW003 VLAN0103 -tag on >ssc group set-network -network Network1

2.13.38 Deleting Network SettingDeletes a network setting in a Group.

[Syntax]

ssc group delete-network GroupName

< SwitchName VlanName | -network NetworkName | -all >

[-nic NicNumber] [-i]

[Parameters and Options]

GroupName(Required)

Specify the path to the group or model.You cannot specify the vm group and vm model.(E.g. Tenant/Category/Group, Group/Model).

SwitchName Specify the target switch name.It cannot be specified with -network and -all.

VlanName Specify the VLAN name.It cannot be specified with -network and -all.

-network NetworkName Specify the network name.It cannot be specified with SwitchName and -all.

-all All Network settings of the Group are deleted.

[-nic NicNumber] Specify the NIC number in the range of 1 to 10.It cannot be specified with -all.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc group delete-network Category1/Group01 SW-001 VLAN-001 >ssc group delete-network Group-A001 SW-A001 VLAN-A001 -i >ssc group delete-network Group-B001 -all >ssc group delete-network -network Network1 -nic 1

2.13.39 Deleting Virtual Network ResourceDeletes a virtual tenant network resource.

[Syntax]

ssc virtualnetwork delete TargetPath [-controller ControllerName]

Chapter 2. Command for Setup

144 SigmaSystemCenter 3.5 ssc Command Reference

Page 155: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

TargetPath(Required)

Specify a target resource path.You can specify VTN, vBridge and vRouter.

[-controller ControllerName] Specify a name of controller.

[Syntax examples]

>ssc virtualnetwork delete VTN -controller PFC>ssc virtualnetwork delete VTN\VBR1>ssc virtualnetwork delete VTN\VRT

2.14 Load Balancer2.14.1 Adding Load Balancer

Adds a load balancer to a group.

[Syntax]

ssc add lb GroupName LbGroupName

[Parameters and Options]

GroupName(Required)

Specify a group to which you intend to add a loadbalancer.Specify a path to the group. You cannot specifya tenant, category or model.(E.g. Category/Group, Group)

LbGroupName(Required)

Specify a load balancer group.

[Syntax examples]

>ssc add lb Category1/Group01 LBGroup-001 >ssc add lb Group-A001 LBGroup-A001

2.14.2 Deleting Load BalancerDeletes a load balancer in a group.

[Syntax]

ssc delete lb GroupName < [LbGroupName] | [-all] > [-i]

[Parameters and Options]

GroupName(Required)

Specify the target group name.Specify the path of group.(E.g. Category/Group, Group)

[LbGroupName] Specify the target load balancer group name.It cannot be specified with -all.

[-all] All load balancer group of the group are deleted.

Chapter 2. Command for Setup

145 SigmaSystemCenter 3.5 ssc Command Reference

Page 156: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc delete lb Category1/Group01 LBGroup-001 >ssc delete lb Group-A001 LBGroup-A001 -i >ssc delete lb Group-B001 -all

2.14.3 Displaying Load Balancer InformationDisplays Lb information.

[Syntax]

ssc show lb [-vertical]

[Parameters and Options]

[-vertical] Change the output form (item : value).When omitting, it outputs in the CSV format.

[Syntax examples]

>ssc show lb

2.14.4 Adding Load Balancer GroupCreates a load balancer group in a load balancer or software load balancer.

[Syntax]

ssc lbgroup create LBName LBGroupName IPAddress Protocol PortNumber

[-type LBType]

[-session SessionType [PersistentTime] [-cookie Cookie] [-netmask RangeNetMask]]

[-forward ForwardType]

-realserver NetworkAddress [RealServerPortNumber] [Weight]

[Parameters and Options]

LBName(Required)

Specify a load balancer name.

LBGroupName(Required)

Specify the name of a load balancer group that you create.

IPAddress(Required)

Specify the IP address of a virtual server.

Protocol(Required)

Specify a connection protocol.tcp: TCPucp: UCP

PortNumber(Required)

Specify a connection port number.You can configure the number of "1"-"65535".

[-type LBType] Specify a load balancer type.rr: round robinlc: least connection

Chapter 2. Command for Setup

146 SigmaSystemCenter 3.5 ssc Command Reference

Page 157: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

wrr: weightres: response time

[-session SessionType[PersistentTime][-cookie Cookie] [-netmaskRangeNetMask]]

Specify a session type and various settings.SessionType: Specify a session type. cookie: Cookie ssl: SSL sticky: Client IP address singleip: Client IP sddress rangeip: Client IP sddress(multifuel).PersistentTime: Specify the persistent time of the session. The persistent time changes by a selected session type. "singleip", "rangeip": 120-86400 "cookie": 0-86400-cookie Cookie: Specify a cookie pattern. This option is enabled only when the "cookie" is specified for SessionType.-netmask RangeNetMask: Specify the netmask of a client. This option is enabled only when the "rangeip" is specified for SessionType.

[-forward ForwardTyoe] Specify the translation type of a packet.mat: Direct Server Returnnat: Network Address Translation

-realserver NetworkAddressNetMask[RealServerPortNumber] [Weight](Required)

Specify the network informantion of a real server.NetworkAddress: Specify the network address of the real server.NetMask: Specify the subnet mask.RealServerPortNumber: Specify the connection port numnber of the real server.Weight: Specify the load balancing weight of the real server.You can configure the number of "0"-"65000".

[Syntax examples]

>ssc lbgroup create SS8000 LBGroup 172.16.0.100 tcp 80 -type rr -session cookie -cookie SSC -realserver 192.168.1.0 255.255.255.0 80 >ssc lbgroup create slb-2 LBGroup 172.18.0.100 udp 80 -type res -session rangeip 300 -netmask 255.0.0.0 -forward mat -realserver 192.168.40.0 255.255.255.0

2.14.5 Deleting Load Balancer GroupDeletes a load balancer group in a load balancer or the software load balancer.

[Syntax]

ssc lbgroup delete LBName [LBGroupName]

[Parameters and Options]

LBName(Required)

Specify a load balancer name.

[LBGroupName] Specify the name of a load balancer group that you delete.

[Syntax examples]

Chapter 2. Command for Setup

147 SigmaSystemCenter 3.5 ssc Command Reference

Page 158: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc lbgroup delete SS8000 >ssc lbgroup delete SS8000 LBGroup1

2.15 Logical Machine2.15.1 Making Logical Machine

Makes the specified machine logical and creates an association with the specified physical machine.

[Syntax]

ssc logicalmachine assign < -luuid UUID | -lname MachineName > < -puuid UUID | -pnameMachineName > -profile ProfileName [-force]

[Parameters and Options]

< -luuid UUID | -lnameMachineName >(Required)

Logical machine UUID, or the name of the machine.

< -puuid UUID | -pnameMachineName >(Required)

Physical machine UUID, or the name of the machine.

-profile ProfileName(Required)

A Service Profile or a Boot Config name which is applied to the machine.

[-force] Unassociate an existing association between a logical machine and physicalmachine forcibly and create a new association.If you do not specify this option and there is an existing association whichdiffers from one you want to create, this command returns an error.

[Syntax examples]

>ssc logicalmachine assign -lname esx01 -pname blade1 -profile org-root/org-SSC-org/ls-ssc-slot01 >ssc logicalmachine assign -luuid 30381C00-D797-11DD-0000-001697A70000 -puuid 1C4D8E80-24F0-11DF-8001-001697E72265 -profile org-root/org-SSC-org/ls-ssc-slot01 >ssc logicalmachine assign -lname esx01 -pname blade2 -profile org-root/org-SSC-org/ls-ssc-slot01 -force

2.15.2 Dissociating Logical MachineDissociates a logical machine from a physical machine and makes a logical machine physical.

Also you can delete a logical machine.

[Syntax]

ssc logicalmachine release < -luuid UUID | -lname MachineName > [-force]

[Parameters and Options]

< -luuid UUID | -lnameMachineName >(Required)

Specify the logical machine UUID, or the name of the machine.

Chapter 2. Command for Setup

148 SigmaSystemCenter 3.5 ssc Command Reference

Page 159: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-force] The specified logical machine is deleted from SigmaSystemCenter and theDPM server. If you do not specify this option, you cannot delete logicalmachine instance.

[Syntax examples]

>ssc logicalmachine release -lname esx01 >ssc logicalmachine release -luuid 30381C00-D797-11DD-0000-001697A70000 >ssc logicalmachine release -lname esx01 -force

2.15.3 Displaying Logical Machine InformationDisplays logical machines information.

[Syntax]

ssc logicalmachine show [-luuid UUID | -lname MachineName] [-vertical]

[Parameters and Options]

[-luuid UUID | -lnameMachineName]

Specify the logical machine UUID or the name of the machine.If you do not specify UUID or MachineName, all registered logical machines becometargets.

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc logicalmachine show >ssc logicalmachine show -vertical >ssc logicalmachine show -lname esx01 >ssc logicalmachine show -lname esx01 -vertical >ssc logicalmachine show -luuid 30381C00-D797-11DD-0000-001697A70000 >ssc logicalmachine show -luuid 30381C00-D797-11DD-0000-001697A70000 -vertical

[Display examples]

>ssc logicalmachine show -vertical

[1] MachineName : esx01 UUID : 30381C00-D797-11DD-0000-001697A70000 MACAddress : 00:16:97:A7:00:00 ProductName : Express5800/B120a [N8400-082] MachineType : LogicalMachine, VMware, VM Server ProfileName : #11_config SlotNumber : 11 Location : 192.168.1.40/11 Tag : UnitName : Description : Physical MachineName : Blade11 Physical UUID : 1C4D8E80-24F0-11DF-8001-001697E72265 Physical MACAddress : 00:16:97:E7:22:66 Physical ProductName : Express5800/B120a [N8400-082] Physical MachineType : Unitary

Chapter 2. Command for Setup

149 SigmaSystemCenter 3.5 ssc Command Reference

Page 160: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Physical ProfileName : Physical SlotNumber : 11 Physical Location : 192.168.1.40/11 Physical Tag : Physical UnitName : Physical Description :

[2] MachineName : esx02 UUID : 30381C00-D797-11DD-0100-001697A70400 MACAddress : 00:16:97:A7:04:00 ProductName : Express5800/B120a [N8400-082] MachineType : LogicalMachine, VMware, VM Server ProfileName : #12_config SlotNumber : 12 Location : 192.168.1.40/12 Tag : UnitName : Description : Physical MachineName : Blade12 Physical UUID : 0A211F80-24F4-11DF-8001-001697E72264 Physical MACAddress : 00:16:97:E7:22:62 Physical ProductName : Express5800/B120a [N8400-082] Physical MachineType : Unitary Physical ProfileName : Physical SlotNumber : 12 Physical Location : 192.168.1.40/12 Physical Tag : Physical UnitName : Physical Description :

>ssc logicalmachine show#MachineName,UUID,MACAddress,ProductName,MachineType,ProfileName,SlotNumber,Location,Tag,UnitName,Description,Physical MachineName,Physical UUID,Physical MACAddress,Physical ProductName,Physical MachineType,Physical ProfileName,Physical SlotNumber,Physical Location,Physical Tag,Physical UnitName,Physical Description"esx01","30381C00-D797-11DD-0000-001697A70000","00:16:97:A7:00:00","Express5800/B120a [N8400-082]","LogicalMachine, VMware, VM Server","#11_config","11",192.168.1.40/11","","","","Blade11","1C4D8E80-24F0-11DF-8001-001697E72265","00:16:97:E7:22:66","Express5800/B120a [N8400-082]","Unitary","","11","192.168.1.40/11","","","""esx02","30381C00-D797-11DD-0100-001697A70400","00:16:97:A7:04:00","Express5800/B120a [N8400-082]","LogicalMachine, VMware, VM Server","#12_config","12",192.168.1.40/12","","","","Blade12","0A211F80-24F4-11DF-8001-001697E72264","00:16:97:E7:22:62","Express5800/B120a [N8400-082]","Unitary","","12","192.168.1.40/12",,"""",""

>ssc logicalmachine show -lname esx01 -vertical[1] MachineName : esx01 UUID : 30381C00-D797-11DD-0000-001697A70000 MACAddress : 00:16:97:A7:00:00 ProductName : Express5800/B120a [N8400-082] MachineType : LogicalMachine, VMware, VM Server ProfileName : #11_config

Chapter 2. Command for Setup

150 SigmaSystemCenter 3.5 ssc Command Reference

Page 161: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

SlotNumber : 11 Location : 192.168.1.40/11 Tag : UnitName : Description : Physical MachineName : Blade11 Physical UUID : 1C4D8E80-24F0-11DF-8001-001697E72265 Physical MACAddress : 00:16:97:E7:22:66 Physical ProductName : Express5800/B120a [N8400-082] Physical MachineType : Unitary Physical ProfileName : Physical SlotNumber : 11 Physical Location : 192.168.1.40/11 Physical Tag : Physical UnitName : Physical Description :

>ssc logicalmachine show -luuid 30381C00-D797-11DD-0000-001697A70000 -vertical[1] MachineName : esx01 UUID : 30381C00-D797-11DD-0000-001697A70000 MACAddress : 00:16:97:A7:00:00 ProductName : Express5800/B120a [N8400-082] MachineType : LogicalMachine, VMware, VM Server ProfileName : #11_config SlotNumber : 11 Location : 192.168.1.40/11 Tag : UnitName : Description : Physical MachineName : Blade11 Physical UUID : 1C4D8E80-24F0-11DF-8001-001697E72265 Physical MACAddress : 00:16:97:E7:22:66 Physical ProductName : Express5800/B120a [N8400-082] Physical MachineType : Unitary Physical ProfileName : Physical SlotNumber : 11 Physical Location : 192.168.1.40/11 Physical Tag : Physical UnitName : Physical Description :

>ssc logicalmachine show -luuid 30381C00-D797-11DD-0000-001697A70000#MachineName,UUID,MACAddress,ProductName,MachineType,ProfileName,SlotNumber,Location,Tag,UnitName,Description,Physical MachineName,Physical UUID,Physical MACAddress,Physical ProductName,Physical MachineType,Physical ProfileName,Physical SlotNumber,Physical Location,Physical Tag,Physical UnitName,Physical Description"esx01","30381C00-D797-11DD-0000-001697A70000","00:16:97:A7:00:00","Express5800/B120a [N8400-082]","LogicalMachine, VMware, VM Server","#11_config","11",192.168.1.40/11","","","","Blade11","1C4D8E80-24F0-11DF-8001-001697E72265","00:16:97:E7:22:66","Express5800/B120a [N8400-082]","Unitary","","11","192.168.1.40/11","","",""

Chapter 2. Command for Setup

151 SigmaSystemCenter 3.5 ssc Command Reference

Page 162: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.15.4 Creating Logical Machine AccountCreates logical machine account for a host.

[Syntax]

ssc logicalmachine create-account GroupName HostName -type ConnectionType -ip IPAddress -uUserName [-p Password] [-overwrite]

[Parameters and Options]

GroupName(Required)

Specify a path to the group to which a host where you want to create the machine accountbelongs.Only a path to the group can be specified. You cannot specify a tenant or category.E.g.) Category/Group

HostName(Required)

Specify a target host name.

-type ConnectionType(Required)

Specify a connection type.Only "oob" can be specified.Note: OOB is used for Out-of-Band-Management.

-ip IPAddress(Required)

Specify an IP address.

-u UserName(Required)

Specify a user name. Depending on the destination login system, this value is case-sensitive.

[-p Password] Specify a password. If you do not specify this option or enter a null character ("") for thisoption, password is not specified.

[-overwrite] If a machine account is already registered, overwrites the account.If you do not specify this option and an account is already registered, this command returnsan error.

[Syntax examples]

>ssc logicalmachine create-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.103 -u admin >ssc logicalmachine create-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.103 -u admin -p "" >ssc logicalmachine create-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.103 -u admin -p admin >ssc logicalmachine create-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.103 -u admin -p admin -overwrite

2.15.5 Updating Logical Machine AccountUpdates logical machine account for a host.

[Syntax]

ssc logicalmachine update-account GroupName HostName -type ConnectionType <[-ip IPAddress] [-u UserName] [-p Password]>

[Parameters and Options]

Chapter 2. Command for Setup

152 SigmaSystemCenter 3.5 ssc Command Reference

Page 163: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

GroupName(Required)

Specify a path to the group to which a host where you want to update the machine accountbelongs.Only a path to the group can be specified. You cannot specify a tenant, category or model.E.g.) Category/Group

HostName(Required)

Specify a target host name.

-type ConnectionType(Required)

Specify a connection type. Only "oob" can be specified.Note: OOB is used for Out-of-Band-Management.

[-ip IPAddress] Specify an IP address to update.

[-u UserName] Specify a user name to update. Depending on the destination login system, this value iscase-sensitive.

[-p Password] Specify a password to update.If you specify a null character (""), the password is deleted.

• Specify at least one of the -ip, -u, and -p options.

[Syntax examples]

>ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.3 >ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -p admin >ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -u root >ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -u root -p root >ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.4 -p "" >ssc logicalmachine update-account Category1/Group-01 Host-001 -type oob -ip 192.168.1.105 -u administrator -p admin

2.15.6 Deleting Logical Machine AccountDeletes logical machine account from a host.

[Syntax]

ssc logicalmachine delete-account GroupName HostName -type ConnectionType

[Parameters and Options]

GroupName(Required)

Specify a path to the group to which a host where you want to delete the machine accountbelongs.Only a path to the group can be specified. You cannot specify a tenant, category or model.E.g.) Category/Group

HostName(Required)

Specify a target host name.

-type ConnectionType(Required)

Specify a connection type. Only "oob" can be specified.Note: OOB is used for Out-of-Band-Management.

Chapter 2. Command for Setup

153 SigmaSystemCenter 3.5 ssc Command Reference

Page 164: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc logicalmachine delete-account Category1/Group-01 Host-001 -type oob

2.15.7 Displaying Logical Machine Account InformationDisplays logical machine account information.

[Syntax]

ssc logicalmachine show-account [GroupName [HostName]] [-vertical]

[Parameters and Options]

[GroupName[HostName]]

Specify a host name or a path to the group to which a host where you want to display themachine account belongs.Only a path to the group can be specified. You cannot specify a tenant, category or model.E.g.) Category/GroupIf you do not specify this option, all hosts information are displayed.If you do not specify HostName, the information of all hosts which are belong to the specifiedgroup are displayed.

[-vertical] Specify format.If you do not specify this option, information is displayed in the csv format.

[Syntax examples]

>ssc logicalmachine show-account -vertical >ssc logicalmachine show-account Category1/Group-01 -vertical >ssc logicalmachine show-account Category1/Group-01 Host-001 -vertical >ssc logicalmachine show-account Category1/Group-01 Host-001

[Display examples]

>ssc logicalmachine show-account -vertical[1] GroupName : Category1/Group-01 HostName : Host-001 AccountUserName : admin AccountHostName : 192.168.1.103

[2] GroupName : Category1/Group-02 HostName : Host-002 AccountUserName : admin AccountHostName : 192.168.1.10

>ssc logicalmachine show-account Category1/Group-01 Host-001 -vertical[1] GroupName : Category1/Group-01 HostName : Host-001 AccountUserName : admin AccountHostName : 192.168.1.103

>ssc logicalmachine show-account Category1/Group-01 Host-001#GroupName,HostName,AccountUserName,AccountHostName"Category1/Group-01","Host-001","admin","192.168.1.103"

Chapter 2. Command for Setup

154 SigmaSystemCenter 3.5 ssc Command Reference

Page 165: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.15.8 Creating Logical Machine ProfileCreates logical machine profile for a host.

[Syntax]

ssc logicalmachine create-profile GroupName HostName ProfileName -m ManagerAddress -uuidvUUID [-force]

[Parameters and Options]

GroupName(Required)

Specify a path to the group to which a host where you want to create the logical machineprofile belongs.Only a path to the group can be specified. You cannot specify a tenant, category or model.E.g.) Category/Group

HostName(Required)

Specify a target host name.

ProfileName(Required)

Specify a profile name.

-m ManagerAddress(Required)

Specify an address of the manager with an effective profile(UCS Manager IP/EM IP).

-uuid vUUID(Required)

Specify a Virtual UUID.

[-force] When the host already has the machine profile, the machine profile is made again.If you do not specify this option and the host already has the machine profile, this commandreturns error.

[Syntax examples]

>ssc logicalmachine create-profile Category1/Group-01 Host-001 #11_config -m 192.168.1.40 -uuid 30381C00-D797-11DD-0000-001697A70000 >ssc logicalmachine create-profile Category1/Group-02 Host-001 org-root/org-SSC-org/ls-ssc-slot01 -m 192.168.1.100 -uuid 30381C00-D797-11DD-0000-001697A70000 -force

2.15.9 Updating Logical Machine ProfileUpdates logical machine profile for a host.

[Syntax]

ssc logicalmachine update-profile GroupName HostName <[ProfileName] [-m ManagerAddress] [-uuid vUUID] [-mac [NICNo],MAC] [-wwn [HBANo],WWPN,[WWNN]]>

[Parameters and Options]

GroupName(Required)

Specify a path to the group to which a host where you want to update the logicalmachine profile belongs.Only a path to the group can be specified. You cannot specify a tenant, category ormodel.E.g.) Category/Group

HostName(Required)

Specify a target host name.

Chapter 2. Command for Setup

155 SigmaSystemCenter 3.5 ssc Command Reference

Page 166: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[ProfileName] Specify a profile name.

[-m ManagerAddress] Specify an address of the manager with an effective profile(UCS Manager IP/EM IP).

[-uuid vUUID] Specify a Virtual UUID.

[-mac [NICNo],MAC] Specify the MAC information. Input the NIC number and MAC address separatingwith "," (comma).Specify the number from 1 to 10 for the NIC number.

[-wwn [HBANo],WWPN,[WWNN]]

Specify the WWN information. Input the HBA number, WWPN and WWNNseparating with "," (comma).Specify the number in the range of 0-9999 for the HBA number.

[Syntax examples]

>ssc logicalmachine update-profile Category1/Group-01 Host-001 -m 192.168.1.101 >ssc logicalmachine update-profile Category1/Group-01 Host-001 -mac 1,00:16:97:E7:22:66 >ssc logicalmachine update-profile Category1/Group-01 Host-001 -wwn ,2003-0030-130F-4000, >ssc logicalmachine update-profile Category1/Group-02 Host-002 org-root/org-SSC-org/ls-ssc-slot05 >ssc logicalmachine update-profile Category1/Group-02 Host-002 -uuid 30381C00-D797-11DD-0000-001697A70000 -mac ,00:16:97:E7:22:60 -wwn ,2003-0030-130F-4000,2004-0030-130F-4000

2.15.10 Deleting Logical Machine ProfileDeletes logical machine profile from a host.

[Syntax]

ssc logicalmachine delete-profile GroupName HostName

[Parameters and Options]

GroupName(Required)

Specify a path to the group to which a host where you want to delete the logical machine profilebelongs.Only a path to the group can be specified. You cannot specify a tenant, category or model.E.g.) Category/Group

HostName(Required)

Specify a target host name.

[Syntax examples]

>ssc logicalmachine delete-profile Category1/Group-01 Host-001

2.16 Smart Group2.16.1 Creating Smart Group

Creates or modifies a smart group.

[Syntax]

Chapter 2. Command for Setup

156 SigmaSystemCenter 3.5 ssc Command Reference

Page 167: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc create smartgroup SmartGroupPath -target Target -formula Formula [-value Value[...]] [-joinJoin]

[Parameters and Options]

SmartGroupPath(Required)

Specify the path of the group to which a smart group is to be registered and the name of thesmart group.Note:* The group path must exist.* You can create a smart group on the Operations view or Resource view. If you want to createit in the Operations view, add "operations:" to the beginning of the path. Or if you want to createit in the Resource view, add "resource:" to the beginning of the path.Setting examples:[operations:/category1/group11/smartgroup101]Smartgroup101 is made directly below the group11 node of the category1 of the Operationsview.[resource:/smartgroup102]Smartgroup102 is made directly below the machine node of the Resource view.* When a smart group doesn't exist in the specified path, a smart group is newly created.* When a smart group exists in the specified path, the specified condition is added to theexisting smart group.

-target Target(Required)

Specify the target property to which you want to apply a condition.Note: The kind of target you can specify depends on the view.

-formula Formula(Required)

Specify the condition of the formula. E.g.) Equal, NotEqualNote: The kind of formula you can specify depends on the Target.

[-value Value[...]] Specify the condition of the value.If the Target is "MachineName" and Formula is "Equal", the smart group can list Machineswhose name matches what you specify in this option.Only when "Any" or "NotAny" is specified for Formula, multiple values can be specified forthis option (Separate each value with a space). This option cannot be used when "Empty" or"NotEmpty" is specified for Formula.

[-join Join] If you want to combine multiple conditions when you create a new smart group, you can specifythis option.This option is enabled for a new smart group and disabled for an existing smart group.[and] (default): Combine all conditions by AND[or]: Combine all conditions by OR

[Note]

• If you want to create a smart group under an operation group of the Operation view, you cannotspecify the same name as the operation group.

Condition that can be specified with [operations:]

When specified target view is [operations:], the conditions of a smart group that can be specified areas follows.

Condition can be specified with [-target]

can be specified with [-formula] can be specifiedwith [-value]

Note

Host nameDefined ipaddress

HostNameDefinedIpAddress

BeginsWith / EndsWith / Equal /NotEqual / Match / NotMatchBeginsWith : The target startsfrom specified value.

Arbitrarycharacter string

Chapter 2. Command for Setup

157 SigmaSystemCenter 3.5 ssc Command Reference

Page 168: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

EndsWith : The target ends withspecified value.Equal : The target is the same asthe specified value.NotEqual : The target differs fromspecified value.Match : The target containsspecified value.NotMatch : The target doesn'tcontain specified value.

Host tag HostTag BeginsWith / EndsWith / Match /NotMatch / Equal / NotEqual /Empty / NotEmptyBeginsWith : The target startsfrom specified value.EndsWith : The target ends withspecified value.Match : The target containsspecified value.NotMatch : The target doesn'tcontain specified value.Equal : The target is the same asthe specified value.NotEqual : The target differs fromspecified value.Empty : The target is unset.NotEmpty : The target has beenset.

Arbitrarycharacter string

This condition iscase-sensitive.

Power status PowerStatus Any / NotAnyAny : The target is the same asany of the specified values.NotAny : The target is differentfrom all the specified values.

Unknown / Off /On / SuspendUnknown :UnknownOff : OffOn : OnSuspend :SuspendYou can specifymultiple values.

Running status RunningStatus Any / NotAnyAny : The target is the same asany specified value.NotAny : The target is differentfrom all the specified value.

Off / OnOff : Inactive/unassignedOn : Active in aOperationsGroupYou can specifymultiple values.

OS status OperatingSystemStatus Any / NotAnyAny : The target is the same asany of the specified values.NotAny : The target is differentfrom all the specified values.

Unknown / Off /OnUnknown :UnknownOff : OffOn : On

Chapter 2. Command for Setup

158 SigmaSystemCenter 3.5 ssc Command Reference

Page 169: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

You can specifymultiple values.

Hardwarestatus

HardwareStatus Any / NotAnyAny : The target is the same asany of the specified values.NotAny : The target is differentfrom all the specified values.

Unknown /Ready / Faulted /DegradedUnknown :UnknownReady : NormalFaulted : FaultedDegraded :DegradedYou can specifymultiple values.

Executingstatus

ExecuteStatus Any / NotAnyAny : The target is the same asany of the specified values.NotAny : The target is differentfrom all the specified values.

Wait / InProcess /AbortWait : WaitInProcess : InprocessAbort : AbortYou can specifymultiple values.

Maintenancestatus

MaintenanceStatus Any / NotAnyAny : The target is the same asany of the specified values.NotAny : The target is differentfrom all the specified values.

Off / OnOff : OffOn : OnYou can specifymultiple values.

Days toservice start

DaysToServiceStart LessEqual / GreaterEqualLessEqual : The target is equal toor less than the specified value.GreaterEqual : The target is equalto or more than the specifiedvalue.

Arbitrary number(0-999)

When the hostwhich hasalready startedservice (allocatedmachine) is notthe target, thecombination ofRunningStatuscondition andthis conditionshould be used.

Days toservice endDays fromservice end

DaysToServiceEndDaysFromServiceEnd

LessEqual / GreaterEqualLessEqual : The target is equal toor less than the specified value.GreaterEqual : The target is equalto or more than the specifiedvalue.

Arbitrary number(0-999)

When the hostwhich hasalready endedservice (releasedmachine) is notthe target, thecombination ofRunningStatuscondition andthis conditionshould be used.

Service startdateService enddate

ServiceStartDateServiceEndDate

Equal / NotEqual / LessEqual /GreaterEqualEqual : The target is the same asthe specified value.

date (mm/dd/yyyy)

Chapter 2. Command for Setup

159 SigmaSystemCenter 3.5 ssc Command Reference

Page 170: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

NotEqual : The target differs fromspecified value.LessEqual : The target is equal toor less than the specified value.GreaterEqual : The target is equalto or more than the specifiedvalue.

Condition that can be specified with [resource:]

When specified target view is [resource:], the conditions of a smart group that can be specified are asfollows.

Condition can be specified with [-target]

can be specified with [-formula]

can be specified with [-value]

Note

MachinenameModel nameLocationOS name

MachineNameModelNameLocationOsName

BeginsWith / EndsWith /Match / NotMatch / Equal /NotEqual / Empty /NotEmptyBeginsWith : The targetstarts from specified value.EndsWith : The target endswith specified value.Match : The target containsspecified value.NotMatch : The targetdoesn't contain specifiedvalue.Equal : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.Empty : The target is unset.NotEmpty : The target hasbeen set.

Arbitrary character string

Machine tagHost tag

MachineTagHostTag

BeginsWith / EndsWith /Match / NotMatch / Equal /NotEqual / Empty /NotEmptyBeginsWith : The targetstarts from specified value.EndsWith : The target endswith specified value.Match : The target containsspecified value.NotMatch : The targetdoesn't contain specifiedvalue.Equal : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.Empty : The target is unset.

Arbitrary character string Thisconditionis case-sensitive.

Chapter 2. Command for Setup

160 SigmaSystemCenter 3.5 ssc Command Reference

Page 171: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

NotEmpty : The target hasbeen set.

CPU type CpuName BeginsWith / EndsWith /Equal / NotEqual / Match /NotMatchBeginsWith : The targetstarts from specified value.EndsWith : The target endswith specified value.Equal : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.Match : The target containsspecified value.NotMatch : The targetdoesn't contain specifiedvalue.

Arbitrary character string

Machine type MachineType Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unitary / Blade /VirtualMachine /LostVirtualMachine /VMServer /Vmware / Xen / HyperV /Kvm / PublicCloud /NecCloudIaaSUnitary : UnitaryBlade : BladeVirtualMachine : VirtualMachineLostVirtualMachine : LostVirtual MachineVMServer : VM ServerVmware : VMwareXen : XenHyperV : Hyper-VKvm : KVMKvm : KVMPublicCloud : Public CloudServerNecCloudIaaS : Nec CloudIaaS ServerYou can specify multiplevalues.

Power status PowerStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / Off / On /SuspendUnknown : UnknownOff : OffOn : OnSuspend : SuspendYou can specify multiplevalues.

Chapter 2. Command for Setup

161 SigmaSystemCenter 3.5 ssc Command Reference

Page 172: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Runningstatus

RunningStatus Any / NotAnyAny : The target is the sameas any specified value.NotAny : The target isdifferent from all thespecified value.

Off / OnOff : Inactive/unassignedOn : Active in a OperationsGroupYou can specify multiplevalues.

OS status OperatingSystemStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / Off / OnUnknown : UnknownOff : OffOn : OnYou can specify multiplevalues.

Hardwarestatus

HardwareStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / Ready /Faulted / DegradedUnknown : UnknownReady : NormalFaulted : FaultedDegraded : DegradedYou can specify multiplevalues.

Executingstatus

ExecuteStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Wait / InProcess / AbortWait : WaitInProcess : In processAbort : AbortYou can specify multiplevalues.

Policy status PolicyStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / Off / Partial /OnUnknown : UnknownOff : All disabledPartial : Partially enabledOn : All enabledYou can specify multiplevalues.

Maintenancestatus

MaintenanceStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Off / OnOff : OffOn : OnYou can specify multiplevalues.

Sensor status SensorCurrentStatus AnyAny : The target is the sameas any of the specifiedvalues.

WarningOrCritical / CriticalWarningOrCritical :Warning or CriticalCritical : CriticalYou can specify the value ofeither.

Chapter 2. Command for Setup

162 SigmaSystemCenter 3.5 ssc Command Reference

Page 173: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Connectionstatus of IPMI

IpmiStatus Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / Connected /NotResponding /NotAuthenticate / InvalidUnknown : UnknownConnected : ConnectedNotResponding : NotRespondingNotAuthenticate : NotAuthenticateInvalid : InvalidYou can specify multiplevalues.

Disk type VmDiskType Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Thin / Thick / DifferencingThin : Thin DiskThick : Thick DiskDifferencing : DifferencingDiskYou can specify multiplevalues.

Createmethod ofVM

VmCreatingMethod Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

FullClone /HWProfileClone /DiffClone / DiskCloneFullClone : Full CloneHWProfileClone : HWProfile CloneDiffClone : DifferentialCloneDiskClone : Disk CloneYou can specify multiplevalues.

Disk usage VmDiskUsage Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

SystemDisk / DataStore /ExtendedDiskSystemDisk : System DiskDataStore : DatastoreExtendedDisk : ExtendedDiskYou can specify multiplevalues.

Memory size MemorySize Equal / LessEqual /GreaterEqualEqual : The target is the sameas the specified value.LessEqual : The target isequal to or less than thespecified value.GreaterEqual : The target isequal to or more than thespecified value.

Arbitrary number(GByte)(0-99999)

System disk'sused amount

VmSystemDiskUsedVmDifferencingDiskUsedVmDataStoreUsed

LessEqual / GreaterEqual Arbitrary number(GByte)(0-2097152)The first decimal place.

Chapter 2. Command for Setup

163 SigmaSystemCenter 3.5 ssc Command Reference

Page 174: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Differencedisk's usedamountDatastore'sused amountExtendeddisk's usedamount

VmExtendedDiskUsed LessEqual : The target isequal to or less than thespecified value.GreaterEqual : The target isequal to or more than thespecified value.

CPU socketsCPU threads

CpuSocketCpuThread

Equal / NotEqual /LessEqual / GreaterEqualEqual : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.LessEqual : The target isequal to or less than thespecified value.GreaterEqual : The target isequal to or more than thespecified value.

Arbitrary number(GByte)(0-99999)

CPU clockspeed

CpuClock Equal / NotEqual /LessEqual / GreaterEqualEqual : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.LessEqual : The target isequal to or less than thespecified value.GreaterEqual : The target isequal to or more than thespecified value.

Arbitrary number(GHz)(0-2097152)The first decimal place.

Group poolsettings

GroupPoolSetting Empty / NotEmptyEmpty : The target is unset.NotEmpty : The target hasbeen set.

You cannot specify value.

Vendor Vendor Any / NotAnyAny : The target is the sameas any of the specifiedvalues.NotAny : The target isdifferent from all thespecified values.

Unknown / IBM / HP /NEC / DELL / CiscoUnknown : UnknownIBM : IBMHP : HPNEC : NECDELL : DELLCisco : CiscoYou can specify multiplevalues.

Vendor ID VendorID Equal / NotEqualEqual : The target is the sameas the specified value.NotEqual : The target differsfrom specified value.

Arbitrary number (0~2147483647)

Chapter 2. Command for Setup

164 SigmaSystemCenter 3.5 ssc Command Reference

Page 175: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

Smartgroup101 is created right under subgroup11 of the group1 subordinate with the machine node of the Resource view. The condition is "The power supply is off or suspended". >ssc create smartgroup resource:/group1/subgroup11/smartgroup101 -target PowerStatus -formula Any -value Off Suspend

Smartgroup102 is created right under group1 with the machine node of the Resource view. The condition is "The power supply is off or suspended" or "The hardware state is not normal". >ssc create smartgroup resource:/group1/smartgroup102 -target PowerStatus -formula Any -value Off Suspend -join or >ssc create smartgroup resource:/group1/smartgroup102 -target HardwareStatus -formula NotAny -value Ready -join or

Smartgroup103 is created right under the machine node of the Resource view. The condition is "The machine type is VMServer" and "The machine name is including Express" and "The execution status is in waiting or in processing". >ssc create smartgroup resource:/smartgroup103 -target MachineType -formula Any -value VmServer -join and >ssc create smartgroup resource:/smartgroup103 -target MachineName -formula Match -value Express -join and >ssc create smartgroup resource:/smartgroup103 -target ExecuteStatus -formula Any -value Wait InProcess -join and

2.16.2 Deleting Smart GroupDeletes a smart group.

[Syntax]

ssc delete smartgroup GroupPath [-lump]

[Parameters and Options]

GroupPath(Required) Specify the path of the group to which the smart group to delete is registered or the path ofthe smart group.Note:* The group path must exist.* If you want to delete Operations view smart group, please specify "operations:" to the rootof path, and If you want to delete Resource view smart group, please specify "resource:" tothe root of path.Setting examples:[operations:/category1/group11/smartgroup101]Smartgroup101 is delete below the group11 node of the category1 of the Operations view.[resource:/smartgroup102]Smartgroup102 is delete below the machine node of the Resource view.

Chapter 2. Command for Setup

165 SigmaSystemCenter 3.5 ssc Command Reference

Page 176: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-lump] Delete all smart groups directly below the specified path.This option is enabled only when a group path is specified for GroupPath.

[Syntax examples]

Smartgroup101 is deleted from right under subgroup11 of the group1 subordinate to the machine node of the Resource view. >ssc delete smartgroup resource:/group1/subgroup11/smartgroup101

All smart groups right under subgroup11 of the group1 subordinate to the Resource view are deleted. >ssc delete smartgroup resource:/group1/subgroup11 -lump

2.16.3 Displaying Smart Group PropertiesDisplays a smart group setting information.

[Syntax]

ssc show smartgroup GroupPath [-detail]

[Parameters and Options]

GroupPath(Required)

Specify a path of smart group or group that you want to display.If you specify group path, all smart group properties which are under the specified group (includesubgroups) are displayed.Note:* The path must exist.* If you want to display the smart group properties in the Operations view, please specify "operations:"to the root of path, and If you want to display the smart group properties it in the Resource view, pleasespecify "resource:" to the root of path.Setting examples:[operations:/category1/group11/smartgroup101]The smart group properties of smartgroup101 below the group11 node of the category1 of theOperations view is displayed.[operations:/category1/group11]The properties of all the smart groups below the group11 node of the category1 of the Operations viewis displayed.[resource:/smartgroup102]The smart group properties of smartgroup102 below the machine node of the Resource view isdisplayed.[resource:/]The properties of all the smart groups below the machine node of the Resource view is displayed.

[-detail] Display detail information.

[Syntax examples]

The properties of smartgroup101 right under group11 of the category1 subordinate to the Operations view is displayed. >ssc show smartgroup operations:/category1/group11/smartgroup101

All the smart group properties of the group11 subordinate to the category1 subordinate to the Operations view are displayed in detail. >ssc show smartgroup operations:/category1/group11 -detail

Chapter 2. Command for Setup

166 SigmaSystemCenter 3.5 ssc Command Reference

Page 177: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The properties of smartgroup102 right under the machine node of the Resource view is displayed in detail. >ssc show smartgroup resource:/smartgroup102 -detail

The properties of all smart groups of the Resource view is displayed. >ssc show smartgroup resource:/

2.16.4 Exporting Smart Group SettingsExports smart group settings to the XML file.

[Syntax]

ssc export smartgroup FileName GroupPath

[Parameters and Options]

FileName(Required)

Specify the output XML file name.To include a space in the file name path, surround the file name path with double quotation(").If just a file name is specified, the current folder when executing this command is the file path.When the specified file does not exist, a new folder is created.When the specified file exists, overwrite it.

GroupPath(Required)

Specify a path of smart group or group that you want to export.Note:* The group path must exist.* If you want to export the smart group settings in the Operations view, please specify "operations:" tothe root of path, and If you want to export the smart group settings it in the Resource view, pleasespecify "resource:" to the root of path.Setting examples:[operations:/category1/group11]The settings of all the smart groups below the group11 node of the category1 of the Operations view isexported to XML file.[resource:/group2/group12/smartgroup102]The smart group settings of smartgroup102 below the group12 node of the group2 of the Resourceview is exported to XML file.[resource:/]The settings of all the smart groups below the machine node of the Resource view is exported to XMLfile.

[Syntax examples]

All smart groups right under group11 of the category1 subordinate of the Operations view are exported to "C:/ssc/smartgroup.xml". >ssc export smartgroup c:/ssc/smartgroup.xml operations:/category1/group11

smartgroup102 right under group12 of the group2 subordinate of the Resource view is exported to "C:/ssc/smartgroup.xml". >ssc export smartgroup c:/ssc/smartgroup.xml resource:/group2/group12/smartgroup102

All smart groups right under the machine node of the Resource view are exported to "C:/ssc/smartgroup.xml".

Chapter 2. Command for Setup

167 SigmaSystemCenter 3.5 ssc Command Reference

Page 178: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc export smartgroup c:/ssc/smartgroup.xml resource:/

smartgroup201 right under the operation node of the Operations view is exported to "C:/ssc/smartgroup.xml". >ssc export smartgroup c:/ssc/smartgroup.xml operations:/smartgroup201

2.16.5 Importing Smart Group SettingsImports smart group settings from a XML file.

[Syntax]

ssc import smartgroup FileName GroupPath

[Parameters and Options]

FileName(Required)

Specify a XML file which you want to import.To include a space in the file name path, surround the file name path with double quotation (").If just a file name is specified, the current folder when executing this command is the file path.

GroupPath(Required)

Specify a path of group where you import the settings.Note:* The group path must exist.* If you want to import the smart group settings in the Operations view, please specify "operations:" tothe root of path, and If you want to import the smart group settings it in the Resource view, pleasespecify "resource:" to the root of path.Setting examples:[operations:/category1/group11]Smart groups in the XML file are imported to the smart group settings below the group11 node of thecategory1 of the Operations view.[resource:/]Smart groups in the XML file are imported to the smart group settings below the machine node of theResource view.

• If the importing process stops by any fault, all imports are rolled back.

[Syntax examples]

Smart groups of "C:/ssc/smartgroup.xml" are imported right under the group11 node of the category1 subordinate to the Operations view. >ssc import smartgroup c:/ssc/smartgroup.xml operations:/category1/group11

Smart groups of "C:/ssc/smartgroup.xml" are imported right under the machine node of the Resource view. >ssc import smartgroup c:/ssc/smartgroup.xml resource:/

[Note]

• When the exported XML file is edited and imported, there is a possibility that the followingproblems happen. Please do not import the edited XML file.

- This command fails.

- The condition is not correctly displayed on the smart group edit screen.

- The anticipated result when a smart group is specified cannot be acquired.

Chapter 2. Command for Setup

168 SigmaSystemCenter 3.5 ssc Command Reference

Page 179: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.17 Profile2.17.1 Creating a Performance Monitoring Profile

Creates a performance monitoring profile.

[Syntax]

ssc monitoringprofile create ProfileName [-scope < public | private >] [-tenant TenantName] [-description Description] [-source CopyProfileName] [-perfinfo <name=value | id=value>[interval=value] [, <name=value | id=value> [interval=value]...]] [-report type=value[definition=ReportDefinitionFile] [interval=value]]

[Parameters and Options]

ProfileName(Required)

Specify a name of performance monitoring profile.Up to 63 characters are available in this option.Possible characters are alphanumerics, spaces and symbols ("(", ")","-", "_").

[-scope < public | private >] Set the public scope.By default, public is set.

[-tenant TenantName] Specify the tenant to be published.If public is set for -scope, this option cannot be specified.

[-description Description] Specifies a description of the performance monitoring profile.Up to 255 characters are available in this option.

[-source CopyProfileName] Specify the name of the performance monitoring profile with the list ofperformance information to be copied.

[-perfinfo <name=value | id=value>[interval=value][, <name=value | id=value>[interval=value]...]]

Specify the performance information.(You can specify multiple items.)When you specify multiple items, separate the data with commas (",").name: Specify the name of the performance information.Up to 256 characters are available in this option.When specifying the custom performance information defined bySystem Monitor - Performance Monitoring Services, specify "id=0" asthe id option as well as the name option.id: Specify the MetricId.For possible values, refer to the manual.interval: Specify the collection interval for the performanceinformation.

[-report type=value[definition=ReportDefinitionFile][interval=value]]

A performance monitoring profile required by the report definition fileswill be created.type: Specify the type of monitoring target.- VMServer: VM Server- VM: VM- Physical: Physical machinedefinition: Specify the name or ID of report definition file.interval: Specify the collection interval for performance information.

[Note]

Specify the following collection intervals:

1 minute interval: "00:01"

Chapter 2. Command for Setup

169 SigmaSystemCenter 3.5 ssc Command Reference

Page 180: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

5 minute interval: "00:05"

30 minute interval: "00:30"

1 hour interval: "01:00"

4 hour interval: "04:00"

1 day interval: "1"

1 week interval: "7"

1 month interval: "30"

Default is "00:05" (5 minute interval).

[Syntax examples]

>ssc monitoringprofile create profile1 -description "This is profile1." -perfinfo name="CPU Usage (%)" interval="00:01">ssc monitoringprofile create profile2 -description "This is profile2." -perfinfo id=1 , name="Disk Space (MB)" interval="1">ssc monitoringprofile create profile2 -description "This is profile2." -source "profile1" -perfinfo id=0 name=="CPU Usage (GHz)" , name="Disk Space (MB)" interval="1"

[Reference materials]

The list of possible values for the name option and the id option:

The name of the performance information(Name) MetricId

CPU Usage (%) 1

CPU System Usage (%) 2

CPU User Usage (%) 3

CPU Usage (MHz) 4

Guest CPU Usage (%) 11

Guest CPU Usage (MHz) 12

Host CPU Usage (%) 13

Host CPU Usage (MHz) 14

Disk Transfer Rate (Bytes/sec) 21

Disk IO Count (IO/sec) 22

Disk Read Transfer Rate (Bytes/sec) 23

Disk Read Count (IO/sec) 24

Disk Write Transfer Rate (Bytes/sec) 25

Disk Write Count (IO/sec) 26

Disk Space (MB) 27

Disk Space Ratio (%) 28

Guest Disk Transfer Rate (Bytes/sec) 31

Guest Disk Usage (MB) 37

Guest Disk Usage (%) 38

Network Packet Transfer Rate (Bytes/sec) 41

Network Packet Reception Rate (Bytes/sec) 42

Chapter 2. Command for Setup

170 SigmaSystemCenter 3.5 ssc Command Reference

Page 181: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Network Packet Transmission Rate (Bytes/sec) 43

Guest Network Transfer Rate (Bytes/sec) 51

Physical Memory Space (MB) 61

Physical Memory Space Ratio (%) 62

Guest Memory Usage (%) 71

Guest Memory Usage (MB) 72

Host Memory Usage (%) 73

Host Memory Usage (MB) 74

Current Power (W) 101

2.17.2 Updating the Profile Settings for PerformanceMonitoring

Updates the profile settings for performance monitoring.

[Syntax]

ssc monitoringprofile update ProfileName [-scope < public | private >] [-tenant TenantName] [-deleteid] [-description Description] [-perfinfo <name=value | id=value> [interval=value] [,<name=value | id=value> [interval=value]...]] [-delperfinfo <name=value | id=value> [<name=value |id=value>]...]

[Parameters and Options]

ProfileName(Required)

Specify the name of the performance monitoring profile to be updated.

[-scope < public | private >] Specify the public scope.

[-tenant TenantName] Specify the tenant to be published.If the target scope is public, this option cannot be specified.

[-deleteid] Delete the Resource Management ID.You cannot specify this option together with [-tenant].

[-description Description] Update the description of the performance monitoring profile.Up to 255 characters are available in this option.

[-perfinfo <name=value |id=value> [interval=value][, <name=value | id=value>[interval=value]...]]

Specify the performance information (You can specify multiple items). When youspecify multiple items, separate the data with commas (",").name: Specify the name of the performance information.Up to 256 characters are available in this option.When specifying the custom performance information defined by System Monitor -Performance Monitoring Services, specify "id=0" as the id option as well as thename option.id: Specify the MetricId.For possible values, refer to "1.1.7 Performance Data and Metric IDs (page 16)".interval: Specify the collection interval for the performance information.Specify the following collection intervals:1 minute interval: "00:01"5 minute interval: "00:05"30 minute interval: "00:30"1 hour interval: "01:00"

Chapter 2. Command for Setup

171 SigmaSystemCenter 3.5 ssc Command Reference

Page 182: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

4 hour interval: "04:00"1 day interval: "1"1 week interval: "7"1 month interval: "30"Default is "00:05" (5 minute interval).If the performance information is registered, update the collection interval.If the performance information is not registered, add the performance information.

[-delperfinfo <name=value |id=value>[<name=value | id=value>]...]

Specifies the performance information to be deleted.name: Specify the name of performance information.id: Specify the MetricId.For possible values, refer to "1.1.7 Performance Data and Metric IDs (page 16)".

[Syntax examples]

>ssc monitoringprofile update profile1 -description "This is the profile1.">ssc monitoringprofile update profile1 -perfinfo name="CPU Usage (%)">ssc monitoringprofile update profile2 -description "This is the profile2." -perfinfo id=1 interval="00:30" , name="Disk Space (MB)">ssc monitoringprofile update profile2 -description "This is the profile2." -perfinfo id=0 name="CPU Usage (GHz)" interval="00:30" , name="Disk Space (MB)" -delperfinfo id=2 name="Current Power (W)"

2.17.3 Deleting a Performance Monitoring ProfileDeletes a performance monitoring profile.

[Syntax]

ssc monitoringprofile delete ProfileName [ProfileName...] [-i]

[Parameters and Options]

ProfileName[ProfileName...](Required)

Specify the name of the performance monitoring profile.Any model is assigned to a group monitoring the profile of this performance can notbe removed.

[-i] Any confirmation message is displayed.

[Syntax examples]

>ssc monitoringprofile delete profile1>ssc monitoringprofile delete profile1 profile2 -i

2.17.4 Displaying the Performance Monitoring Profile SettingsDisplays performance monitoring profile settings.

[Syntax]

ssc monitoringprofile show [<-path Path [-host HostName] | -profile ProfileName>] [-threshold]

[Parameters and Options]

-path Path Specify the full path of an operation group and a model to be displayed.View Type ("operations:/") is optional.E.g.,When specifying a group name:

Chapter 2. Command for Setup

172 SigmaSystemCenter 3.5 ssc Command Reference

Page 183: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Category/GroupWhen specifying a model name:Category/Group/ModelWhen specifying a model name (full path):operations:/Category/Group/Model

[-host HostName] Specify the host name of a target.If you specify this option, specify an operation group for Path.

-profile ProfileName Specify the name of a performance monitoring profile.The settings of a specified performance monitoring profile are displayed.

[-threshold] Threshold settings are displayed.

[Note]

If not specified -path and -profile, all of the performance monitoring profile settings are displayed.

[Display examples]

* Showing of all performance monitoring profiles. >ssc monitoringprofile show[MonitoringProfile][1] ----------- Profile Name : Standard Monitoring Profile (1min) Public Scope : Public Resource Management ID : Description : [PerformanceInformation][1] Performance Name : CPU Usage (%) Interval : One minute [PerformanceInformation][2] Performance Name : Disk Transfer Rate (Bytes/sec) Interval : One minute [PerformanceInformation][3] Performance Name : Disk Space (MB) Interval : One minute [PerformanceInformation][4] Performance Name : Physical Memory Space (MB) Interval : One minute[MonitoringProfile][2] ----------- Profile Name : Standard Monitoring Profile (5min) Public Scope : Public Resource Management ID : Description : [PerformanceInformation][1] Performance Name : CPU Usage (%) Interval : Five minutes [PerformanceInformation][2] Performance Name : Disk Transfer Rate (Bytes/sec) Interval : Five minutes [PerformanceInformation][3] Performance Name : Disk Space (MB) Interval : Five minutes [PerformanceInformation][4] Performance Name : Physical Memory Space (MB) Interval : Five minutes

...

Chapter 2. Command for Setup

173 SigmaSystemCenter 3.5 ssc Command Reference

Page 184: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[MonitoringProfile][10] ----------- Profile Name : Physical Machine Monitoring Profile (30min) Public Scope : Public Resource Management ID : Description : [PerformanceInformation][1] Performance Name : CPU Usage (%) Interval : 30 minutes [PerformanceInformation][2] Performance Name : Disk Transfer Rate (Bytes/sec) Interval : 30 minutes [PerformanceInformation][3] Performance Name : Disk Space (MB) Interval : 30 minutes [PerformanceInformation][4] Performance Name : Physical Memory Space (MB) Interval : 30 minutes [PerformanceInformation][5] Performance Name : Current Power (W) Interval : 30 minutes

* Showing of a performance monitoring profile of specified. >ssc monitoringprofile show -profile "Standard Monitoring Profile (1min)"[MonitoringProfile] Profile Name : Standard Monitoring Profile (1min) Public Scope : Public Resource Management ID : Description : [PerformanceInformation][1] Performance Name : CPU Usage (%) Interval : One minute [PerformanceInformation][2] Performance Name : Disk Transfer Rate (Bytes/sec) Interval : One minute [PerformanceInformation][3] Performance Name : Disk Space (MB) Interval : One minute [PerformanceInformation][4] Performance Name : Physical Memory Space (MB) Interval : One minute

* Showing of the performance monitoring profile set as a group (There is setting for a group). >ssc monitoringprofile show -path group1[MonitoringProfile] Profile Name : Standard Monitoring Profile (1min) Public Scope : Public Resource Management ID : Description : [PerformanceInformation][1] Performance Name : CPU Usage (%) Interval : One minute [PerformanceInformation][2] Performance Name : Disk Transfer Rate (Bytes/sec) Interval : One minute [PerformanceInformation][3] Performance Name : Disk Space (MB) Interval : One minute

Chapter 2. Command for Setup

174 SigmaSystemCenter 3.5 ssc Command Reference

Page 185: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[PerformanceInformation][4] Performance Name : Physical Memory Space (MB) Interval : One minute[SystemMonitor ManagementServer] IP Address : 127.0.0.1 Port Number : 26200[Host Access Account] Account : root Password : ******

* Showing of the performance monitoring profile set as a group (for a group, without setting). >ssc monitoringprofile show -path group2[MonitoringProfile] Profile Name : Public Scope : Resource Management ID : Description :

2.17.5 Setting a Performance Monitoring Profile to a Group(Group/Model)

Sets a performance monitoring profile to a group (Group/Model) and host.

[Syntax]

ssc monitoringprofile set Path <ProfileName [-ip IPAddress] [-port PortNumber] [-account Account][-p Password] | -delete | -disable [-ip IPAddress] [-port PortNumber] [-account Account] [-pPassword]> [-host HostName]

[Parameters and Options]

Path(Required)

Specify the full path of a target operating group or a model.You can omit view type ("operations:/").E.g.:When specifying a group name:Category/GroupWhen specifying a model name:Category/Group/ModelWhen specifying a model name (view type is specified):operations:/Category/Group/Model

ProfileName Specify the name of the performance monitoring profile.

[-ip IPAddress] Specify the IP address of SystemMonitor management server.If omitted, "127.0.0.1" is set to this option.

[-port PortNumber] Specify the port number of the SystemMonitor management server.Specify it with a number from 1 to 65535.If omitted, "26200" is set to this option.

[-account Account] Specify the account used for access to a target host.This account is used when direct access to a target host is necessary to obtain data from it.Up to 255 characters are available in this option.

[-p Password] Specify the password used for access to a target host.This password is used when direct access to a target host is necessary to obtain data from it.

Chapter 2. Command for Setup

175 SigmaSystemCenter 3.5 ssc Command Reference

Page 186: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Up to 256 characters are available in this option.

-delete Specify this option if you want to delete the performance monitoring setting information onthe specified path.

-disable Specify this option if you want to disable the performance monitoring setting information onthe specified path.

[-host HostName] Specify the host name.Set a performance monitoring profile to a specified host.If you specify this option, specify the operation group for Path.

[Syntax examples]

>ssc monitoringprofile set Group1 profile1>ssc monitoringprofile set Group1 profile1 -ip 127.0.0.1>ssc monitoringprofile set Group1 profile1 -ip 127.0.0.1 -port 26200>ssc monitoringprofile set Group1 profile1 -ip 127.0.0.1 -port 26200 -account root -p root123>ssc monitoringprofile set Group1 -delete>ssc monitoringprofile set Group1 -disable

2.17.6 Creating a Named Host ProfileCreates a named host profile.

[Syntax]

ssc hostprofile create ProfileName OsType <[-private [GroupName]] [-os [osname=<name | code>][password=value] [SysprepFile=value] [owner=value] [orgname=value] [timezone=value][productkey=value] [ConnectedNumber=value] [DomainType=<workgroup | domain>][DomainName=value] [DomainAccount=value] [DomainPassword=value] [License=value][AccountName=value] [Roles=value, ...]] [-dnsNICNo,<Primary,Secondary,PrimaryWINS,SecondaryWINS | Primary,Secondary,Tertiary> ...] [-extend Command=value] | -delete [dns | extend | osservice | account]> [-dns4 NICNo,<Primary |Primary,Secondary | Primary,Secondary,Tertiary> ...] [-dns6 NICNo,<Primary | Primary,Secondary |Primary,Secondary,Tertiary> ...] [-wins4 NICNo,<Primary | Primary,Secondary> ...] [-osserviceServiceName ...] [-account Name=value Password=value [Roles=value, ...] [Groups=value, ...], ...]

[Parameters and Options]

ProfileName(Required)

Specify the name of a named host profile.

OsType(Required)

Specify an OS type.You can specify one of the following OperatingSystemTypes.OsType : OS type"Linux": Linux"Windows-client": Windows Client"Windows": Windows Server

[-private [GroupName]] To create a dedicated host profile, specify this option.Assign the tenant to which you want to assign a host profile asGroupName. (Optional).If you do not specify this option, a shared host profile is created.

[-os[osname=<name | code>]

Specify OS information.You cannot specify leading or trailing spaces in the equal ("=").

Chapter 2. Command for Setup

176 SigmaSystemCenter 3.5 ssc Command Reference

Page 187: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[password=value][SysprepFile=value][owner=value][orgname=value][timezone=value][productkey=value][ConnectedNumber=value][DomainType=<workgroup | domain>][DomainName=value][DomainAccount=value][DomainPassword=value][License=value][AccountName=value][Roles=value, ...]]

osname : OS NameSpecify the os name's code or the strings displayed on Web UI.Refer to Reference materials in "1.1.6 OS Lists and Time zones(page 13)" in this document.password : PasswordSysprepFile : Sysprep file to be importedYou can specify it only when the OS type is Windows.owner : Owner nameYou can specify it only when the OS type is Windows.orgname : The name of a organizationYou can specify it only when the OS type is Windows.timezone : Time zoneYou can specify it only when the OS type is Windows.Specify the time zone's code or the strings displayed on Web UI.Refer to Reference materials in "1.1.6 OS Lists and Time zones(page 13)" in this document.The default value is the same as the value of"Microsoft Time Zone Index Values."productkey : Product keyInput it in the xxxxx-xxxxx-xxxxx-xxxxx-xxxxx format.You can specify it only when the OS type is Windows.ConnectedNumber : The number of connected serversYou can specify it only when the OS type is Windows Server.When omitted, the license mode is "Connected Client".DomainType : Workgroup settingSpecify "workgroup" for WorkGroup, "domain" for Domain.You can specify it only when the OS type is Windows.DomainName : The name of a Domain(WorkGroup)DomainAccount : Domain accountYou can specify it only when the OS type is Windows.DomainPassword : Domain passwordYou can specify it only when the OS type is Windows.License : LicenseYou can specify it only when the OS type is Linux.AccountName : Builtin administrator nameYou can specify a builtin administrator name.Roles : RoleYou can specify "Controller" or "WSMan".You specify "Controller" for operating the OS. You specify"WSMan" for registering to ESMPRO/SAS.

[-dns NICNo, <Primary,Secondary,PrimaryWINS,SecondaryWINS |Primary,Secondary,Tertiary>...]

Specify DNS information.NICNo : NIC NumberPrimary : Primary DNSSecondary : Secondary DNSTertiary : Tertiary DNSYou can specify it only when the OS type is Linux.PrimaryWINS : Primary DNS WINS

Chapter 2. Command for Setup

177 SigmaSystemCenter 3.5 ssc Command Reference

Page 188: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

You can specify it only when the OS type is Windows.SecondaryWINS : Secondary DNS WINSYou can specify it only when the OS type is Windows.You cannot specify this option along with [-dns4], [-dns6] and [-wins4].

[-extend Command=value] Specify Extensive information.You cannot specify leading or trailing spaces in the equal ("=").Command : Specify command names to be added separatingthem with ',' (comma).

-delete [dns | extend | osservice | account] Specify this option if the setting information should be deleted.If you specify the option name, the setting information of thatoption is deleted.Execute this option separating from other options.If any option name is not specified, the host profile is deleted.You cannot delete only the OS information.

[-dns4 NICNo,<Primary,Secondary |Primary,Secondary,Tertiary> ...]

Specify DNS(IPv4) information.NICNo : NIC NumberPrimary : Primary DNSSecondary : Secondary DNSTertiary : Tertiary DNS  You can specify it only when the OS type is Linux.You cannot specify this option along with [-dns].

[-dns6 NICNo,<Primary,Secondary |Primary,Secondary,Tertiary> ...]

Specify DNS(IPv6) information.NICNo : NIC NumberPrimary : Primary DNSSecondary : Secondary DNSTertiary : Tertiary DNS  You can specify it only when the OS type is Linux.You cannot specify this option along with [-dns].

[-wins4NICNo,<PrimaryWINS,SecondaryWINS ...]

Specify WINS(IPv4) information.PrimaryWINS : Primary WINS  You can specify it only when the OS type is Windows.SecondaryWINS : Secondary WINS  You can specify it only when the OS type is Windows.You cannot specify this option along with [-dns].

[-osservice ServiceName ...] Specified the service name of waiting for startup, when themachine is started.

[-account Name=value Password=value[Roles=value, ...] [Groups=value, ...], ...]

Specified a local user account.Name : Specified the account name.you cannot specifiy "Administrator" or "root".Password : Specified the password.Roles : Specified the role that you use to control.You can specify "Controller" or "WSMan".You specify "Controller" for operating the OS. You specify"WSMan" for registering to ESMPRO/SAS.Groups : Specified the group names.

Chapter 2. Command for Setup

178 SigmaSystemCenter 3.5 ssc Command Reference

Page 189: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When you specify multiple items, separate the data with commas(",").

[Note]

• Be sure to specify all contents of setting of the -os option, if you specify the -os option.

[Syntax examples]

Windows OS >ssc hostprofile create NamedHostProfile1 Windows -os osname="Windows Server 2003 Enterprise (x64)" password="pass" owner="ABC Corporation" orgname="1st section" timezone=235 productkey=12345-67890-ABCD1-EFG21-HI123 DomainType=workgroup DomainName="WorkGroup" -dns 1,192.168.1.1,192.168.1.2 2,10.108.110.1,10.108.110.2,10.108.110.3 >ssc hostprofile create NamedHostProfile1 Windows -os osname="Windows Server 2003 Enterprise (x64)" password="pass" owner="ABC Corporation" orgname="1st section" timezone=235 productkey=12345-67890-ABCD1-EFG21-HI123 DomainType=workgroup DomainName="WorkGroup" -dns4 1,192.168.1.100,192.168.1.101 -dns6 1,::192.168.1.150 3,::192.168.1.152 -wins4 1,192.168.1.200 2,192.168.1.201Linux OS >ssc hostprofile create NamedHostProfile2 Linux -os osname="Red Hat Enterprise Linux AS 4" password="pass" DomainName="Domain1" -dns 1,192.168.1.1,192.168.1.2,192.168.1.3 -extend Command=startcmd1,startcmd2 >ssc hostprofile create NamedHostProfile2 Linux -os osname="Red Hat Enterprise Linux AS 4" password="pass" DomainName="Domain1" -dns4 1,192.168.1.100,192.168.1.101,192.168.1.102 -dns6 1,::192.168.1.150,::192.168.1.151 -extend Command=startcmd1,startcmd2Windows-Client >ssc hostprofile create NamedHostProfile3 Windows-client -os osname="Windows Vista Business (x64)" password="pass" owner="ABC Corporation" orgname="1st section" timezone=235 productkey=12345-67890-ABCD1-EFG21-HI123 ConnectedNumber=10 DomainType=domain DomainName="Domain1" DomainAccount="admin" DomainPassword=adminpass -dns 1,192.168.1.1,192.168.1.2 2,10.108.110.1,10.108.110.2,10.108.110.3-delete >ssc hostprofile create NamedHostProfile1 Windows -delete dns >ssc hostprofile create NamedHostProfile2 Linux -delete

2.17.7 Creating a Named Machine ProfileCreates a named machine profile

[Syntax]

ssc profile create ProfileName <[-private [GroupName]] [-cost costValue] [-cpu count=value[share=value] [reservation=value] [limit=value]] [-mem size=value [share=value][reservation=value] [limit=value]] [-vnet VirtualNetworkName...] [-vnettype <vlan | network |edit>...] [-bandcontrol nic=value [type=value] [limit=value burstlimit=value burstsize=value], ...] [-systemdisk size=value [type=<thin | thick>] [independent] [datastoretag=value | datastore][share=value] [reservation=value] [limit=value]] [-extdisk size=value [ctrl=value [position=value]]

Chapter 2. Command for Setup

179 SigmaSystemCenter 3.5 ssc Command Reference

Page 190: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[type=<thin | thick | rdm-p | rdm-v>] [independent] [datastoretag=value | datastore] [lun][share=value] [reservation=value] [limit=value], ...] | -delete [cost | cpu | mem | vnet | systemdisk |extdisk]>

[Parameters and Options]

ProfileName(Required)

Specify a name of named machine profile.

[-private [GroupName]] To create a dedicated machine profile, specify this option.Assign the tenant to which you want to assign a machine profile as GroupName(Optional).If you do not specify this option, a shared machine profile is created.

[-cost costValue] Specify a cost value in the range of the number from 1 to 1000.

[-cpu count=value[share=value][reservation=value][limit=value]]

Specify the number of CPUs, shared value, reservation value and limit value.The number of CPUs must be specified.You cannot specify leading or trailing spaces in the equal ("=").count : Specify the number of CPUs.Specify a value in the range of the number from 1 to 9999 (E.g.: count=2).share : Specify a CPU shared value.CPU shared value settings for each virtualizationinfrastructure are as follows:VMware Setting * CPU countHyper-V Setting/10Xen Setting * 256/1000KVM Setting * 1024 / 1000Specify one of the following values."he": Highest(4000)"h": High(2000)"n": Normal(1000)"l": Low(500)"le": Lowest(250)"1" - "99999": Manual(E.g.: share=h, share=30).Optional. The default value is "n."reservation : Specify a CPU allocation value(MHz).Specify a value in the range of the number from 0 to 99999(E.g.: reservation=1000).Optional. The default value is 0.limit : Specify the upper limit of a CPU resource assignment(MHz).Specify a value in the range of the number from 0 to 99999(E.g.: limit=1500).Optional. The default value is 0 (unlimited).

[-mem size=value[share=value][reservation=value][limit=value]]

Specify memory size, shared value, reservation value and limit value.You cannot specify leading or trailing spaces in the equal ("=").size : Specify memory size (MB) in the range of the number from 1 to 99999999(MB)(E.g.: size=512).share : Specify a memory shared value.

Chapter 2. Command for Setup

180 SigmaSystemCenter 3.5 ssc Command Reference

Page 191: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Memory shared value settings for each virtualizationinfrastructure are as follows:VMware Setting * the Memory size / 100Hyper-V Setting * 5Xen you cannot specify.KVM you cannot specify.Specify one of the following values."h": High(2000)"n": Normal(1000)"l": Low(500)"0" - "10000": Manual(E.g.: share=h, share=100).Optional. The default value is "n."reservation : Specify a memory allocation value(MB).Specify a value in the range of the number from 0 to 99999999(E.g.: reservation=2048).Optional. The default value is 0.limit : Specify the upper limit of a memory size(MB).Specify a value in the range of the number from 0 to 99999999(E.g.: limit=4096).Optional. The default value is 0 (unlimited).

[-vnet VirtualNetworkName...] Specify a virtual network name.You can specify up to ten names (from NIC #1 to NIC #10), dividing them with aspace.NICs are assigned in the specified order from NIC #1.You can specify when creating a dedicated machine profile.When reflecting machine-specific information of DPM is used, the upper limitnumber of NICs you can set is:if Windows Vista or later, it's "8";if Windows 2000, Windows Server 2003 and Windows XP, it's "4."

[-vnettype <vlan | network |edit>...]

Specify the network type.Specify the number of the networks you want to configure.NICs are assigned in the specified order from NIC #1.When you want to specify a VLAN name, set "vlan"When you want to specify a logical network name, set "network"When you want to specify an arbitrary network name, set "edit"When omitted, it'll be VLAN or optional port name.You can specify only when creating a dedicated machine profile.

[-bandcontrol nic=value[type=value] [limit=valueburstlimit=valueburstsize=value], ...]

Specify the presence of Network Band Control.nic :Specify the NIC number.type : Specify control type for the virtual NIC.Specify either in / out.When omitted, the specified type is out.Hyper-V can be set out only.limit : Specify upper[kbits/s] of Band Width.burstlimit : Specify upper[kbits/s] of Band Width when burst.burstsize : Specify burst size[kbytes].

Chapter 2. Command for Setup

181 SigmaSystemCenter 3.5 ssc Command Reference

Page 192: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Specify a limit, burstlimit or burstsize value,to specify the presence of Network Band Control.You cannot omit.Specify 0 for limit, burstlimit or burstsize value,to specify unrestrictedly.You cannot omit.Not specify a limit, burstlimit or burstsize value,to disable Network Band Control.

[-systemdisk size=value[type=<thin | thick>][independent][datastoretag=value |datastore] [share=value][reservation=value][limit=value]]

Set the system disk information.size : Specify the size of a system disk in megabytes (MB).type : Specify the type of a system disk.Specify either thin or thick.Optional. The default type is thick.independent : A disk is set to the Independent mode by specifying "independent"for this option.The Independent mode is only enabled in the VMware environment.datastore : Specify the datastore name of the system disk.datastoretag : Specify the datastore tag of the system disk.Specify either datastore or datastoretag. Optional.share: Specify a disk shared value.Disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V you cannot specify.Xen you cannot specify.KVM you cannot specify.Specify one of the following values."h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify a disk reservation value(IOPS).Specify a value in the range of 0-2147483647.The reservation is only enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment(IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-extdisk size=value[ctrl=value [position=value]]

Set the extended disk information (You can specify multiple items).When you specify multiple items, separate the data with commas (","). (Max 6)

Chapter 2. Command for Setup

182 SigmaSystemCenter 3.5 ssc Command Reference

Page 193: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[type=<thin | thick | rdm-p |rdm-v>][independent][datastoretag=value |datastore][lun] [share=value][reservation=value][limit=value], ...]

size : Specify disk size (MB)Specify a value in the range of the number from 10 to 99999999 (MB).When Disk Type is specified 'rdm-p' or 'rdm-v',specify a value in the range of the number from 1 to 10000000 (GB) and a multipleof the LUN size range (default value is 10).ctrl : Specify the controller on which an extended disk is connected.Specify the following valuePCIxIDExSCSIxSATAxAutoDetect (auto detection)x:Bus numberposition : Specify the position where an extended disk is connected.You can specify the following valuePCI: 0 - 31IDE: 0 - 1SCSI: 0 - 63SATA: 0 - 29When 'ctrl' is 'AutoDetect', it can't be specified.The value which can be specified to the controller and positiondiffers depending on your virtualization infrastructures.To check available values, refer to the "1.1.8 Controllers and Location Data forEach Virtualization Infrastructure Product (page 19)".type : Specify the type of an extended disk.Specify one of thin / thick / rdm-p / rdm-v.Optional. The default type is thick.rdm-p: RDM (physical)rdm-v: RDM (virtual)independent : The independent mode of a disk is configuredby specifying it as "independent."The Independent mode is only enabled in the VMware environment.When you specify the disk type is RDM (physical), you cannot specifythe mode of Independent.*If type = thick or thindatastoretag : Specify the datastore tag of the extended disk.datastore : Specify the datastore name of the extended disk.Specify either datastore or datastoretag.Optional.If omitted, the extended disk is created in the same locationwith the system disk by default.*If type = rdm-p / rdm-vlun : Specify the target LUN (Tag).share: Specify a disk shared value.Disk shared value settings for each virtualization infrastructureare as follows:VMware Setting

Chapter 2. Command for Setup

183 SigmaSystemCenter 3.5 ssc Command Reference

Page 194: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Hyper-V you cannot specify.Xen you cannot specify.KVM you cannot specify.Specify one of the following values."h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify a disk reservation value(IOPS).Specify a value in the range of 0-2147483647.The reservation is only enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment(IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-delete [cost | cpu | mem |vnet | systemdisk | extdisk]]

Deletes the setting information.If you specify the option name, the setting information of that option is deleted.Execute this option separating from other options.If any option name is not specified, the profile itself is deleted

[Note]

• If you specify the -cpu option, the -mem option, the -systemdisk option and the -extdisk option,be sure to specify all contents of setting of those options.

[Syntax examples]

>ssc profile create Large -cost 100>ssc profile create Middle -cpu count=2 share=h>ssc profile create Small -cpu count=2 share=600 -mem size=1024 -vnet "VM Network">ssc profile create PrivateProfile1 -private -cpu count=1 share=n -mem size=2048>ssc profile create GyomuProfile1 -private Gyomu -systemdisk type=thin Storage1 -extdisk size=10240 ctrl=IDE1 position=0 type=thin, size=100 ctrl=AutoDetect type=rdm-v >ssc profile create Large -delete>ssc profile create Small -delete cpu

2.17.8 Displaying the Machine ProfileDisplays the machine profile.

Chapter 2. Command for Setup

184 SigmaSystemCenter 3.5 ssc Command Reference

Page 195: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc profile show Path [-host HostName | -named] [-type <standard | network | storage | all>] [-vertical]

[Parameters and Options]

Path(Required)

Specify the full path of the group/model/host or of the the virtual machine.Displays the setting machine profile when you specify the path to the operation group, model orhost.You can omit View Type ("operations:/").You cannot specify a tenant or a category.Specified the name when you specify the named machine profile.E.g.:When specifying a group name:Category/GroupWhen specifying a model name:Category/Group/ModelWhen specifying a host name:Category/Group/HostWhen specifying a host name (When specifying view type):operations:/Category/Group/HostWhen specifying named machine profileProfileNameWhen you specify the target virtual machine, its machine profile is displayed.You can omit View Type ("operations:/").When view type is omitted, it is treated as path of Operations view.E.g.:virtual:/VC1/DataCenter1/Host1/VM1resource:/Virtual/VM1operations:/Category/Group/Model1/VM1

[-hostHostName]

Specify the host name of the target.If you specify this option, specify the operation group for Path.Specify this option if there is a model with the same name as the target host.

[-named] Specify -name, when displaying the named machine profile.Specify a name of named machine profile to Path.You cannot specify this option along with -host.

[-type <standard| network |storage | all>]

Specify the display type.standard: CPU and Memory informationnetwork: Network informationstorage: Storage informationall: all of machine profile information(standard | network | storage)When you can omit, type is 'standard'

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

Chapter 2. Command for Setup

185 SigmaSystemCenter 3.5 ssc Command Reference

Page 196: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc profile show Category/Group >ssc profile show Category/Group/Model -type standard >ssc profile show Category/Group/Host -type network >ssc profile show Category/Group -type storage >ssc profile show Category/Group -type all >ssc profile show operations:/Category/Group/Host -type all -vertical

2.17.9 Exporting Monitoring ProfileExport "monitoring profile(s)."

[Syntax]

ssc monitoringprofile export OutputFolder [-file FileName]

[Parameters and Options]

OutputFolder Specify a directory for the output.

[-file FileName] Specify an output file name.If omitted, the following format is used.For example: When you output the file at 12:34:56, November 22, 2016.           monitoringprofile-20161122123456.xml

[Syntax examples]

>ssc monitoringprofile export "c:\temp" >ssc monitoringprofile export "c:\temp" -file "monitoringprofile.xml"

2.17.10 Importing Monitoring ProfileImport "monitoring profile(s)."

[Syntax]

ssc monitoringprofile import FileName [-overwrite]

[Parameters and Options]

FileName Specify a file name in which "monitoring profile(s)" is registered.

[-overwrite] When the registered profile(s) already exist:(1) with this option, the profile(s) is overwritten;(2) without this option, the profile(s) is not imported.

[Note]

The following are the result messages of the command with/without the [-overwrite] option when theregistered profile(s) already exist:

* The following profile(s) is not imported because it already exists.

ProfileName: Profile1, Profile2, Profile3

* The following profile(s) is overwritten because it already exists.

ProfileName: Profile1, Profile2, Profile3

[Syntax examples]

>ssc monitoringprofile import "C:\Temp\monitoringprofile-yyyyMMddHHmmss.xml"

Chapter 2. Command for Setup

186 SigmaSystemCenter 3.5 ssc Command Reference

Page 197: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc monitoringprofile import "C:\Temp\monitoringprofile-yyyyMMddHHmmss.xml" -overwrite

2.17.11 Adding Threshold Setting to a Performance IndicatorAdds a threshold setting to the performance indicator.

[Syntax]

ssc monitoringprofile add-threshold ProfileName <perfinfoname=Value | perfinfoid=Value>

type=Value thresholdvalue=Value consecutiveperiod=Value

[target=Value] [method=Value] [exceededevent=<Event | ?>] [recoverevent=<Event | ?>]

[enable=<true | false>] [renotify=<true | false>]

[Parameters and Options]

ProfileName(Required)

Specify the name of a monitoring profile.

<perfinfoname=Value |perfinfoid=Value>(Required)

Specify a performance indicator. perfinfoname: Specify the name of the performance indicator. perfinfoid : Specify the metric ID of the performance indicator.For possible values, refer to "1.1.7. Performance Data and Metric IDs."

type=Value(Required)

Specify the type of a monitoring threshold. 0: Lower Warning Value Monitor 1: Lower Error Value Monitor 2: Upper Warning Value Monitor 3: Upper Error Value Monitor

thresholdvalue=Value(Required)

Specify a threshold.Specify a value in the range of 0 to 999999999999999999999999999999 (30 digit).

consecutiveperiod=Value(Required)

Specify a consecutive monitoring period for performance data.Specify the consecutive period within the following: consecutive period / collect interval ≦ 1000

[target=Value] Specify the type of a monitoring target. 0: Machine 1: GroupIf you omit this option, "Machine" is specified.

[method=Value] Specify a statistics method. 0: Maximum Value 2: Average Value 4: Minimum Value 6: Summation ValueIf you omit this option, the "Average Value" is specified.

[exceededevent=<Event | ?>] Specify an event name or the event ID which is notified to SigmaSystemCenterwhen detecting an unusual state.When specifying "?," available values are displayed.If you omit this option, "Do Nothing" is specified.

[recoverevent=<Event | ?>] Specify an event name or the event ID which is notified to SigmaSystemCenterwhen recovering from an unusual state.

Chapter 2. Command for Setup

187 SigmaSystemCenter 3.5 ssc Command Reference

Page 198: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When specifying "?," available values are displayed.If you omit this option, "Do Nothing" is specified.

[enable=<true | false>] Specify enable or disable for the threshold setting.If you omit this option, "true" is specified.

[renotify=<true | false>] Specify whether re-notify or not when the unusual state is continued even after thespecified consecutive period is passed since the first notification.If you omit this option, "true" is specified.

[Syntax examples]

>ssc monitoringprofile add-threshold "VM Monitoring Profile (30min)" perfinfoname="CPU Usage(%)" type=2 thresholdvalue=80 consecutiveperiod=30 target=0 method=2 exceededevent=? recoverevent=?>ssc monitoringprofile add-threshold "VM Monitoring Profile (30min)" perfinfoid=1 type=3 thresholdvalue=80 consecutiveperiod=30 method=0 exceededevent=? recoverevent=? -notrenotify>ssc monitoringprofile add-threshold "VM Monitoring Profile (30min)" perfinfoname="CPU Usage(%)" type=2 thresholdvalue=80 consecutiveperiod=30 -disable -notrenotify

2.17.12 Updating Threshold Setting of the PerformanceIndicator

Updates the threshold setting of a performance indicator.

[Syntax]

ssc monitoringprofile update-threshold ProfileName <perfinfoname=Value | perfinfoid=Value>

type=Value target=Value method=Value

[thresholdvalue=Value] [consecutiveperiod=Value]

[exceededevent=<Event | none | ?>] [recoverevent=<Event | none | ?>]

[enable=<true | false>] [renotify=<true | false>]

[Parameters and Options]

ProfileName(Required)

Specify the name of a monitoring profile.

<perfinfoname=Value |perfinfoid=Value>(Required)

Specify a performance indicator. perfinfoname: Specify the name of the performance indicator. perfinfoid : Specify the metric ID of the performance indicator.For possible values, refer to "1.1.7. Performance Data and Metric IDs."

type=Value(Required)

Specify the type of a monitoring threshold. 0: Lower Warning Value Monitor 1: Lower Error Value Monitor 2: Upper Warning Value Monitor 3: Upper Error Value Monitor

target=Value(Required)

Specify the type of a monitoring target. 0: Machine 1: Group

method=Value Specify a statistics method.

Chapter 2. Command for Setup

188 SigmaSystemCenter 3.5 ssc Command Reference

Page 199: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required)  0: Maximum Value 2: Average Value 4: Minimum Value 6: Summation Value

[thresholdvalue=Value] Specify a threshold.Specify a value in the range of 0 to 999999999999999999999999999999 (30digit).

[consecutiveperiod=Value] Specify a consecutive monitoring period for performance data.Specify the consecutive period within the following: consecutive period / collect interval ≦ 1000

[exceededevent=<Event | none| ?>]

Specify an event name or the event ID which is notified to SigmaSystemCenterwhen detecting an unusual state.When specifying "none," "Do Nothing" is specified.When specifying "?," available values are displayed.

[recoverevent=<Event | none | ?>]

Specify an event name or the event ID which is notified to SigmaSystemCenterwhen recovering from an unusual state.When specifying "none," "Do Nothing" is specified.When specifying "?," available values are displayed.

[enable=<true | false>] Specify enable or disable for a threshold setting.

[renotify=<true | false>] Specify whether re-notify or not when the unusual state is continued even afterthe specified consecutive period is passed since the first notification.

[Syntax examples]

>ssc monitoringprofile update-threshold "VM Monitoring Profile (30min)" perfinfoname="CPU Usage(%)" type=2 targetType=0 method=2 thresholdValue=60>ssc monitoringprofile update-threshold "VM Monitoring Profile (30min)" perfinfoid=1 type=3 targetType=1 method=0 exceededevent=? recoverevent=? renotify=true>ssc monitoringprofile update-threshold "VM Monitoring Profile (30min)" perfinfoname="CPU Usage(%)" type=2 targetType=0 method=2 enable=false

2.17.13 Deleting Threshold Setting from the PerformanceIndicator

Deletes a threshold setting from a performance indicator.

[Syntax]

ssc monitoringprofile delete-threshold ProfileName <perfinfoname=Value | perfinfoid=Value>

type=Value target=Value method=Value

[Parameters and Options]

ProfileName(Required)

Specify the name of a monitoring profile.

<perfinfoname=Value | perfinfoid=Value>(Required)

Specify a performance indicator. perfinfoname: Specify the name of the performance indicator. perfinfoid : Specify the metric ID of the performance indicator.For possible values, refer to "1.1.7. Performance Data and Metric IDs."

type=Value Specify the type of a monitoring threshold.

Chapter 2. Command for Setup

189 SigmaSystemCenter 3.5 ssc Command Reference

Page 200: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required)  0: Lower Warning Value Monitor 1: Lower Error Value Monitor 2: Upper Warning Value Monitor 3: Upper Error Value Monitor

target=Value(Required)

Specify a type of a monitoring target. 0: Machine 1: Group

method=Value(Required)

Specify a statistics method. 0: Maximum Value 2: Average Value 4: Minimum Value 6: Summation Value

[Syntax examples]

>ssc monitoringprofile delete-threshold "VM Monitoring Profile (30min)" perfinfoid=1 type=3 target=0 method=2>ssc monitoringprofile delete-threshold "VM Monitoring Profile (30min)" perfinfoname="CPU Usage(%)" type=0 target=1 method=4

2.18 API Key2.18.1 Creating API Key

Creates a user account and API key.

[Syntax]

ssc apikey create UserName [-description Description]

[Parameters and Options]

UserName(Required)

Specify an API user name.You can enter up to 32 characters of any kind,except the following symbols:* + , / : ; < = > ? \ | [ ]

-description Description Enter a description of the API user.You can enter up to 128 characters.

[Syntax examples]

>ssc apikey create MyApp >ssc apikey create MyApp2 -description "My Application2 API key"

[Note]

• An API user will be created as an administrator user.

• An API key is generated automatically.

2.18.2 Updating API KeyUpdates a user account and API key.

Chapter 2. Command for Setup

190 SigmaSystemCenter 3.5 ssc Command Reference

Page 201: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc apikey update UserName [-description Description]

[Parameters and Options]

UserName(Required)

Specify an API user name to update API key.If you update the API key, you cannot use the old API key.

-description Description Enter a description of the API user.You can enter up to 128 characters.

[Syntax examples]

>ssc apikey update MyApp -description "My Application API key" >ssc apikey update MyApp2

2.18.3 Deleting API KeyDeletes a user account and API key.

[Syntax]

ssc apikey delete UserName

[Parameters and Options]

UserName(Required)

Specify an API user name of a target user account.

[Syntax examples]

>ssc apikey delete MyApp

2.18.4 Displaying API KeyDisplays User Account information and API key.

[Syntax]

ssc apikey show [UserName]

[Parameters and Options]

UserName Specify an API user name to display.When omitted, all API users are displayed.

[Syntax examples]

>ssc apikey show#UserName,AccessKeyId,Description"MyApp","NVG8YlfiP3rKbgbwjmK6/EqTAsh5bTqJXSaELekTjuo=","My Application API user""MyApp2","Ch2Np96lhjSH6spJz2R6nB6JE/eXw4sjS23ZI00T0VU=","My Application2 API user"

>ssc apikey show MyAppUserName : MyAppDescription : My Application API user

Chapter 2. Command for Setup

191 SigmaSystemCenter 3.5 ssc Command Reference

Page 202: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

AccessKeyId : NVG8YlfiP3rKbgbwjmK6/EqTAsh5bTqJXSaELekTjuo=SecretAccessKey : hMn7iZAM55p7Ta1lUikrnyp1nX1VY0xVYEZX9JPHQ0k=

2.19 Custom Setting2.19.1 Creating Custom Setting

Adds the custom setting.

[Syntax]

ssc customproperty add Type Target [-host HostName] [-vmserver VMServerPath] <-property NameValue | -construction>

[Parameters and Options]

Type(Required)

Specify the type of the target.group: Operation Grouphost: Hostmachineprofile: Machine Profile of Operation Group, Model, or Hostnamedmachineprofile: Named Machine Profiletemplate: Templatemachine: Machine

Target(Required)

Specify the target path or UUID to add the custom setting.You can omit View Type when you specify the path.E.g. Operation Group  Tenant/Category/Group Model  Tenant/Category/Group/Model Host  Tenant/Category/Group/Host Named Machine Profile  MachineProfile Template  Template Machine  Group/Machine  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  If you specify the pach of the machine,  specify the path of the Resource view.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Target.Specify this option if there is a model with the same name as the target host.

[-vmserverVMServerPath]

Specify the path of the virtual machine server.E.g. virtual:/VC/DataCenter/VMServer

Chapter 2. Command for Setup

192 SigmaSystemCenter 3.5 ssc Command Reference

Page 203: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 VC/DataCenter/VMServer You can omit View Type(virtual:/).Specify this option if multiple templates with the same name exsist for the target template.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

-property NameValue

Specify the name and value. Name:Specify the name.  Up to 256 characters are available.  If Type is "group", "host", or "machine", available characters are as follows:  alphabetic characters, numerals, and an underscore (_).  But you cannot specify the character string beginning with "PVM_" or numerals.  If Type is "machineProfile", "namedmachineprofile", or "template", available charactersare as follows:  alphabetic characters, numerals, and symbols. Value:Specify the value.  Up to 256 characters are available.  If Type is "machineProfile", "namedmachineprofile", or "template", available charactersare as follows:  alphabetic characters, numerals, and symbols.

-construction Specify this option if Construction Parameter Setting is turned ON.You can specify this option when "machineProfile" is specified in Type.

[Syntax examples]

>ssc customproperty add machine Group/Machine -property WWN 20:00:00:00:C9:56:C0:99:10:00:00:00:C9:56:C0:99 >ssc customproperty add host Category/Group -host Host -property WWN 20:00:00:00:C9:56:C0:99:10:00:00:00:C9:56:C0:99 >ssc customproperty add machineprofile Category/Group/Model -property vm.vcpu.core 2 >ssc customproperty add machineprofile Category/Group -host Host -construction

2.19.2 Deleting Custom SettingDeletes the custom setting.

[Syntax]

ssc customproperty delete Type Target [-host HostName]

  [-vmserver VMServerPath] <-property Name... | -all | -construction>

[Parameters and Options]

Type(Required)

Specify the type of the target.group: Operation Grouphost: Hostmachineprofile: Machine Profile of Operation Group, Model, or Hostnamedmachineprofile: Named Machine Profiletemplate: Templatemachine: Machine

Target Specify the target path or UUID to delete the custom setting.

Chapter 2. Command for Setup

193 SigmaSystemCenter 3.5 ssc Command Reference

Page 204: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required) You can omit View Type when you specify the path.E.g. Operation Group  Tenant/Category/Group Model  Tenant/Category/Group/Model Host  Tenant/Category/Group/Host Named Machine Profile  MachineProfile Template  Template Machine  Group/Machine  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  If you specify the pach of the machine,  specify the path of the Resource view.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Target.Specify this option if there is a model with the same name as the target host.

[-vmserverVMServerPath]

Specify the path of the virtual machine server.E.g. virtual:/VC/DataCenter/VMServer VC/DataCenter/VMServer You can omit View Type(virtual:/).Specify this option if multiple templates with the same name exsist for the target template.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

-property Name... Specify the name (You can specify multiple names).

-all Specify this option if you delete all properties.

-construction Specify this option if Constitutive Parameter Setting is turned OFF and you delete allproperties.You can specify this option when "machineProfile" is specified in Type.

[Syntax examples]

>ssc customproperty delete group Tenant/Category/Group -property tenant >ssc customproperty delete host Tenant/Category/Group -host host -all >ssc customproperty delete machineprofile Tenant/Category/Group/Model -construction >ssc customproperty delete namedmachineprofile MachineProfile -property vm.vcpu.core >ssc customproperty delete template Template -vmserver VC/DataCenter/VMServer -all

Chapter 2. Command for Setup

194 SigmaSystemCenter 3.5 ssc Command Reference

Page 205: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc customproperty delete machine Group/Machine -property WWN

2.19.3 Displaying Custom SettingShows the custom setting.

[Syntax]

ssc customproperty show Type Target [-host HostName] [-vmserver VMServerPath]

[Parameters and Options]

Type(Required)

Specify the type of the target.group: Operation Grouphost: Hostmachineprofile: Machine Profile of Operation Group, Model, or Hostnamedmachineprofile: Named Machine Profiletemplate: Templatemachine: Machine

Target(Required)

Specify the target path or UUID to show the custom setting.You can omit View Type when you specify the path.E.g. Operation Group  Tenant/Category/Group Model  Tenant/Category/Group/Model Host  Tenant/Category/Group/Host Named Machine Profile  MachineProfile Template  Template Machine  Group/Machine  xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx  If you specify the pach of the machine,  specify the path of the Resource view.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Target.Specify this option if there is a model with the same name as the target host.

[-vmserverVMServerPath]

Specify the path of the virtual machine server.E.g. virtual:/VC/DataCenter/VMServer VC/DataCenter/VMServer You can omit View Type(virtual:/).Specify this option if multiple templates with the same name exsist for the target template.

Chapter 2. Command for Setup

195 SigmaSystemCenter 3.5 ssc Command Reference

Page 206: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[Syntax examples]

>ssc customproperty show machine Group/Machine

[Display examples]

>ssc customproperty show machine Group/Machine #PropertyName,Value "WWN","10:00:00:00:C9:56:C0:99"

2.20 CIM Indication Setting2.20.1 Registering CIM Indication Setting

Registers settings for receiving CIM Indication.

[Syntax]

ssc indication register filter

[Parameters and Options]

No parameters or options.

[Syntax examples]

>ssc indication register filter

2.20.2 Unregistering CIM Indication SettingUnregisters settings for receiving CIM Indication.

[Syntax]

ssc indication unregister filter [ManagementTargetAddress]

[Parameters and Options]

ManagementTargetAddress Unregister settings for receiving CIM Indication from the specified managementtarget. Specify the Addresss value under the ManagementTarget Tag that described inthe Event Definition File.

[Syntax examples]

>ssc indication unregister filter >ssc indication unregister filter http://172.16.0.69:5988/

2.21 Custom Object2.21.1 Adding Custom Object

Creates custom objects.

[Syntax]

Chapter 2. Command for Setup

196 SigmaSystemCenter 3.5 ssc Command Reference

Page 207: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc create object Filepath [-name Name] [-id Identifier]

[Parameters and Options]

Filepath(Required)

Specify an xml file path.

[-name Name] Specify the name of a custom object.If omitted, the name of the setting in the xml file is used.

[-id Identifier] Specifiy the identifier of a custom object.If omitted, the identifier of the setting in the xml file is used.

2.21.2 Updating Custom ObjectChange the setting of a custom object, network device and a storage device.

[Syntax]

ssc update object Name [-id Identifier] [-policy [PolicyName...]] [-name NewName] [-xml FilePath [-force]]

[-type <networkdevice | diskarray | customobject>]

[Parameters and Options]

Name(Required)

Specity a target name.

[-id Identifier] Specity a identifier (IP address).

[-policy [PolicyName...]] Specity a policies name.Five parameters can be specified.Only a specified policies are set.To release a specified policy(s), omit PolicyName.

[-name NewName] Specify a name only when the "-type" option is "customobject".

[-xml FilePath [-force]] Specify a custom object definition file only when the "-type" option is "customobject".This option updates the product name, the policy#1, and the node by using the contentsof the productname tag, the policy tag, and the node tag in the custom object definitionfile.

The "-force" option updates the product name and the policy#1 by using the contents ofthe productname tag and the policy tag even when these are already exist in the customobject specified in "Name." The node of this custom object is deleted if the node doesnot exist in the node tag.

[-type <networkdevice |diskarray |customobject>]

Specify the type of the target.If omitted, "customobject" is specified. "networkdevice": physical switch "diskarray": disk array "customobject": custom object

[Syntax examples]

>ssc update object Name -id 192.168.1.201 >ssc update object Name -id 192.168.1.202 -type diskarray >ssc update object Name -policy NetworkPolicy -type networkdevice >ssc update object Name -id 192.168.1.203 -policy CustonObjectPolicy -type customobject

Chapter 2. Command for Setup

197 SigmaSystemCenter 3.5 ssc Command Reference

Page 208: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

2.21.3 Deleting Custom ObjectDeletes custom objects.

[Syntax]

ssc delete object -name Name

[Parameters and Options]

-name Name(Required)

Specify the name of a deleting custom object.

2.21.4 Displaying Custom ObjectDisplays custom objects.

[Syntax]

ssc show object [-name Name] [-type <base | policy | relation | node | all> ] [-vertical]

[Parameters and Options]

[-name Name] Specify the name of a custom object.If omitted, the basic information of all custom objects is displayed.

[-type <base | policy | relation |node | all> ]

Specify displaying information.base: Display basic information.policy: Display policies.relation: Display relationship.node: Display nodes.all: Display all information.If omitted, the basic information of all custom objects is displayed.

[-vertical] Changes the format. -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

> ssc show object -name OBJECT -type all#Name,Type,Identifier,ProductName,SummaryStatus,HardwareStatus"OBJECT","Switch","192.168.1.1","OBJECT NAME","Normal","Normal"#Name"Policy01"#Direction,Object,Type"forward ","OBJECT2","rack""both","OBJECT3","object"#Node,Direction,Object,Type"ethernet1","forward","OBJECT4","rack"

2.21.5 Adding RelateAdd the relation between a custom object and the object of a target resource.

[Syntax]

ssc add-relate object CustomObjectPath -dest DestObjectKeyword

<machine | rack | switch | diskarray | customobject> [-dir <forward | backward | both | non>]

Chapter 2. Command for Setup

198 SigmaSystemCenter 3.5 ssc Command Reference

Page 209: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

CustomObjectPath(Required)

Specity a custom object name.When a custom object node is specified, specify the path of the custom objectnode.E.g.) CustomObjectName/NodeName

-dest DestObjectKeyword<machine | rack | diskarray |switch | customobject>(Required)

Specity a target resource.DestObjectKeyword: Specify the keyword which searches for a target resoource.When the switch's port or disk array's port or custom object node is specified,specify the path of target.E.g.) Switch/PortSpecify a target type. machine: Machine rack: Rack switch: Physical switch diskarray: Disk array customobject: Custom object

[-dir <forward | backward | both| non>]

Specify the direction of relate.If omitted, "non" is set.forward: The custom object send notice to the relation destination.backward: The custom object receives notice from the relation destination.both: forward + backwardnon: Not exchanged with the relation destination.

[Note]

A DestObjectKeyword content changes by a specified ModelName.

Details is indicated on the following table.

ModelName DestObjectKeyword

machine UUID of machine

rack Name of rack

switch Name of network devicve or path of port

diskarray Name of disk array or path of port

customobject Name of custom object or path of custom object node

[Syntax examples]

>ssc add-relate object UPS001 -dest 00B9771D-29BB-DB11-8001-003013B8F50D machine -dir forward >ssc add-relate object UPS001 -dest Rack1 rack >ssc add-relate object NECRouter/Ethrenet0/3 -dest QX-S5828T/GigabitEthernet0/1 switch -dir backward >ssc add-relate object UPS001 -dest DiskArray02 diskarray >ssc add-relate object NECSwitch/Ethrenet0/11 -dest NECRouter/Ethrenet0/3 customobject -dir both

2.21.6 Deleting RelateDelete the relation between a custom object and the object of a target resource.

Chapter 2. Command for Setup

199 SigmaSystemCenter 3.5 ssc Command Reference

Page 210: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc delete-relate object CustomObjectPath -dest DestObjectKeyword

<machine | rack | switch | diskarray | customobject>

[Parameters and Options]

CustomObjectPath(Required)

Specity a custom object name.When a custom object node is specified, specify the path of the custom objectnode.E.g.) CustomObjectName/NodeName

-dest DestObjectKeyword<machine | rack | diskarray |switch | customobject>(Required)

Specity a target resource.DestObjectKeyword: Specify the keyword which searches for a target resource.When the switch's port or disk array's port or custom object node is specified,specify the path of target.E.g.) Switch/PortSpecify a target type. machine: Machine rack: Rack switch: Physical switch diskarray: Disk array customobject: Custom object

[Note]

A DestObjectKeyword content changes by a specified ModelName.

Details is indicated on the following table.

ModelName DestObjectKeyword

machine UUID of machine

rack Name of rack

switch Name of physical switch or path of port

diskarray Name of disk array or path of port

customobject Name of custom object or path of custom object node

[Syntax examples]

>ssc delete-relate object UPS001 -dest 00B9771D-29BB-DB11-8001-003013B8F50D machine >ssc delete-relate object UPS001 -dest Rack1 rack >ssc delete-relate object NECRouter/Ethrenet0/3 -dest QX-S5828T/GigabitEthernet0/1 switch >ssc delete-relate object UPS001 -dest DiskArray02 diskarray >ssc delete-relate object NECSwitch/Ethrenet0/11 -dest NECRouter/Ethrenet0/3 customobject

2.22 External Resource2.22.1 Adding External Resource

Assigns a resource according to an external resource structure.

Chapter 2. Command for Setup

200 SigmaSystemCenter 3.5 ssc Command Reference

Page 211: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc assign external-resource -type Type [-s]

[Parameters and Options]

-type Type Specify the resource type for an assignment.- necci : The resource configuration information of NEC Cloud IaaS is assigned.

[-s] The stopped machine is added to the assignment target.

[Syntax examples]

>ssc assign external-resource -type necci>ssc assign external-resource -type necci -s

Chapter 2. Command for Setup

201 SigmaSystemCenter 3.5 ssc Command Reference

Page 212: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Chapter 3. Command for Controlling

Contents3.1 Operations for Datacenter ........................................................................................................203

3.2 Operations for Virtual Machine Server.....................................................................................203

3.3 Operations for Virtual Machine ................................................................................................208

3.4 VM Placement Rule .................................................................................................................242

3.5 Datastore..................................................................................................................................250

3.6 Resource Pool .........................................................................................................................258

3.7 Placement Information .............................................................................................................263

3.8 Service .....................................................................................................................................267

Chapter 3. Command for Controlling

202 SigmaSystemCenter 3.5 ssc Command Reference

Page 213: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This chapter explains commands regarding the configuration control of the virtual environment thatcan be managed in SigmaSystemCenter.

3.1 Operations for Datacenter3.1.1 Adding Datacenter

Adds a data center to a virtual manager.

[Syntax]

ssc datacenter add VirtualManager DataCenterName [-description Description]

[Parameters and Options]

VirtualManager Specify the name or IP address of a virtual manager.

DataCenterName Specify a data centers name.Specify it within 80 characters.Available characters are as follows: Alphabetic characters, numerals, spaces, hyphens(-), and underscores (_).

[-description Description] Specify a description.Specify it within 255 characters.

[Syntax examples]

>ssc datacenter add EsxServer01 DC >ssc datacenter add 192.168.1.101 DC -description "test server"

3.2 Operations for Virtual Machine Server3.2.1 Adding Virtual Machine Server

Adds a virtual machine server in a datacenter.

[Syntax]

ssc add vmserver Datacenter [-name HostName] [-url URL] [-port PortNumber] [-account Account][-p Password]

[Parameters and Options]

Datacenter(Required)

Specify a datacenter to which you intend to add a virtual machine server.Specify a full path to the datacenter.

[-name HostName] Specify a host name or IP address.

[-url URL] Specify a URL of the target.If you specify HostName, a URL is automatically generated, and you do not need to specifythis item.

[-port PortNumber] Specify a port number. You can specify from 1 to 65535. If you do not specify a port number,"443" is specified.

[-account Account] Specify an account name.

[-p Password] Specify a password.

Chapter 3. Command for Controlling

203 SigmaSystemCenter 3.5 ssc Command Reference

Page 214: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Note]

• If you specify a KVM in datacenter, -url option is enabled.

[Syntax examples]

>ssc add vmserver 192.168.10.1/Datacenter1 -name VMServer-01 >ssc add vmserver 192.168.10.1/Datacenter1 -name 192.168.10.100 >ssc add vmserver 192.168.10.1/Datacenter1 -name 192.168.10.101 -port 443 -account user01 -p xxxxx >ssc add vmserver /KVM/DefaultDataCenter -url "qemu+tls://server.test.net:5000/system"

3.2.2 Updating Virtual Machine ServerEdits the capacity value of a virtual machine server.

[Syntax]

ssc update vmserver VMServer -capacity Value

[Parameters and Options]

VMServer Specify the path of a virtual machine server.E.g. virtual:/VC/DataCenter/VMServer (You can omit View Type ("virtual:/").About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

-capacity Value Specify a capacity value in the range of 1 to 100000.

[Syntax examples]

>ssc update vmserve virtual:/VC/DataCenter/VMServer -capacity 500

3.2.3 Deleting Virtual Machine ServerDeletes a virtual machine server from a datacenter.

[Syntax]

ssc delete vmserver Datacenter VMServerName [...]

[Parameters and Options]

Datacenter(Required)

Specify a datacenter from which you intend to delete a virtual machine server.Specify a full path to the datacenter.

VMServerName [...](Required)

Specify a target virtual machine server name.

[Syntax examples]

>ssc delete vmserver 192.168.10.1/Datacenter1 VMServer-01 >ssc delete vmserver 192.168.10.1/Datacenter1 192.168.10.100 192.168.10.101

Chapter 3. Command for Controlling

204 SigmaSystemCenter 3.5 ssc Command Reference

Page 215: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.2.4 Changing Password of Virtual Machine ServerChanges a password of a user account or VM server.

[Syntax]

ssc change-passwd Type Name NewPassword [-l Account] [-p Password]

[Parameters and Options]

Type(Required)

Specify the target type to be changed its password:"manager": Specify in the case of changing a password of a VM server."user": Specify in the case of changing a password of a user account.

Name(Required)

Specify the target name.Specify the host name or the full path of the target virtual machine server if "manager" is specifiedin Type.(E.g.: VirtualCenter/DataCenter/ESX)If the same host name exists, specify the host with its path.Specify a user name when "user" is specified in Type.

NewPassword(Required)

Specify a new password.

[-l Account] Specify the account name.Specify the account name of the VM Server when "manager" is specified in Type. If you do notspecify it, the account name is not changed.Specify an administrator user name when "user" is specified in Type.If you do not specify it, specify an old password in the -p option as authentication information.

[-p Password] You can specify this option when "user" is specified in Type.Specify an administrator user password if the -l option is specified.Specify an old password of target user if the -l option is not specified.

[Syntax examples]

Changes a password of VM server. >ssc change-passwd manager Host1 "*****" -l user1 >ssc change-passwd manager "VirtualCenter/New DataCenter/Esx1" "****"

Change a password of a user. 1) Authentication is old password of user. >ssc change-passwd user user1 "****" -p "****"

2) Authentication is administrator user account. >ssc change-passwd user user2 "****" -l Administrator -p "****"

3.2.5 Post-Processing of Virtual Machine Server RecoveryExecutes post-processing of recovery process (Failover) of virtual machine server.

This command is available only for a standalone ESXi whose Connection Status is

"Disconnected".

[Syntax]

ssc recover machine SourceName

Chapter 3. Command for Controlling

205 SigmaSystemCenter 3.5 ssc Command Reference

Page 216: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

SourceName(Required)

Specify a target virtual machine server name from its belonging view in a full path.You can specify either of the following items as a view:"operations:/": Operations view"virtual:/": Virtual view(E.g.:operations:/Category/Group/Model/Virtual Machine Server You cannot omit View Type ("operations:/").Orvirtual:/VirtualCenter/Datacenter/Virtual Machine ServerVirtualCenter/Datacenter/Virtual Machine Server You can omit View Type ("virtual:/"). If you omit View Type, the specified path is treated as the path to the Virtual view.)About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[Syntax examples]

>ssc recover machine operation:/Category01/Group01/Model01/VMS001 >ssc recover machine virtual:/192.168.1.100/DC/192.168.1.5 >ssc recover machine 192.168.1.100/DC/192.168.1.5

3.2.6 Evacuating MachineEvacuates virtual machines to other virtual machine servers.

[Syntax]

ssc evacuate machine SourceName [DestinationName] [-all] [-migration] [-move] [-failover] [-q] [-s][-ignorerule] [-reboot]

[Parameters and Options]

SourceName(Required)

Specify the path to a source virtual machine server or a virtual machine to be moved.* Operations view : operation:/Category1/Group1/Model1/VMServer1* Virtual view : virtual:/Manager1/DataCenter1/VMServer1* If the view is not specified (Manager1/DataCenter1/VMServer1), the specified path is treatedas the path to the Virtual view.If a virtual machine server is specified, powered-on virtual machines on the virtual machineserver are moved. (If -all option is specified, all the virtual machines including powered-offones are moved.)If a virtual machine is specified, Failover for the virtual machine is executed.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[DestinationName] Specify the path to a destination virtual machine server.* Operations view : operation:/Category1/Group1/Model1/VMServer1* Virtual view : virtual:/Manager1/DataCenter1/VMServer1* If the view is not specified (Manager1/DataCenter1/VMServer1), the specified path is treatedas the path to the Virtual view.If omitted, destination virtual machine servers are selected automatically.(This cannot be omitted if a virtual machine is specified for SourceName.)

Chapter 3. Command for Controlling

206 SigmaSystemCenter 3.5 ssc Command Reference

Page 217: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-all] If you want to move all the virtual machines (including powered-off ones) on the virtualmachine server, specify this option.If omitted, only powered-on virtual machines are moved.(This option is available only if a virtual machine server is specified for SourceName.)

[-migration] If you want to move virtual machine with Migration method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-move] If you want to move virtual machine with Move method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-failover] If you want to move virtual machine with Failover method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-q] If you want to suspend the virtual machine before it is moved (Quick Migration), specify thisoption. The virtual machine is resumed after it was moved.If omitted, Migration is executed.(This option is available only if a virtual machine server is specified for SourceName.)

[-s] If you specify -move option, the virtual machines is moved by Storage Migration methodreplacing with Move method.(This option is available only if a virtual machine server is specified for SourceName.)

[-ignorerule] If you want to ignore the placement rules when you move the virtual machine, specify thisoption.If omitted, you cannot move the virtual machine against the rules.(This option is available only if a virtual machine is specified for SourceName.)

[-reboot] If you want to reboot machines which is depended to target machines, specify this option.If omitted, these machines will not be rebooted.(This option is available only if a virtual machine server is specified with SourceName.)

[Note]

• If a virtual machine server is specified for SourceName and -move option is not specified,powered-on virtual machines stored in local datastores are not moved. If -move option isspecified, and Powered-off virtual machines are moved even if they are stored in localdatastores. (Their virtual disks are moved to other datastores.)

• If a virtual machine is specified with SourceName, Failover of the virtual machine stored in alocal datastore cannot be executed.

• If a virtual machine server of XenServer Pool Master is specified for SourceName and it isdown, the other virtual machine server which has the largest capacity in the pool becomes a newPool Master.

• If a virtual machine server is specified for SourceName, virtual machines to be moved and theirdestination virtual machine servers are selected automatically by the VM Optimized Placementfeature. (If DestinationName is specified, virtual machines are moved to the specified virtualmachine server.) There are some cases that virtual machines cannot be moved according to thecondition for the VM Optimized Placement feature or placement rules. Refer to NECSigmaSystemCenter Overview Reference Guide "4.7.3. VM Evacuation" and "4.7.4. Conditionsfor VM Optimized Placement" for details.

• If a virtual machine server is specified for SourceName and any move methods are notspecified, assume Migration and Failover methods are specified.

Chapter 3. Command for Controlling

207 SigmaSystemCenter 3.5 ssc Command Reference

Page 218: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc evacuate machine operation:/Category1/Group1/Model1/VM001 virtual:/VC1/DataCenter/VMServer1 >ssc evacuate machine VMServer1 //VC1/DataCenter/VMServer2 -all >ssc evacuate machine //VC1/DataCenter/VMServer3 >ssc evacuate machine //VC1/DataCenter/VMServer3 -q >ssc evacuate machine //VC1/DataCenter/VMServer3 -migration -failover

3.3 Operations for Virtual Machine3.3.1 Creating Virtual Machine

Makes a virtual machine and runs it in a group.

[Syntax]

ssc create machine <GroupName [-host HostName[...]] [-count Count] [-index start=value<end=value | count=value>] [-vmname VMName] [-installmanually] | SmartGroupName> [-vmsVmsName] [-datastore DatastoreName] [-import Type] [-filepath FilePath] [-osname <Name | Code>][-iso IsoFile...]

[Parameters and Options]

GroupName Specify the full path of the target group.E.g:Category/group, group, group/modelOnly categories cannot be specified.

[-host HostName[...]] Specify a host name or IP address of the host to be run.When specifying an IP address, describe it in the xxx.xxx.xxx.xxx form.Set a pre-defined host definition on the destination group to create the host.This option cannot be specified along with -count.If multiple values are specified with this option, -index cannot be specified.

[-count Count] Specify the number of virtual machines that are to be created.This option cannot be specified along with either -index or -host.

[-index start=value<end=value |count=value>]

Specify the start number of the host names of the virtual machines that are to becreated, with the end number or the number of them.This option is disabled if an IP address or multiple values is / are specified with -host.This option is disabled if -count is specified.When both -host and -count are omitted, it becomes the host setting list order.(E.g.) When creating virtual machines from vm001 to vm010.-host vm -index start=001 end=010-host vm -index start=001 count=10(E.g.)When creating hosts from the fifth to the tenth.-index start=5 end=10-index start=5 count=6

[-vmname VMName] Specify the name of the virtual machine.This option is enabled when creating one virtual machine.

Chapter 3. Command for Controlling

208 SigmaSystemCenter 3.5 ssc Command Reference

Page 219: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-installmanually] Specify this option if you want to manually install the OS after creating a virtualmachine.The power is OFF and the maintenance is ON after you created.

SmartGroupName Specify a smart group's path in the Operations view in order to run hosts correspond tothe condition of the specified smart group.Note:* The group path must exist.Setting examples:[category1/group11/smartgroup101]Smartgroup101 below the group11 node of the category1 of the Operations view isspecified.[smartgroup102]smartgroup102 below the operation node of the Operations view is specified.-host, -count, -index, or -vmname cannot be specified together.

[-vms VmsName] Specify the machine name of the destination virtual machine server to create the virtualmachines.

[-datastoreDatastoreName]

Specify the name of the destination datastore.

[-import Type] Specify the type of the file to be imported.

[-filepath FilePath] Specify the path of file that you want to import.When you don't specify the –import option, the file type will be detected automatically.

[-osname Name | Code] Specify the type of the operating system to be installed on the virtual machine.This option is enabled when you specify the –installmanually option.

[-iso IsoFile...] Specify the ISO file to be mounted on the virtual machine.This option is enabled when you specify the –installmanually option.

• Specification of the group is GroupName or SmartGroupName should specify any.

• When GroupName is specified for the group, -host, -count, or -index should specify any.

[Note]

• If a host already used is specified with -index option, an error occurs.

• When specification of the group is SmartGroupName and hosts other than the VM group areincluded, an error occurs.

• When a smart group is specified by this command, and the host extracted in a smart group hasdivided into two or more groups, two or more jobs are generated, then, the jobs are processedsequentially.

When any error occurs in this case, the following jobs are not executed.Please remove the causeof the error, and execute again.

• The following notes were canceled in SSC0300-0002.

- When using the IP address pool function to generate IP addresses, It is not possible tospecify smart group or to omit to input a model name.

[Syntax examples]

>ssc create machine vmgroup1 -host host1 >ssc create machine vmgroup1 -host host1 host2

Chapter 3. Command for Controlling

209 SigmaSystemCenter 3.5 ssc Command Reference

Page 220: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

specified VMS,datastore >ssc create machine vmgroup1 -host host1 -vms vms1 -datastore datastore1 >ssc create machine vmgroup1 -host host1 -datastore datastore1

creates virtual machines of "vm010" from "vm001" >ssc create machine vmgroup1 -host vm -index start=001 end=010 -vms vms1 -datastore datastore1 >ssc create machine vmgroup1 -host vm -index start=001 count=10 -vms vms1 -datastore datastore1

creates virtual machines from the fifth to the tenth with the turn of the list ofhost setting >ssc create machine vmgroup1 -index start=5 end=10 >ssc create machine vmgroup1 -index start=5 count=6

creates a virtual machine by a specified name. >ssc create machine vmgroup1 -host host1 -vmname vm1 -datastore datastore1 >ssc create machine vmgroup1 -count 1 -vmname vm1

specified smart group >ssc create machine category1/group11/smartgroup101

3.3.2 Creating Virtual Machine (no OS)Creates a virtual machine without an operating system.

[Syntax]

ssc vm create -vms VmsName -vmname VMName -cost costValue -cpu count=value [share=value][reservation=value] [limit=value] -mem size=value [share=value] [reservation=value] [limit=value] -systemdisk size=value datastore [type=<thin | thick>] [independent] [share=value][reservation=value] [limit=value] [-osname <Name | Code>] [-vnet VirtualNetworkName...] [-bandcontrol nic=value [type=value] [limit=value burstlimit=value burstsize=value]] [-extdisk[size=value] [ctrl=value [position=value]] [type=<thin | thick | rdm-p | rdm-v>] [independent][datastore] [lun] [share=value] [reservation=value] [limit=value], ...] [-iso IsoFile...] [-propertyname="name" value="value", ...]

[Parameters and Options]

-vms VmsName(Required)

Specify the target virtual machine server in a full path.About specification of a path, refer to "1.1.5 About Path and GroupPathSpecification (page 11)".

-vmname VMName(Required)

Specify the name of the virtual machine.

-cost costValue(Required)

Specify the cost value. Specify a value in the range of 1-1000.

-cpu count=value[[share=value][reservation=value][limit=value]]

Specify the number of CPUs, shared value, reservation value and limit value.The number of CPUs must be specified.You cannot specify leading or trailing spaces in the equal ("=").count: Specify the number of CPUs. Specify a value in the range of 1-9999. (E.g.:count=2)share: Specify the CPU shared value.The CPU shared value settings for each virtualization infrastructure are as follows: VMware Setting * CPU count

Chapter 3. Command for Controlling

210 SigmaSystemCenter 3.5 ssc Command Reference

Page 221: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 Hyper-V Setting / 10 Xen Setting * 256 / 1000 KVM Setting * 1024 / 1000Specify one of the following values:"he": Highest (4000)"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"le": Lowest ( 250)"1" - "99999": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify the CPU allocation value (MHz).Specify a value in the range of 0-99999.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of the CPU resource assignment (MHz).Specify a value in the range of 0-99999.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

-mem size=value[[share=value][reservation=value][limit=value]]

Specify the memory size, the shared value, the reservation value, and the limitvalue.You cannot specify leading or trailing spaces in the equal ("=").size: Specify the memory size (MB).Specify a value in the range of 1-99999999 (MB).(E.g.: size=512)share: Specify the memory shared value.The memory shared value settings for each virtualization infrastructure are asfollows: VMware Setting * the Memory size / 100 Hyper-V Setting * 5 Xen you cannot specify. KVM you cannot specify.Specify one of the following values:"h" : High (2000)"n" : Standard (1000)"l" : Low ( 500)"0" - "10000": Manual(E.g.: share=h, share=100)Optional.The default value is "n".reservation : Specify the memory resource allocation value (MB).Specify a value in the range of 0-99999999.(E.g.: reservation=2048)Optional.

Chapter 3. Command for Controlling

211 SigmaSystemCenter 3.5 ssc Command Reference

Page 222: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The default value is 0.limit : Specify the upper limit of a memory size (MB).Specify a value in the range of 0-99999999.(E.g.: limit=4096)Optional.The default value is 0 (unlimited).

-systemdisk size=valuedatastore[[type=<thin | thick>][independent] [share=value][reservation=value][limit=value]]

Set the system disk information.size : Specify the system disk size (MB).datastore : Specify the datastore name of the system disk.type : Specify the type of system disk.Specify either of thin / thick.Optional. The default type is thick.independent : A disk is set to the Independent mode by specifying "independent" forthis option.The Independent mode is only used in the VMware environment.share: Specify the disk shared value.Disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify the disk reservation value (IOPS).Specify a value in the range of 0-2147483647.The reservation is only used in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment (IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-osname <Name | Code>] Specify the OS name.Specify the code of the OS name or the strings displayed on a Web UI.Refer to "1.1.6 OS Lists and Time zones (page 13)" in this document.

[-vnetVirtualNetworkName...]

Specify the virtual network name.You can specify up to ten names divided by spaces.

Chapter 3. Command for Controlling

212 SigmaSystemCenter 3.5 ssc Command Reference

Page 223: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

NICs are assigned in the specified order from NIC #1.

[-bandcontrol nic=value[type=value] [limit=valueburstlimit=valueburstsize=value]]

Specify the presence of Network Band Control.nic :Specify the NIC number.type : Specify the control type for the virtual NIC.Specify either of in / out.When omitted, the specified type is out.Hyper-V can be set out only.limit : Specify the upper [kbits/s] of Band Width.burstlimit : Specify the upper [kbits/s] of Band Width when burst.burstsize : Specify the burst size [kbytes].Specify the limit, burstlimit, or burstsize valueto specify the presence of Network Band Control.You cannot omit this option.Specify 0 for the limit, burstlimit, or burstsize valueto specify unrestrictedly.You cannot omit this option.Not specify a limit, burstlimit or burstsize value,to disable Network Band Control.

[-extdisk [size=value][ctrl=value [position=value]][type=<thin | thick | rdm-p |rdm-v>][independent][datastore] [lun][share=value][reservation=value][limit=value] , ...]

Set the extended disk information. (You can specify multiple items.)When you specify multiple items, separate the data with commas (","). (Max 6)size : Specify the disk size.Specify a value in the range of 10-99999999 (MB).ctrl : Specify the controller to which an extended disk is connected.Specify the following values:  PCIx  IDEx  SCSIx  SATAx  AutoDetect (auto detection)  x:Bus Numberposition : Specify the position where an extended disk is connected. You can specify the following values:  PCI: 0 - 31  IDE: 0 - 1  SCSI: 0 - 63  SATA: 0 - 29 When 'ctrl' is 'AutoDetect', it cannot be specified.The value which can be specified in the controller and position is differentdepending on the virtual infrastructure.For the possible values, please refer to the manual.type : Specify the type of extended disk.Specify one of thin / thick / rdm-p / rdm-v.Optional. The default type is thick. rdm-p: RDM (physical)  rdm-v: RDM (virtual) independent : A disk is set to the Independent mode by specifying "independent" forthis option.

Chapter 3. Command for Controlling

213 SigmaSystemCenter 3.5 ssc Command Reference

Page 224: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The Independent mode is only used in the VMware environment.When you specify the disk type is RDM (physical), you cannot specify"Independent" for the mode.*If type = thick or thindatastore : Specify the datastore name of the extended disk.*If type = rdm-p / rdm-vlun : Specify the target LUN (LUN Name).share: Specify the disk shared value.The disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify the disk reservation value (IOPS).Specify a value in the range of 0-2147483647.The reservation is only used in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of the disk resource assignment (IOPS).Specify a value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-iso IsoFile...] Specify the ISO file to be mounted on the virtual machine. 

[-property name="name"value="value", ...]

Specify the names and values of the construction parameters for the target virtualmachine. (You can specify multiple items.)When you specify multiple items, separate the data with commas (","). (Max 100)name : Specify the name of the parameter enclosed with double quotation marks.value : Specify the value of the parameter enclosed with double quotation marks.For detailed information about the parameter names and values that can bespecified, refer to "4.3.11. Configuring the Unique Settings to Every VirtualizationInfrastructure (Construction Parameters)" in NEC SigmaSystemCenter OverviewReference Guide.

[Syntax examples]

>ssc vm create -vms virtual:/VC/DataCenter/VMServer -vmname vm -cost 10 -cpu count=2 -mem size=1024 -systemdisk size=4000 datastore -osname 40

Chapter 3. Command for Controlling

214 SigmaSystemCenter 3.5 ssc Command Reference

Page 225: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

-iso "[datastore] ISO/Windows7.iso"

>ssc vm create -vms virtual:/VC/DataCenter/VMServer -vmname vm -cost 10 -cpu count=2 share=h reservation=1000 limit=1500 -mem size=1024 share=h reservation=1024 limit=1024 -systemdisk size=4000 datastore type=thin -osname 40 -vnet "VM Network" -iso "[datastore] ISO/Windows7.iso"

> ssc vm create -vms virtual:/VC/DataCenter/VMServer -vmname vm -cost 10 -cpu count=2 -mem size=2048 -systemdisk size=40960 datastore -property name="vm.vcpu.cores-per-socket" value="2", name="vm.vnic.device" value="vmxnet3"

3.3.3 Changing Configuration of Virtual MachinesChanges a configuration such as the number of CPUs and memory size of virtual machines.

By specifying a resource group (or a rack) or virtual machine server (or a datacenter), you cancollectively change the configuration of virtual machines exist in the group or on the virtual machineserver.

[Note]

Before editing virtual machines collectively, be sure to collect information and update the virtualmachines to the latest status. If the virtual machines are not updated , the editing operation might notbe reflected.

When specifying the -cpu option, the -mem option, the -systemdisk option, and the -extdisk option,all settings for the options must be specified.

[Syntax]

ssc update vmproperty Path [-name vmName] [-cost costValue] [-cpu count=value [share=value][reservation=value] [limit=value]] [-mem size=value [share=value] [reservation=value][limit=value]] [-vnet nic=value operation=<modify | delete | connect | disconnect>[network=value]...] [-bandcontrol nic=value [type=value] [limit=value burstlimit=valueburstsize=value], ...] [-extdisk <add | delete | disconnect | modify | connect> [size=value] [type=<thin| thick | rdm-p | rdm-v>] [lun=value] [location=value] [independent=<persistent | nonpersistent |none>] [ctrl=value [position=value]] [file=value] [share=value] [reservation=value][limit=value] , ...] [-systemdisk [size=value] [type=<thin | thick>] [independent=<persistent |nonpersistent | none>] [share=value] [reservation=value] [limit=value]] [-opticaldrive IsoFile ...] [-property <add | delete | modify> name="name" value="value", ...]

[Parameters and Options]

Path(Required)

Specify the full path of a group where a target virtual machine belong. Or, specifythe full path of a path to a target machine.You can specify the path of a virtual machine server, a datacener or a resource as agroup.When specifying a resource group(View Type is resource:/)resource:/Rack01When specifying a virtual group (View Type is virtual:/)virtual:/VC1/DataCenter1/VMServer1

You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.

Chapter 3. Command for Controlling

215 SigmaSystemCenter 3.5 ssc Command Reference

Page 226: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Managed virtual machines in the specified group are the target of this command.Note that if the specified group has running virtual machines with the maintenacemode, this command will not be executed by an error.About specification of a path, refer to "1.1.5 About Path and GroupPathSpecification (page 11)".

[-name vmName] Change the target virtual machine's name to the specified name. This option isenabled if one target virtual machine is specified. If omitted, no change.

[-cost costValue] Change the cost value of a target virtual machine. Specify a value in the range of0-1000. If omitted, no change.

[-cpu count=value[share=value][reservation=value][limit=value]]

Specify the number of CPUs, a shared value, a reservation value, and a limitvalue. If you do not specify them, they are not changed.You cannot specify leading or trailing spaces in the equal ("=").count: Specify the number of CPUs.Specify a value in the range of 1-9999.(E.g.: count=2)share: Specify a CPU shared value.CPU shared value settings for each virtualization infrastructure are as follows:VMware Setting * CPU countHyper-V Setting / 10Xen Setting * 256 / 1000KVM Setting * 1024 / 1000Specify one of the following values."he": Highest (4000)"h": High (2000)"n": Normal (1000)"l": Low ( 500)"le": Lowest ( 250)"1" - "99999": Manual(E.g.: share=l, share=30)Optional.The default value is "n".reservation : Specify a CPU allocation value (MHz).Specify a value in the range of 0-99999.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a CPU resource assignment (MHz).Specify a value in the range of 0-99999.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-mem size=value[share=value][reservation=value][limit=value]]

Specify memory size, a shared value, a reservation value, and a limit value.If you do not specify them, they are not changed.You cannot specify leading or trailing spaces in the equal ("=").size: Specify the memory size (MB).Specify a value in the range of 1-99999999 (MB).(E.g.: size=512)

Chapter 3. Command for Controlling

216 SigmaSystemCenter 3.5 ssc Command Reference

Page 227: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

share: Specify a memory shared value.Memory shared value settings for each virtualization infrastructure are as follows:VMware Setting * the Memory size / 100Hyper-V Setting * 5Xen you cannot specify.KVM you cannot specify.Specify one of the following values."h": High (2000)"n": Normal (1000)"l": Low (500)"0" - "10000": Manual(E.g.: share=l, share=50)Optional.The default value is "n".reservation : Specify a memory allocation value (MB).Specify a value in the range of 0-99999999.(E.g.: reservation=2048)Optional.The default value is 0.limit : Specify the upper limit of a memory size (MB).Specify a value in the range of 0-99999999.(E.g.: limit=4096)Optional.The default value is 0.

[-vnet nic=valueoperation=<modify | delete |connect | disconnect>[network=value]...]

Specify a virtual network name.You can specify the names divided by a space.This is valid only for a single virtual machine.nic : Specify a NIC number.network : Specify a network name.This option is enable if you specify "modify" for the operation option.operation : Specify an operation to the network.When modifying, specify "modify."(When there is no setting, it's added.)When deleting, specify "delete."(It's possible to specify it descendingly from the biggest NIC number.)When connecting, specify "connect."When disconnecting, specify "disconnect."

[-bandcontrol nic=value[type=value] [limit=valueburstlimit=valueburstsize=value], ...]

Specify the presence of Network Band Control.nic :Specify a NIC number.type : Specify a control type for a virtual NIC.Specify either of in / out.Optional. the default type is out.Hyper-V can be set out only.limit : Specify the upper limit [kbits/s] of Band Width.burstlimit : Specify the upper limit [kbits/s] of Band Width when bursting.burstsize : Specify a burst size [kbytes].

Chapter 3. Command for Controlling

217 SigmaSystemCenter 3.5 ssc Command Reference

Page 228: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Specify the limit, the burstlimit, and the burstsize value,to specify the presence of Network Band Control.You cannot omit.Specify 0 for the limit, burstlimit or burstsize value,to specify unrestrictedly.You cannot omit.Not specify the limit, burstlimit or burstsize value,to disable Network Band Control.

[-extdisk<add | delete | disconnect |modify | connect>[size=value][type=<thin | thick | rdm-p |rdm-v>][lun=value][location=value][independent=<persistent |nonpersistent | none>][ctrl=value [position=value]][file=value] [share=value][reservation=value][limit=value]], ...]

Change the setting of an extended disk.This is valid only for a single virtual machine.When you specify multiple items, separate the data with commas (",").When adding, specify "add"."size", and "type" must be specified."location" is optional.When the "type" is rdm-p, rdm-v, specify "lun" instead of "size" and "location".When deleting, specify "delete".Specify "ctrl" and "position" for a target disk.The first information will be the target when "ctrl" and "position" are omitted.When disconnecting, specify "disconnect".Specify the target disk in "ctrl" and "position".The first information will be the target when "ctrl" and "position" are omitted.When updating, specify "modify".All except for "location" are the target.When connecting, specify "connect"."location", and "file" must be specified."ctrl", and "position" are optional.size : Specify a disk size (MB) in the range of 10-99999999 (MB).type : Specify the type of an extended disk.Specify either thin / thick / rdm-p / rdm-v.You can omit this option. When omitted, thick is set by default.rdm-p:RDM(physical)rdm-v:RDM(virtual)lun : Specify the target LUN (LUN Name).It is enabled when you specify rdm-p or rdm-v option.Specify unused LUN for RDM.location : Specify the location of the extended disk.Optional.It's effective when you specify thin or thick.You can omit this option. When omitted, the extended disk is created in the samelocation as the system disk by default.independent : Specify the Independent mode of the extended disk.Specify one of persistent / nonpersistent / none.The Independent mode is enabled in the VMware environment.When you specify the disk type is RDM(physical), you cannot specify"Independent" for the mode.ctrl : Specify a controller to which the extended disk is connected.Specify the following value:

Chapter 3. Command for Controlling

218 SigmaSystemCenter 3.5 ssc Command Reference

Page 229: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

PCIxIDExSCSIxSATAxAutoDetect (auto detection)x:Bus Numberposition : Specify the position where an extended disk is connected.You can specify the following value:0-31 (case of PCI)0-1 (case of IDE)0-63 (case of SCSI)0-29 (case of SATA)When "ctrl" is "AutoDetect", it can't be specified.The values which can be specified in the controller and position are differentdepending on the virtual infrastructure.For possible values, refer to the following "1.1.8 Controllers and Location Datafor Each Virtualization Infrastructure Product (page 19)".share: Specify a disk shared value.The disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify a disk reservation value (IOPS).Specify the value in the range of 0-2147483647.The reservation is enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment (IOPS).Specify the value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-systemdisk[size=value][type=<thin | thick>]

Change the setting of a system disk.It is effective in a single virtual machine.size : Specify a disk size (MB)in the range of 10-99999999 (MB).

Chapter 3. Command for Controlling

219 SigmaSystemCenter 3.5 ssc Command Reference

Page 230: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[independent=<persistent |nonpersistent | none>]][share=value][reservation=value][limit=value]]

type : Specify a type of system disk.Specify either thin / thick.independent : Specify the Independent mode of an extended disk.Specify one of persistent / nonpersistent / none.The Independent mode is enabled in VMware environment.share: Specify a disk shared value.The disk shared value settings for each virtualization infrastructureare as follows:VMware SettingHyper-V You cannot specify.Xen You cannot specify.KVM You cannot specify.Specify one of the following values:"h" : High (2000)"n" : Normal (1000)"l" : Low ( 500)"200" - "4000": Manual(E.g.: share=h, share=1000)Optional.The default value is "n".reservation : Specify a disk reservation value (IOPS).Specify the value in the range of 0-2147483647.The reservation is enabled in the Hyper-V environment.(E.g.: reservation=1000)Optional.The default value is 0.limit : Specify the upper limit of a disk resource assignment (IOPS).Specify the value in the range of 0-2147483647.(E.g.: limit=1500)Optional.The default value is 0 (unlimited).

[-opticaldrive IsoFile ...] IsoFile : Specify the ISO file you want to mount.If you set an empty string to this, a drive that is not mounted is created.If you do not specify IsoFile, the drive is deleted.

[-property <add | delete |modify> name="name"value="value", ...]

Change the setting of a construction parameters.This is valid only for a single virtual machine.When you specify multiple items, separate the data with commas (",").When adding a new parameter name and value, specify "add"."name" and "value" must be specified.When deleting an existing parameter name and value, specify "delete"."name" must be specified."value" can be omitted.When changing an existing parameter value, specify "modify"."name" and "value" must be specified.name : Specify the name of the parameter enclosed with double quotation marks.value : Specify the value of the parameter enclosed with double quotation marks.

Chapter 3. Command for Controlling

220 SigmaSystemCenter 3.5 ssc Command Reference

Page 231: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

For detailed information about the parameter names and values that can bespecified, refer to "4.3.11. Configuring the Unique Settings to Every VirtualizationInfrastructure (Construction Parameters)" in NEC SigmaSystemCenter OverviewReference Guide.

[Syntax examples]

・If you edit virtual machines in a datacenter: >ssc update vmproperty virtual:/192.168.1.1/DataCenter001 -cpu count=2 >ssc update vmproperty 192.168.1.1/DataCenter002 -cpu count=2 share=l -mem size=512 share=h

・If you edit virtual machines on a virtual machine server: >ssc update vmproperty 192.168.1.1/DataCenter001/VMServer01 -cpu count=1 share=35 -mem size=512 share=50

・If you edit virtual machines on all virtual machine servers: >ssc update vmproperty resource:/Rack01/Group001 -cpu count=2 >ssc update vmproperty resource:/Rack01/Group001 -mem size=256 >ssc update vmproperty resource:/Rack01/Group001 -disk modify size=512 >ssc update vmproperty resource:/Rack01/Group001 -disk add size=512 type=thin location=localstorage independent=persistent

・If you edit a specific virtual machine(name, cost and number of CPU): >ssc update vmproperty resource:/Rack01/Group001/vm001 -name vm003 -cost 15 -cpu count=2 >ssc update vmproperty resource:/Rack01/Group001/vm001 -name vm016 -cost 20 -cpu count=3 -vnet nic=1 operation=modify network=NECNET >ssc update vmproperty resource:/Rack01/Group001/vm001 -name vm016 -cost 20 -cpu count=3 -vnet nic=1 operation=connect >ssc update vmproperty resource:/Rack01/Group001/vm001 -name vm003 -cost 15 -cpu count=2 -sysdisk size=4000 type=thin independent=nonpersistent >ssc update vmproperty resource:/Rack01/Group001/vm001 -name vm003 -cost 15 -property modify name="vm.vcpu.cores-per-socket" value="2", add name="vm.vnic.device" value="vmxnet3"

[The controller and the location prepared by each virtual infrastructure]

Virtual foundation Controller Location(Disk No.) Note

VMware IDE0, IDE1 0,1 When there are no disks in 0, it isn't put on1.

SCSI0, SCSI1, SCSI2, SCSI3 0-15 (Except 7) 7 is used for DiskController.

Xen SCSI0 0-7

Hyper-V IDE0, IDE1 0,1

SCSI0, SCSI1, SCSI2, SCSI3 0-63

KVM IDE0, IDE1 0,1

PCI0 0-31

• Each location is also used by other devices (NIC, CD-ROM),

Chapter 3. Command for Controlling

221 SigmaSystemCenter 3.5 ssc Command Reference

Page 232: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

so not all the locations are available for a virtual disk.

• An extend disk can't be added to the location used by a system disk.

It's 'IDE0:0/SCSI0:0' in case of VMware. It's 'SCSI0:0' in case of Xen.

It's 'IDE0:0' in case of Hyper-V.

PCI0 of KVM is used for a virtio disk of a PCI device.

It's impossible to use 0-2.

3.3.4 Deleting Virtual MachineDeletes virtual machines.

[Syntax]

ssc delete machine <GroupName [-auto] [-host HostName...] [-index start=value <end=value |count=value>] | -path Path... | -smartgroup SmartGroupName> [-diskdelete] [-i]

[Parameters and Options]

GroupName Specify the full path of the target group.E.g)Category/group, group, group/model-host and -index can be specified with this parameter.If you do not specify -host or -index, one of the active machines in the groupis automatically selected by specifying -auto.* If you specify -auto, just a category name can be specified for this parameter.In such a case, a group to be deleted is selected from the specified category in thedescending order of priority.

[-auto] One of the active machines in the group is automatically selected.This option is enabled only when the target group is selected.

[-host HostName...] Specify the name or IP address of the host wherethe target virtual machine is activated.When specifying an IP address, describe it in the xxx.xxx.xxx.xxx form.

[-index start=value<end=value |count=value>]

Specify the start number of the host names of the virtual machines that are to be deleted,with the end number or the number of them.This option is disabled if an IP address or multiple values is / are specified with -host.When -host are omitted, it becomes the host setting list order.(E.g.) When deleting virtual machines from vm001 to vm010.-host vm -index start=001 end=010-host vm -index start=001 count=10(E.g.)When deleting hosts from the fifth to the tenth.-index start=5 end=10-index start=5 count=6

-path Path... Specify the full path of the group to which the target virtual machines belong.Or, specify the full path of the path to the target machines.You can specify the path of a virtual machine server, a Datacener or a resource as a groupWhen specifying a resource group (View Type is "resource:/")resource:/Rack01When specifying a virtual group (View Type is "virtual:/")virtual:/VC1/DataCenter1/VMServer1

Chapter 3. Command for Controlling

222 SigmaSystemCenter 3.5 ssc Command Reference

Page 233: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

You can omit View Type ("virtual:/").If you omit View Type, the specified path is treated as the path to the Virtual view.Managed virtual machines exist under the specified group are the target of deleting.A virtual machine being activated is not the target of deleting.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

-smartgroupSmartGroupName

Specify a smart group's path in the Operations or Resource view in order to delete machinescorrespond to the condition of the specified smart group.Note:* The group path must exist.If you want to specify it in the Operations view, please specify "operations:" to the root ofpath. And if you want to specify it in the Resource view, please specify "resource:" to theroot of path.When specified target view is [operations:], the activated machine in the group is deleted.When specified target view is [resource:], the not activated machine is deleted.Setting examples:[operations:/category1/group11/smartgroup101]Smartgroup101 below the group11 node of the category1 of the Operations view isspecified.[resource:/smartgroup102]Smartgroup102 below the machine node of the Resource view is specified.

[-diskdelete] Specify this option to delete the connected virtual disk.

[-i] Specify this option to display any confirmation message.

[Note]

• If a host unused is specified with "-index" option, an error occurs.

• When a smart group is specified by this command, and the host extracted in a smart group hasdivided into two or more groups, two or more jobs are generated, then, the jobs are processedsequentially.

When any error occurs in this case, the following jobs are not executed. Please remove the causeof the error, and execute them again.

[Syntax examples]

>ssc delete machine vmgroup1 -host host1 host2 -diskdelete >ssc delete machine -path resource:/vmgroup1/vm1 >ssc delete machine -path virtual:/vms-gp1/vm-gp1/vm1 >ssc delete machine -path vms-gp1/vm-gp1

Deletes an activated virtual machine which will be selected by a system. >ssc delete machine vmgroup1 -auto >ssc delete machine category1 -auto

Deletes virtual machines from "vm001" to "vm010". >ssc delete machine vmgroup1 -host vm -index start=001 end=010 >ssc delete machine vmgroup1 -host vm -index start=001 count=10

Deletes virtual machines from the fifth to the tenthin the list of host setting. >ssc delete machine vmgroup1 -index start=5 end=10 >ssc delete machine vmgroup1 -index start=5 count=6

Chapter 3. Command for Controlling

223 SigmaSystemCenter 3.5 ssc Command Reference

Page 234: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

The activated machine in the group is deleted by specifying a smart group. >ssc delete machine -smartgroup operations:/category1/group11/smartgroup101

The not activated machine is deleted by specifying a smart group. >ssc delete machine -smartgroup resource:/smartgroup102

3.3.5 Cloning Virtual MachineClones the virtual machine.

[Syntax]

ssc clone machine SourceName VMName VmsName DatastoreName

[Parameters and Options]

SourceName(Required)

Specify the virtual machine name which is clone origin.Specify a full path.The following views can be specified:"operations:" for Operations view, "virtual:" for Virtual view, and "resource:" for Resource view.If you omit View Type, the specified path is treated as the path to the Virtual view.E.g.)operations:/Category/Group/Model/VM1virtual:/VC1/Datacenter/VMS1/VM1resource:/VM1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

VMName(Required)

Specify the name of the new virtual machine.

VmsName(Required)

Specify the machine name of the destination virtual machine server to create the virtual machine.

DatastoreName(Required)

Specify the name of the destination datastore.

[Syntax examples]

>ssc clone machine virtual:/vc1/dc1/VMServer1/MasterVm1 CloneVm1 VmHost1 Storage1

3.3.6 Moving Virtual Machine (Migrate)Moves a virtual machine (Migration / QuickMigration).

[Syntax]

ssc migrate machine SourceName DestinationName [-n] [-q] [-ignorerule]

[Parameters and Options]

SourceName(Required)

Specify a name of a target virtual machine in a source in a full path.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

DestinationName Specify a destination virtual machine server name in a full path.

Chapter 3. Command for Controlling

224 SigmaSystemCenter 3.5 ssc Command Reference

Page 235: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required) About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

[-n] If you do not want to start the virtual machine after the move, specify this option.

[-q] If you want to suspend the virtual machine before the move (Quick Migration), specify thisoption.The virtual machine is resumed after the move.If omitted, do Migration.

[-ignorerule] If you want to ignore the placement rules when you move the virtual machine, specify thisoption.If omitted, you cannot move the virtual machine against the rules.

[Syntax examples]

>ssc migrate machine virtual:/VC-01/DC-001/VMServer-001/VM-001 virtual:/VC-01/DC-001/VMServer-002 >ssc migrate machine operations:/Group-VM001/Model-VM01/VM-002 operations:/Group-VMServer001/Model-VMServer01/VMServ er-002 >ssc migrate machine virtual:/VC-01/DC-001/VMServer-001/VM-003 virtual:/VC-01/DC-001/VMServer-002 -n >ssc migrate machine virtual:/VC-01/DC-001/VMServer-001/VM-001 virtual:/VC-01/DC-001/VMServer-004 -q

3.3.7 Moving Virtual Machine (Move)Moves a virtual machine with disk (StorageMigration / Move).

[Syntax]

ssc move machine SourceName DestinationName [-datastore DatastoreName] [-n] [-s] [-onlysystemdisk] [-ignorerule]

[Parameters and Options]

SourceName(Required)

Specify a name of a target virtual machine in a source in a full path.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".

DestinationName(Required)

Specify a destination virtual machine server name in a full path.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".

[-datastoreDatastoreName]

Specify a destination datastore name.

[-n] If you do not want to start the virtual machine after the move, specify this option.

[-s] If you want to move the virtual machine as power supply on (Storage Migration), specifythis option.If omitted, moves the virtual machine after power off (Move).

[-onlysystemdisk] If you want to move the virtual machine without the extended disk, specify this option. Ifomitted, moves the virtual machine with all the virtual disk.

[-ignorerule] If you want to ignore the placement rules when you move the virtual machine, specifythis option.If omitted, you cannot move the virtual machine against the rules.

Chapter 3. Command for Controlling

225 SigmaSystemCenter 3.5 ssc Command Reference

Page 236: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc move machine virtual:/VC-01/DC-001/VMServer-001/VM-001 virtual:/VC-01/DC-001/VMServer-002 >ssc move machine operations:/Group-VM001/Model-VM01/VM-002 operations:/Group-VMServer001/Model-VMServer01/VMServer-002 >ssc move machine virtual:/VC-01/DC-001/VMServer-001/VM-003 virtual:/VC-01/DC-001/VMServer-002 -datastore storage1 >ssc move machine virtual:/VC-01/DC-001/VMServer-001/VM-003 virtual:/VC-01/DC-001/VMServer-002 –n >ssc move machine virtual:/VC-01/DC-001/VMServer-001/VM-001 virtual:/VC-01/DC-001/VMServer-002 -s >ssc move machine virtual:/VC-01/DC-001/VMServer-001/VM-001 virtual:/VC-01/DC-001/VMServer-002 -onlysystemdisk

3.3.8 Evacuating Machine (Host Specified)Evacuates virtual machines to other virtual machine servers.

[Syntax]

ssc evacuate host SourceName [DestinationName] [-all] [-migration] [-move] [-failover] [-q] [-s] [-ignorerule] [-reboot]

[Parameters and Options]

SourceName(Required)

Specify the path to a host to which a source virtual machine server is assigned, or the path to ahost to which a virtual machine to be moved is assigned.If a virtual machine server is specified, powered-on virtual machines on the virtual machineserver are moved. (If the -all option is specified, all the virtual machines including powered-offones are moved.)If a virtual machine is specified, Failover for the virtual machine is executed.

[DestinationName] Specify the path to a host to which a destination virtual machine server is assigned.If omitted, destination virtual machine servers are selected automatically.(This cannot be omitted if a virtual machine is specified for SourceName.)

[-all] If you want to move all the virtual machines (including powered-off ones) on the virtualmachine server, specify this option.If omitted, only powered-on virtual machines are moved.(This option is available only if a virtual machine server is specified for SourceName.)

[-migration] If you want to move virtual machine with Migration method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-move] If you want to move virtual machine with Move method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-failover] If you want to move virtual machine with Failover method, specify this option.(This option is available only if a virtual machine server is specified for SourceName.)

[-q] If you want to suspend the virtual machine before it is moved (Quick Migration), specify thisoption. The virtual machine is resumed after it was moved.If omitted, Migration is executed.(This option is available only if a virtual machine server is specified for SourceName.)

[-s] If you specify -move option, the virtual machines is moved by Storage Migration methodreplacing with Move method.(This option is available only if a virtual machine server is specified for SourceName.)

Chapter 3. Command for Controlling

226 SigmaSystemCenter 3.5 ssc Command Reference

Page 237: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-ignorerule] If you want to ignore the placement rules when you move the virtual machine, specify thisoption.If omitted, you cannot move the virtual machine against the rules.(This option is available only if a virtual machine is specified with SourceName.)

[-reboot] If you want to reboot machines which is depended to target machines, specify this option.If omitted, these machines will not be rebooted.(This option is available only if a virtual machine server is specified with SourceName.)

[Note]

• If a virtual machine server is specified for SourceName and -move option is not specified,powered-on virtual machines stored in local datastores are not moved. If -move option isspecified, and Powered-off virtual machines are moved even if they are stored in localdatastores. (Their virtual disks are moved to other datastores.)

• If a virtual machine is specified for SourceName, Failover of the virtual machine stored in alocal datastore cannot be executed.

• If a virtual machine server of XenServer Pool Master is specified for SourceName and it isdown, the other virtual machine server which has the largest capacity in the pool becomes newPool Master.

• If a virtual machine server is specified for SourceName, virtual machines to be moved and theirdestination virtual machine servers are selected automatically by the VM Optimized Placementfeature. (If DestinationName is specified, virtual machines are moved to the specified virtualmachine server.) There are some cases that virtual machines cannot be moved according to thecondition for the VM Optimized Placement feature or placement rules. Refer to NECSigmaSystemCenter Overview Reference Guide "4.7.3. VM Evacuation" and "4.7.4. Conditionsfor VM Optimized Placement" for details.

• If a virtual machine server is specified for SourceName and any move methods are notspecified, assume Migration and Failover methods are specified.

[Syntax examples]

>ssc evacuate host //Category1/Group01/HOST-01>ssc evacuate host //Group-VM001/Host-A001 //Group-VMServer001>ssc evacuate host //Group-VMServer001/Host-VMS001 //Group-VMServer002>ssc evacuate host //Group-VM002 -all>ssc evacuate host //Category1/Group01/HOST-01 -q>ssc evacuate host //Category1/Group01/HOST-01 -migration -failover

3.3.9 Exporting Virtual MachineExport virtual machine.

[Syntax]

ssc export vm VmName Type [-Path Path]

[Parameters and Options]

VmName(Required)

Specify the full path of the target machine.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

Type(Required)

Specify the type of exporting machine.

Chapter 3. Command for Controlling

227 SigmaSystemCenter 3.5 ssc Command Reference

Page 238: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-Path Path] Specify the destination directory.If omitted, the current directory will be used.

[Syntax examples]

>ssc export vm resource:/sample_vm ovf >ssc export vm resource:/sample_vm ova -Path c:/tmp

3.3.10 Importing Virtual MachineImports a virtual machine.

[Syntax]

ssc import vm FilePath VmName Cost VmsName DatastoreName [-import Type]

[Parameters and Options]

FilePath(Required)

Specify the path of file that you want to import.When you don't specify -import, the file type will be detected automatically.

VmName(Required)

Specify the name of the virtual machine.

Cost(Required)

Specify a cost value.Specify a value in the range of 1-1000.

VmsName(Required)

Specify the name of a virtual machine server.

DatastoreName(Required)

Specify the name of the destination datastore.

[-import Type] Specify the type of the file to be imported.

[Syntax examples]

>ssc export vm resource:/sample_vm ovf >ssc export vm resource:/sample_vm ova -Path c:/tmp

3.3.11 Creating TemplateCreates a template.

[Syntax]

ssc create template Path -name name -cost costValue -type <full | hw | diff | disk> [-image name] [-vmserver vmServer] [-datastore value] [-snapshot name] [-mastervmpasswd Password] [-fixedreplica] [-ostype OperatingSystemType] [-osname <name | code>] [-ownername value] [-orgname value] [-timezone value] [-productkey value] [-license mode=<perserver | perseat>[users=value]] [-modevm < on | off >]

[Parameters and Options]

Path(Required)

Specify the full path of the target virtual machine.VC1/DataCenter1/VMServer1/vm100About specification of a path, refer to "1.1.5 About Path and GroupPathSpecification (page 11)".

-name name Specify the name of the template to be created.

Chapter 3. Command for Controlling

228 SigmaSystemCenter 3.5 ssc Command Reference

Page 239: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(Required)

-cost costValue(Required)

Specify the cost value of the template to be createdin the range of the number from 1 to 1000.

-type <full | hw | diff | disk>(Required)

Specify the type of the template from the following:full : Full clonehw : HW Profile clonediff : Differential Clonedisk : Disk clone

[-image name] Specify the name of the image to be created.This value can be specified if the template type is Disk Clone/Differential Clone.

[-vmserver vmServer] Specify the destination virtual machine server to create the template.This value can be specified if the template type is Full Clone/Disk Clone/Differential Clone.

[-datastore value] Specify the storage location.This value can be specified if the template type is Full Clone/Disk Clone/Differential Clone.

[-snapshot name] Specify the snapshot name.This value can be specified if the template type is Differential Clone.

[-mastervmpasswdPassword]

Specify the password of the master VM. It is used in order to update the passwordof Linux guest OS in the VMware environment. Specify it within 256 characters.

[-fixedreplica] You can specify it only when you create a replica VM in the same datastore with theimage.However, this option will be effectiveonly when Differential Clone is specified in the Template type.

[-ostypeOperatingSystemType]

Specify the OS type.You can specify one of the following OperatingSystemTypes:OperatingSystemType : OS type"Windows": Windows Server"Windows-client": Windows Client"Linux": Linux

[-osname <name | code>] Specify the OS name in its code or the strings displayed on Web UI.Refer to "1.1.6 OS Lists and Time zones (page 13)" in this document.This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone.

[-ownername value] Specify the name of the owner.This value can be specified if the template type is Full Clone / Disk Clone /Differential Cloneand only when you specify the Windows or Windows-client as the OS type.

[-orgname value] Specify the name of the organization.This value can be specified if the template type is Full Clone / Disk Clone /Differential Cloneand only when you specify the Windows or Windows-client as the OS type.

[-timezone value] Specify the timezone. (Optional)The default is the time zone set to the system.Specify the time zone's code or the strings displayed on Web UI.

Chapter 3. Command for Controlling

229 SigmaSystemCenter 3.5 ssc Command Reference

Page 240: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

For details, refer to "1.1.6 OS Lists and Time zones (page 13)" in thisdocument.The default value is the same as the value of "Microsoft Time Zone IndexValues."This value can be specified if the template type is Full Clone / Disk Clone /Differential Cloneand only when you specify the Windows or Windows-client as the OS type.

[-productkey value] Specify the product key.(Optional)Input it in the xxxxx-xxxxx-xxxxx-xxxxx-xxxxx format.This value can be specified if the template type is Full Clone / Disk Clone /Differential Cloneand only when you specify the Windows or Windows-client as the OS type.

[-license mode=<perserver |perseat> [users=value]]

Specify the licensing mode.perserver : Number of Connected Serverperseat : Connected Client[users=value]Specify the number of servers if you specify "perserver."This value can be specified if the template type is Full Clone / Disk Clone /Differential Cloneand only when you specify the Windows or Windows-client as the OS type.

[-modevm < on | off >] Specify the vm mode."on" : The vm mode is turned ON."off" : The vm mode is turned OFF.If you do not specify this option, "off" is configured to the tag setting.You can specify this option if template type is Disk Clone or Differential Clone.

[Note]

• If you do not specify the -ownername / –orgname options, the –timezone / -productkey / -licenseoptions have no effect.

[Syntax examples]

・In the case of Full Clone >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type full -vmserver VMServer1 -datastore disk01 -ostype windows -osname 11 -ownername nec -orgname 2CS -timezone 235 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx -license mode=perserver users=5 >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type full -vmserver VMServer1 -datastore disk01 -ostype windows -osname "Windows Server 2008 Enterprise (x64)" -ownername nec -orgname 2CS -timezone 235 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx -license mode=perseat >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type full -vmserver VMServer1 -datastore disk01 -ostype windows-client -osname "Windows 7 Professional (x64)" -ownername nec -orgname 2CS -timezone 235 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type full -vmserver VMServer1 -datastore disk01 -ostype linux -osname "Red Hat Enterprise Linux ES 3"

Chapter 3. Command for Controlling

230 SigmaSystemCenter 3.5 ssc Command Reference

Page 241: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type full -vmserver VMServer1 -datastore disk01

・In the case of HW Profile Clone >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type hw

・In the case of Differential Clone >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type diff -image image01 -vmserver VMServer1 -datastore disk01 -snapshot snapshot01 -ostype windows -osname 11 -ownername nec -orgname 2CS -timezone 235 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx -license mode=perserver users=5 >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type diff -image image01 -vmserver VMServer1 -datastore disk01 -snapshot snapshot01 -fixedreplica -ostype windows -osname "Windows Server 2008 Enterprise (x64)" -ownername nec -orgname 2CS -timezone 235 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx -license mode=perseat >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type diff -image image01 -vmserver VMServer1 -datastore disk01 -snapshot snapshot01 -fixedreplica -ostype linux -osname "Red Hat Enterprise Linux ES 3" >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type diff -image image01 -vmserver VMServer1 -datastore disk01 -snapshot snapshot01

・In the case of Disk Clone >ssc create template VC1/DataCenter1/VMServer1/vm100 -name vm100_t -cost 10 -type disk -image image01 -vmserver VMServer1 -datastore disk01

3.3.12 Updating TemplateUpdates a template.

[Syntax]

ssc template update TemplateName [-vmserver vmserver] [-name name] [-cost costValue] [-mastervmpasswd Password] [-image name] [-ostype OperatingSystemType] [-osname <name | code>]<[-ownername value] [-orgname value] [-timezone value] [-productkey value] [-licensemode=<perserver | perseat> [users=value]] | [-del] > [-mastervm <Name=value | Uuid=value>]

[Parameters and Options]

TemplateName(Required)

Specify the name of a template to be updated.

[-vmserver vmserver] Specify a virtual machine server name, if the template with the same name as thename you specify exists on another virtual machine server.

[-name name] Specify in the case of changing the template name.This value can be specified if the template type is

Chapter 3. Command for Controlling

231 SigmaSystemCenter 3.5 ssc Command Reference

Page 242: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

HW Profile Clone / Disk Clone / Differential Clone.

[-cost costValue] Specify the cost value of the template in the range of the number from 1 to 1000

[-mastervmpasswdPassword]

Specify the password of a master VM. It is used in order to update the password of aLinux guest operating system in the VMware environment. Specify it within 256characters.

[-image name] Specify the name of an image to be used.This value can be specified if the template type is Disk Clone / Differential Clone.

[-ostypeOperatingSystemType]

Specify an OS type.You can specify one of the following OperatingSystemTypes:OperatingSystemType : OS type"Windows": Windows Server"Windows-client": Windows Client"Linux": LinuxWhen you release this option, specify "None".This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone.

[-osname <name | code>] Specify an OS name.Specify the os name's code or the strings displayed on Web UI.Refer to "1.1.6 OS Lists and Time zones (page 13)" in this document.When you release this option, specify 0.This value can be specified if the template type isFull Clone/Disk Clone/Differential Clone.

[-ownername value] Specify the name of an owner.This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] or [Windows-client] is specified in the -ostype option.

[-orgname value] Specify the name of an organization.This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] or [Windows-client] is specified in the -ostype option.

[-timezone value] Specify a timezone. (Optional)The default is the time zone set to the system.Specify the time zone's code or the strings displayed on Web UI.Refer to "1.1.6 OS Lists and Time zones (page 13)" in this document.The default value is the same as the value of "Microsoft Time Zone Index Values."This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] or [Windows-client] is specified in -ostype option.

[-productkey value] Specify a product key.(Optional)Input it in the xxxxx-xxxxx-xxxxx-xxxxx-xxxxx format.This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] or [Windows-client] is specified in -ostype option.

[-licensemode=<perserver | perseat>

Specify a licensing mode.perserver : Number of Connected Server

Chapter 3. Command for Controlling

232 SigmaSystemCenter 3.5 ssc Command Reference

Page 243: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[users=value]] perseat : Connected Client[users=value]Specify the number of servers if you specify "perserver."This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] is specified in the -ostype option.

[-del] The settings of profile information(Owner Name, Organization Name,Time Zone, Product Key, License Mode) is released.This value can be specified if the template type isFull Clone / Disk Clone / Differential Clone, and[Windows] or [Windows-client] is specified in the -ostype option.

[-mastervm <Name=value |Uuid=value>]

Specified a master virtual machine.This value can be specified if the template type is Disk Clone / Differential Clone.This value can be specified the virtual machine that is managed by the same virtualmanager that managed by the template.

[Note]

• You can specify the -timezone, -productkey and -license option, if the target template has anowner name and organization name or if you specify the -ownername and -orgname option.

[Syntax examples]

> ssc template update template1 -name tempalteA -cost 10 -ostype windows -osname "Windows Server 2008 Enterprise (x64)" -ownername owner1 -orgname org1 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx -license mode=perserver user=5

> ssc template update template1 -name tempalteA -cost 10 -ostype windows-client -osname "Windows 7 Professional (x64)" -ownername owner1 -orgname org1 -productkey xxxxx-xxxxx-xxxxx-xxxxx-xxxxx

> ssc template update template1 -name tempalteA -cost 10 -ostype linux -osname "SUSE Linux Enterprise Server 10"

> ssc template update template1 -del

3.3.13 Deleting TemplateDeletes templates.

[Syntax]

ssc delete template TemplateName[...] [-vmserver VMServerName]

[Parameters and Options]

TemplateName[...](Required)

Specify the name of the template to delete.

[-vmserver VMServerName] Specify the name of the virtual machine server where the template to delete exists ifthe same name template exists in another virtual machine server.

[Syntax examples]

Chapter 3. Command for Controlling

233 SigmaSystemCenter 3.5 ssc Command Reference

Page 244: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc delete template FullCloneTemplate_W2K8>ssc delete template FullCloneTemplate_W2K8 DiffCloneTemplate_Linux>ssc delete template FullCloneTemplate_W2K3 -vmserver VMS-01

3.3.14 Exporting TemplateExports a template.

[Syntax]

ssc export template TemplateName [-vmserver VMServer] [-image Image] [-path Path]

[Parameters and Options]

TemplateName(Required)

Specify an exporting template name.

[-vmserver VMServer] Specify a virtual machine server name, in the case of a name same as a template in theother virtual machine servers.

[-image Image] Specify an exporting image name.If omitted, use the default image.

[-path Path] Specify a destination directory.If omitted, use the current directory.

[Syntax examples]

>ssc export template Template -vmserver VMS -path C:/

3.3.15 Importing TemplateImports a template.

[Syntax]

ssc import template FilePath VmsName DatastoreName [-template Name] [-image Name] [-notdefault] [-mastervm <Name=value | Uuid=value>] [-vnet VirtualNetwork ...] [-force]

[Parameters and Options]

FilePath(Required)

Specify the path of a file that you want to import.

VmsName(Required)

Specify the name of a virtual machine server.

DatastoreName(Required)

Specify the name of a destination datastore.

[-template Name] Specify the name of a template.If the template is already imported, this value is ignored.If omitted, the information of an importing template is used.

[-image Name] Specify the name of an image.If omitted, the information of an importing template is used.

[-notdefault] If you do not specify this option, register the default image for templates.

[-mastervm <Name=value |Uuid=value>]

Specified a master virtual machine.This value can be specified if the template type is Disk Clone / Differential Clone.

Chapter 3. Command for Controlling

234 SigmaSystemCenter 3.5 ssc Command Reference

Page 245: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This value can be specified the virtual machine that is managed by the same virtualmanager that managed by the template.If the template is already imported, this value is ignored.If omitted, the imported template does not have a master virtual machine.

[-vnet VirtualNetwork ...] Specify a virtual network name.You can specify up to ten names divided by a space.If omitted, the information of the importing template is used.

[-force] Specify if you want to import the template when the template of the same identifierexists.

3.3.16 Adding ImageAdds an image in a template.

[Syntax]

ssc image add ImageName Template Vmserver Datastore [-snapshot SnapshotName] [-notdefault] [-fixedreplica] [-mastervmpasswd password] [-modevm <on | off>] [-vmserver VMSserverName]

[Parameters and Options]

ImageName(Required)

Specify an image name that you intend to add in a template.You can enter up to 53 characters.Available characters are as follows: Alphabetic characters, numerals, spaces,parentheses (), hyphens (-), and underscores (_).

Template(Required)

Specify a template.

Vmserver(Required)

Specify a the destination virtual machine server.

Datastore(Required)

Specify a location where the image is to be stored.

[-snapshot SnapshotName] Specify a snapshot.If the template type is Differential Clone, specify a snapshot for this option.

[-notdefault] Adding an image.If you do not specify this option, the adding image is registered as the default image fortemplates.

[-fixedreplica] To create a replica VM in a datastore where the image is to be created, specify thisoption.

[-mastervmpasswdpassword]

Specify the password of a master VM. It is used in order to update the password of aLinux guest operating system in the VMware environment.

[-modevm <on | off>] Specify a VM Mode.on : VM Mode is turned ON.off : VM mode is turned OFF.When it is omitted, the VM mode is turned off as well as when you specified "off" forthis option.You can specify it only when Disk Clone/Differential Clone is specified as the type ofthe template.

[-vmserverVMSserverName]

Specify a virtual machine server name to have templates to add.Specify it in the case of a name same as a template in the other virtual machine servers.

Chapter 3. Command for Controlling

235 SigmaSystemCenter 3.5 ssc Command Reference

Page 246: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Note]

• This command can be executed if the template type is Disk Clone/Differential Clone.

[Syntax examples]

>ssc image add diffclone-image differentialclone-template 192.168.10.1 datastore1 -snapshot snapshotA>ssc image add diskclone-image diskclone-tepmlate 192.168.10.1 datastore1 -notdefault

3.3.17 Updating ImageUpdate an image in a template.

[Syntax]

ssc image update ImageName Template [Vmserver [Datastore]] [-mastervmpasswd password]

[Parameters and Options]

ImageName(Required)

Specify an image name that you intend to add in a template.You can enter up to 53 characters.Available characters are as follows: Alphabetic characters, numerals, spaces, parentheses(), hyphens (-), and underscores (_).

Template(Required)

Specify a template in which the image will be created.

[Vmserver [Datastore]] Specify a virtual machine server name or datastore name to have templates to update.Specify it in the case of a name same as a template in the other virtual machine servers.

[-mastervmpasswdpassword]

Specify the password of a master VM. It is used in order to update the password of aLinux guest operating system in the VMware environment.

[Syntax examples]

>ssc image update diffclone-image differentialclone-template 192.168.10.1 datastore1 -mastervmpasswd pw

3.3.18 Deleting ImagesDeletes images

[Syntax]

ssc image delete Template ImageName... [-vmserver VMServerName]

[Parameters and Options]

Template(Required)

Specify name of template of images which deletes.

ImageName...(Required)

Specify name of images which deletes.

[-vmserver VMServerName] Specify a virtual machine server name to have templates of images to delete.Specify it in the case of a name same as a template in the other virtual machineservers.

[Syntax examples]

Chapter 3. Command for Controlling

236 SigmaSystemCenter 3.5 ssc Command Reference

Page 247: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc image delete testTemplate testImage1 >ssc image delete testTemplate testImage1 testImage2 >ssc image delete testTemplate testImage1 -vmserver 192.168.220.142

3.3.19 Displaying ImagesDisplays images.

[Syntax]

ssc image show TemplateName [-vmserver VMServer] [-image Image] [-vertical]

[Parameters and Options]

TemplateName(Required)

Specify a template name.

[-vmserver VMServer] Specify a virtual machine server name, in the case of a name same as a template in theother virtual machine servers.

[-image Image] Specify an image name.

[-vertical] Specify the format. (item : value)If you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc image show Template -image Image

3.3.20 Creating SnapshotCreates a snapshot.

[Syntax]

ssc snapshot create SnapshotName Path [-vm name[...]]

[Parameters and Options]

SnapshotName(Required)

Specify the name of the snapshot to be created.

Path(Required)

Specify the path to the virtual machine server or the virtual machine.virtual:/vc1/dc1/esx1virtual:/vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[-vm name[...]] This option is enabled if a virtual machine server is specified for Path.Specify names of the virtual machines belong to the virtual machine server specified with Path.If this option is not specified, all the virtual machines belong to the virtual machine server will betargeted.Multiple parameters can be specified for this option.

[Note]

• Progress logs are displayed only when multiple virtual machines are specified for creatingsnapshots.

[Syntax examples]

Chapter 3. Command for Controlling

237 SigmaSystemCenter 3.5 ssc Command Reference

Page 248: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

When all the virtual machines of the esx1 position is target. >ssc snapshot create snapshot1 virtual:/vc1/dc1/esx1

When vm1, vm2 as virtual machine of the esx1 position is target. >ssc snapshot create snapshot1 virtual:/vc1/dc1/esx1 -vm vm1 vm2

When vm1 as virtual machine of the esx1 position is target. >ssc snapshot create snapshot1 virtual:/vc1/dc1/esx1/vm1 >ssc snapshot create snapshot1 virtual:/vc1/dc1/esx1 -vm vm1

3.3.21 Updating SnapshotEdits a snapshot.

[Syntax]

ssc snapshot update VM SnapshotName [-newname Name] [-description Description]

[Parameters and Options]

VM Specify the path of a virtual machine server.E.g. virtual:/VC/DataCenter/VMServer (You can omit View Type ("virtual:/").About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".

SnapshotName Specify the name of a snapshot.

[-newname Name] Specify the new name of a snapshot.

[-descriptionDescription]

Specify a description.Specify it within 255 characters.

[Syntax examples]

>ssc snapshot update virtual:/VC/DataCenter/VMServer/VM snapshot01 -newname snapshot2015_10 >ssc snapshot update virtual:/VC/DataCenter/VMServer/VM snapshot01 -description 2015/10

3.3.22 Deleting SnapshotsDeletes snapshots

[Syntax]

ssc snapshot delete Path <SnapshotName... | -all>

[Parameters and Options]

Path(Required)

Specify the path to the virtual machine.virtual:/vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".

SnapshotName... Specify name of snapshots which will be deleted.If you specify -all you can omit this option.

-all All snapshots of virtual machine is deleted.

Chapter 3. Command for Controlling

238 SigmaSystemCenter 3.5 ssc Command Reference

Page 249: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc snapshot delete virtual:/vc1/dc1/esx1/vm1 snapshot1 >ssc snapshot delete virtual:/vc1/dc1/esx1/vm1 snapshot1 snapshot2 >ssc snapshot delete virtual:/vc1/dc1/esx1/vm1 -all

3.3.23 Reverting a SnapshotReverts a snapshot

[Syntax]

ssc snapshot revert SnapshotName Path

[Parameters and Options]

SnapshotName(Required)

Specify the name of the snapshot to be reverted.

Path(Required)

Specify the path to the virtual machine.virtual:/vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[Syntax examples]

>ssc snapshot revert snapshot1 virtual:/vc1/dc1/esx1/vm1

3.3.24 Displaying Snapshots InformationDisplays snapshots information.

[Syntax]

ssc snapshot show Path [-vertical]

[Parameters and Options]

Path(Required)

Specify the path to the virtual machine.virtual:/vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[-vertical] Specify format.If you do not specify this option, information is displayed in the csv format.

[Syntax examples]

>ssc snapshot show virtual:/vc1/dc1/esx1/vm1 >ssc snapshot show virtual:/vc1/dc1/esx1/vm1 -vertical

3.3.25 Reconfiguring Virtual MachineReconfigures virtual machines.

[Syntax]

ssc reconfigure machine GroupFullPath [-target Name[... ...]] [-reconstruct | -revert | -apply] [-concurrent value] [-interval value] [-turnoff <0 | 1>] [-disksize size] [-shutdown]

[Parameters and Options]

Chapter 3. Command for Controlling

239 SigmaSystemCenter 3.5 ssc Command Reference

Page 250: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

GroupFullPath(Required)

The group path of the Operations view is specified.You cannot specify a tenant or category.(E.g. /Category/Group/)

[-target Name[... ...]] Specify the host name of the machine running in group.If you do not specify this option, all the machines running under the specified group aretargeted.Multiple parameters can be specified.

[-reconstruct] Reconstructs the virtual machine(s) to be the same state with templates or images that are seton the specified group, model or host setting.

[-revert] Destroys the difference disk.

[-apply] Applies a machine profile.

[-concurrent value] Specify the max number of concurrent Processing.(The default value is 1)Specify the value in the range of 1-100.

[-interval value] Specifies the execution interval. (The default value is 0)Specify the value in the range from 0 to 99999 seconds.

[-turnoff <0 | 1>] Specify the power state as an execution condition. (The default value is 1.)0 : Executes without checking the power state.1 : Executes only when the power state is Off.

[-disksize size] Specify the disk usage (MB) as an execution condition.Virtual machines whose the disk usages are the specified usage or over are targeted.Specify the value in the range of 10 to 99999999 MB.

[-shutdown] When specifying this option, Applies a machine profile after shutdown of machine.

• You cannot specify -reconstruct, -revert and -apply at the same time.

Omitting this option is the same as specifying -reconstruct.

[Syntax examples]

* reconstruct >ssc reconfigure machine operation:/vmgroup1 -reconstruct >ssc reconfigure machine operation:/vmgroup1 -target host1 host2

* reconstruct(specify command alias) >ssc reconstruct machine operation:/vmgroup1 -target host1 host2

* revert >ssc reconfigure machine operation:/vmgroup1 -revert

* apply machine profile >ssc reconfigure machine operation:/vmgroup1 -apply -shutdown

* specify conditions >ssc reconfigure machine operation:/vmgroup1 -target host1 -concurrent 2 -interval 500 -turnoff 1 -disksize 2048

3.3.26 Showing a Mountable ISO Image and a List of the CD /DVD Drive on the Virtual Machine

Shows a mountable ISO image and a list of the CD/DVD drives on the virtual machine.

Chapter 3. Command for Controlling

240 SigmaSystemCenter 3.5 ssc Command Reference

Page 251: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc iso show VMName [-vertical]

[Parameters and Options]

VMName(Required)

Specify the full path of the virtual machine.virtual://vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

[-vertical] Specify the format. If you do not specify this option,the information is displayed in the csv format.

[Syntax examples]

>ssc iso show virtual:/VC/DataCenter/VMServer/vm >ssc iso show virtual:/VC/DataCenter/VMServer/vm -vertical

3.3.27 Mounting the ISO Image to a Virtual MachineMounts the ISO image to a virtual machine.

[Syntax]

ssc iso mount VMName IsoFilePath [Ctrl Position]

[Parameters and Options]

VMName(Required)

Specify the full path of the virtual machine.virtual://vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

IsoFilePath(Required)

Specify the full path of the ISO image.

Ctrl Specify the controller.

Position Specify the position.

[Syntax examples]

>ssc iso mount virtual:/VC/DataCenter/VMServer/vm "[datastore] ISO/file.iso" ide1 0

3.3.28 Unmounting the ISO Image from a Virtual MachineUnmounts an ISO image from a virtual machine.

[Syntax]

ssc iso unmount VMName Ctrl Position

[Parameters and Options]

VMName(Required)

Specify the full path of the virtual machine.virtual://vc1/dc1/esx1/vm1About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page 11)".

Ctrl(Required)

Specify the controller.

Chapter 3. Command for Controlling

241 SigmaSystemCenter 3.5 ssc Command Reference

Page 252: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Position(Required)

Specify the position.

[Syntax examples]

>ssc iso unmount virtual:/VC/DataCenter/VMServer/vm ide1 0

3.4 VM Placement Rule3.4.1 Configuring VM Placement Rule

Configures the VM Placement Rule for virtual machines.

[Syntax]

ssc vmop set-rule GroupName SourceName [TargetName] [-type Type] [-o options] [-priority n]

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server to which you intend to configure the placement rule.Specify a path to the group or model(E.g.: Category/Group, Group/Model).

SourceName(Required)

Specify a name of a source host or restriction group to which you intend to configure the placementrule.Specify a path including the group to which the host belongs if SourceName shows a host.

The type of SourceName is automatically detected but considered as a restriction group if youspecify SourceName enclosing it in parentheses(E.g.: Category/Group/Host, Group/Host, RestrictionGroup, (RestrictionGroup)).

[TargetName] Specify a name of a destination host or restriction group to which you intend to configure theplacement rule.When you specify "-type eq", "-type ne" or "-type hold", do not specify TargetName.Specify a path including the group to which the host belongs if TargetName shows a host.

The type of TargetName is automatically detected but considered as a restriction group if youspecify TargetName enclosing it in parentheses(E.g.: Category/Group/Host, Group/Host, RestrictionGroup, (RestrictionGroup)).

If you specify only a destination host name, the host is regarded as a host that belongs to aGroupName group.

[-type Type] Specify a type of the placement rule."pinned" : Places a SourceName virtual machine on a TargetName virtual machine server."eq" : Places virtual machines specified in the member of the restriction group to the same virtualmachine server."ne" : Places virtual machine specified in the members of restriction group to different virtualmachine servers."hold" : Excludes virtual machines for Optimized Placement feature.

If you do not specify -type, "pinned" is specified.

[-o options] Specify options for the placement rule(You can specify multiple items).When you specify "-type pinned", you can specify it."force" : Forces of the placement rule.

Chapter 3. Command for Controlling

242 SigmaSystemCenter 3.5 ssc Command Reference

Page 253: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

"weak" : At the time of the use of the Optimized start,when there is not the virtual machine server which can start,for reasons of the trouble, ignores it.

[-priority n] Specify a priority of the placement rule.When you specify "-type pinned", you can specify it.Range 1 <= n <= 4The default value is 1(highest).

• If these settings have been already specified (if GroupName, SourceName, and TargetName arethe same as before), the settings are overwritten.

[Syntax examples]

>ssc vmop set-rule VmServer-g/Esx-g-01 Vm-g/vm01 VMServer-g/Esx-g-01/esx01 >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 Vm-g/vm01 VMServer-g/Esx-g-01/esx01 -type pinned >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 (vm-pinned-group) (vms-pinned-group) -type pinned >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 (vm-eq-group) -type eq >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 (vm-hold-group) -type hold >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 Vm-g/vm01 VMServer-g/Esx-g-01/esx01 -type pinned -o force >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 Vm-g/vm01 VMServer-g/Esx-g-01/esx01 -type pinned -o force weak >ssc vmop set-rule VmServer-g/Esx-g-01/VmsModel01 Vm-g/vm01 VMServer-g/Esx-g-01/esx01 -type pinned -o weak -priority 2

3.4.2 Releasing VM Placement RuleDeletes the VM Placement Rule for virtual machines.

[Syntax]

ssc vmop delete-rule GroupName [SourceHostName] [TargetHostName] [-all]

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server from which you intend to delete the placement rule.Specify a path to the group or model.(E.g.: Category/Group/Model, Group/Model)

[SourceName] Specify a target source host name or restriction group (virtual machine) of the placement rule.You cannot omit this option except when you specify -all.Specify a path including the group to which the host belongs if SourceName shows a host.

The type of SourceName is automatically detected but considered as a restriction group if youspecify SourceName enclosing it in parentheses.(E.g.: Category/Group/Host, Group/Host, RestrictionGroup, (RestrictionGroup))

[TargetName] Specify a target destination host name or restriction group (virtual machine server) of the placementrule.Specify a path including the group to which the host belongs if TargetName shows a host.

The type of TargetName is automatically detected but considered as a restriction group if youspecify TargetName enclosing it in parentheses.(E.g.: Category/Group/Host, Group/Host, RestrictionGroup, (RestrictionGroup))

Chapter 3. Command for Controlling

243 SigmaSystemCenter 3.5 ssc Command Reference

Page 254: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-all] If you specify only GroupName, deletes all placement rules that are correlated to a group or modelforVM Server.If you specify GroupName, SourceName, or TargetName,deletes all placement rules that are correlated to a VM Server model and host.

[Syntax examples]

1)If you delete rule of a SourceHost (virtual machine) and TargetHost (virtual machine server): >ssc vmop delete-rule VmServer-g/Esx-g-01 Vm-g/vm01 VmServer-g/Esx-g-01/esx01

2)If you delete rule of a SourceGroup (VM restriction group) and TargetHost (virtual machine server): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 (vm-pinned-group) VmServer-g/Esx-g-01/esx01

3)If you delete rule (eq-restriction) of a SourceGroup (VM restriction group): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 (vm-eq-group)

4) If you delete all rules of a SourceHost (virtual machine): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 Vm-g/vm01 -all

5) If you delete all rules of a TargetHost (virtual machine server): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 VmServer-g/Esx-g-01/esx01 -all

6) If you delete all rules of a SouceGroup (VM restriction group): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 (vm-restriction-group) -all

7)If you delete all rules of a GroupName (VM Server model): >ssc vmop delete-rule VmServer-g/Esx-g-01/VmsModel01 -all

3.4.3 Enabling VM Placement RuleEnables the VM Placement Rule feature for virtual machines.

[Syntax]

ssc vmop enable-rule GroupName

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server to which you intend to enable the VM Placement Rulefeature.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[Syntax examples]

>ssc vmop enable-rule VmServer-g/Esx-g-01 >ssc vmop enable-rule VmServer-g/Esx-g-01/VmsModel01

Chapter 3. Command for Controlling

244 SigmaSystemCenter 3.5 ssc Command Reference

Page 255: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.4.4 Disabling VM Placement RuleDisables the VM Placement Rule feature for virtual machines.

[Syntax]

ssc vmop disable-rule GroupName

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server to which you intend to disable the VM Placement Rulefeature.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[Syntax examples]

>ssc vmop disable-rule VmServer-g/Esx-g-01 >ssc vmop disable-rule VmServer-g/Esx-g-01/VmsModel01

3.4.5 Placement by VM Placement RulePlaces virtual machines according to the VM Placement Rule.

[Syntax]

ssc vmop apply-rule GroupName [TargetHostName]

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server of a target of the VM Placement Rule.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[TargetHostName] Specify a name of a target host to which you intend to apply the VM Placement Rule.A target virtual machine server needs to be running.

[Syntax examples]

>ssc vmop apply-rule VmServer-g/Esx-g-01 >ssc vmop apply-rule VmServer-g/Esx-g-01/VmsModel01 VMServer-g/Esx-g-01/esx01

3.4.6 Displaying VM Placement RuleDisplays the VM Placement Rule setting for virtual machines.

[Syntax]

ssc vmop show-rule [GroupName] [-vertical]

[Parameters and Options]

[GroupName] Specify a group or model for VM Server whose placement rules you want to display.Specify a path to the group or model.If you do not specify GroupName, only names of all groups and models to which the VM PlacementRule feature is configured are displayed.

Chapter 3. Command for Controlling

245 SigmaSystemCenter 3.5 ssc Command Reference

Page 256: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

(E.g.: Category/Group, Group/Model)

[-vertical] Displays information in the information display format.If you do not specify this option, the information is displayed in the csv format (in one line dividedwith commas).

• The restriction group is displayed as ([Restriction Group Name]) in the CVS format.

[Syntax examples]

>ssc vmop show-rule -vertical GroupName : //test1/test2/vmsgroup/vmsmodel01 Restriction : Enabled GroupName : //test1/test2/vmsgroup2/vmsmodel1 Restriction : Disabled

>ssc vmop show-rule #GroupName,Restriction //test1/test2/vmsgroup/vmsmodel01,Enabled //test1/test2/vmsgroup2/vmsmodel1,Disabled

>ssc vmop show-rule test1/test2/vmsgroup/vmsmodel01 -vertical * GroupName : vmsmodel01 * Restriction : Enabled * Source HostName : vmhost01 GroupName : //test1/test2/vmgroup002 MachineName : vm100 * Target HostName : vmshost01 GroupName : //test1/test2/vmsgroup MachineName : Not Running * RestrictionType : Pinned * RestrictionPriority : 1 * RestrictionFlag : none ------------------------------------------------------------- * Source HostName : vmhost02 GroupName : //test1/test2/vmgroup002 MachineName : vm200 * Target HostName : vmshost01 GroupName : //test1/test2/vmsgroup MachineName : Not Running * RestrictionType : Pinned * RestrictionPriority : 2 * RestrictionFlag : none ------------------------------------------------------------- * Source RestrictionGroupName : vm-group GroupName : //test1/test2/vmgroup002 HostName : vmhost03 HostName : vmhost04 HostName : vmhost05 * Target HostName : vmshost01 GroupName : //test1/test2/vmsgroup MachineName : Not Running

Chapter 3. Command for Controlling

246 SigmaSystemCenter 3.5 ssc Command Reference

Page 257: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

* RestrictionType : Pinned * RestrictionPriority : 1 * RestrictionFlag : none

>ssc vmop show-rule test1/test2/vmsgroup/vmsmodel01 #GroupName,Restriction,SourceHost,TargetHost,Type,Priority,Flag "vmsmodel01","Enabled","vmhost01","vmshost01","Pinned","1","none" "vmsmodel01","Enabled","vmhost02","vmshost01","Pinned","2","none" "vmsmodel01","Enabled","(vm-group)","vmshost01","Pinned","1","none"

3.4.7 Verifying VM Placement RuleVerifies the VM Placement Rule setting for virtual machines.

[Syntax]

ssc vmop verify-rule GroupName

[Parameters and Options]

GroupName(Required)

Specify a group or model for VM Server from which you intend to verify placement rule setting.Specify a path to the group or model.E.g.) Category/Group, Group/Model

[Syntax examples]

>ssc vmop verify-rule category/vmsGroup/model1

3.4.8 Creating Restriction GroupCreates a restriction group for the VM Placement Rule feature.

[Syntax]

ssc vmop create-group GroupName RestrictionGroupName

[Parameters and Options]

GroupName(Required)

Specify a group or model to which you intend to create a restriction group.Specify a group when you intend to create a restriction group for virtual machines.Specify a group or model when you intend to create a restriction group for virtual machineservers.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

RestrictionGroupName(Required)

Specify a name of restriction group which are to create.

[Syntax examples]

1)If you create a restriction group for virtual machines: >ssc vmop create-group Category/VmGroup-01 restriction-group 2)If you create a restriction group for virtual machine servers: >ssc vmop create-group Category/VmsGroup-01/EsxModel-01 vms-restriction-group

Chapter 3. Command for Controlling

247 SigmaSystemCenter 3.5 ssc Command Reference

Page 258: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.4.9 Deleting Restriction GroupDeletes a restriction group for the VM Placement Rule feature.

[Syntax]

ssc vmop delete-group GroupName RestrictionGroupName

[Parameters and Options]

GroupName(Required)

Specify a group or model from which you intend to delete a restriction group.Specify a group when you intend to delete a restriction group for virtual machines.Specify a group or model when you intend to delete a restriction group for virtual machineservers.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

RestrictionGroupName(Required)

Specify a name of restriction group to be deleted.

[Syntax examples]

1)If you delete a restriction group for virtual machines: >ssc vmop delete-group Category/VmGroup-01 restriction-group 2)If you delete a restriction group for virtual machine servers: >ssc vmop delete-group Category/VmsGroup-01/EsxModel-01 vms-restriction-group

3.4.10 Adding Member to Restriction GroupAdds a member to a restriction group for the VM Placement Rule feature.

[Syntax]

ssc vmop add-member GroupName RestrictionGroupName HostName1 [HostName2]...

[Parameters and Options]

GroupName(Required)

Specify a group or model to which you intend to configure a restriction group.Specify a group when you intend to configure a restriction group for virtual machines.Specify a group or model when you intend to configure a restriction group for virtualmachine servers.Specify a path including the group or model to which the hosts belong.(E.g.: Category/Group, Group/Model)

RestrictionGroupName(Required)

Specify the name of the restriction group to which are to add member.

HostName1 (Required)[HostName2]...

Specify host names which are added to a restriction group.Specify a path including the group to which the hosts belong.(E.g.: Category/Group/Host, Group/Host)

If you specify multiple host names, all of them are added to a restriction group.

[Syntax examples]

>ssc vmop add-member Category/VmGroup-01 vm-group vm-001 >ssc vmop add-member Category/VmGroup-01 vm-group vm-001 vm-002 vm-003 >ssc vmop add-member Category/VmsGroup-01/EsxModel-01 vms-group vms-001

Chapter 3. Command for Controlling

248 SigmaSystemCenter 3.5 ssc Command Reference

Page 259: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.4.11 Removing Member from Restriction GroupRemoves a member from a restriction group for the VM Placement Rule feature.

[Syntax]

ssc vmop remove-member GroupName RestrictionGroupName HostName1 [HostName2]...

[Parameters and Options]

GroupName(Required)

Specify a group or model to which you intend to configure a restriction group.Specify a group when you intend to configure a restriction group for virtual machines.Specify a group or model when you intend to configure a restriction group for virtualmachine servers.Specify a path including the group or model to which the hosts belong.(E.g.: Category/Group, Group/Model)

RestrictionGroupName(Required)

Specify a name of the restriction group from which you intend to remove the member.

HostName1 (Required)[HostName2]...

Specify host names which are removed from a restriction group.Specify a path including the group to which the host belongs.(E.g.: Category/Group/Host, Group/Host)

If you specify multiple host names, all of them are removed from a restriction group.

[Syntax examples]

>ssc vmop remove-member Category/VmGroup-01 vm-group vm-001 >ssc vmop remove-member Category/VmGroup-01 vm-group vm-001 vm-002 vm-003 >ssc vmop remove-member Category/VmsGroup-01/EsxModel-01 vms-group vms-001

3.4.12 Displaying Restriction GroupDisplays the restriction group setting for VM Placement Rule feature.

[Syntax]

ssc vmop show-group [GroupName] [-vertical]

[[Parameters and Options]

[GroupName] Specify a group or model whose restriction group you want to display.Specify a path to the group or model.If you do not specify GroupName, all of settings of restriction group for virtual machine aredisplayed.(E.g.: Category/Group, Group/Model)

[-vertical] Displays information in the information display format.If you do not specify this option, the information is displayed in the CSV format (in one line dividedwith commas).

[Syntax examples]

1)If you display the information of a restriction group for virtual machines: >ssc vmop show-group Category/VmGroup-01 2)If you display the information of a restriction group for virtual machine servers: >ssc vmop create-group Category/VmsGroup-01/EsxModel-01

Chapter 3. Command for Controlling

249 SigmaSystemCenter 3.5 ssc Command Reference

Page 260: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3)If you display the information of a restriction group for virtual machines with the information display format: >ssc vmop show-group Category/VmGroup-01 -vertical 4)If you display the information of all restriction groups for virtual machines: >ssc vmop show-group

[Display examples]

>ssc vmop show-group Category/VmGroup-01 #GroupName, RestrictionGroupName, Member1, Member2, ... "VmGroup-01","vm-group-01","vm-001","vm-002","vm-003" "VmGroup-01","vm-group-02","vm-004","vm-005"

>ssc vmop show-group Category/VmGroup-01 -vertical * RestrictionGroupName : vm-group-01 GroupName : //Category/VmGroup-01 HostName : vm-001 HostName : vm-002 HostName : vm-003-------------------------------------------------------------

* RestrictionGroupName : vm-group-02 GroupName : //Category/VmGroup-01 HostName : vm-004 HostName : vm-005

>ssc vmop show-group Category/VmsGroup-01/EsxModel-01 #GroupName, RestrictionGroupName, Member1, Member2, ... "EsxModel-01","vms-group-01","vms-001","vms-002" "EsxModel-01","vms-group-02","vms-003","vms-004","vms-005"

3.5 Datastore3.5.1 Displaying Datastore

Displays datastore information.

[Syntax]

ssc show datastore [DatastoreName <-vm | -template>] [-storage] [-path Path] [-vms VmsName] [-vertical]

[Parameters and Options]

[DatastoreName] Specify a datastore name to display the datastore information.

[-vm] Displays the information of the virtual machine located under the specified datastore.

[-template] Displays the information of the template located under the specified datastore.

[-storage] Displays the information of the datastore/LUN connected to the VM server.

[-path Path] Specify a path to the datacenter or the VM Server to which the datastore belongs.

[-vms VmsName] Specify a name of the VM server to which the datastore belongs.(This option is enabled if -storage is specified.)

[-vertical] Changes the format.

Chapter 3. Command for Controlling

250 SigmaSystemCenter 3.5 ssc Command Reference

Page 261: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

 -vertical: Item : ValueIf you do not specify this option, the information is displayed in the CSV format.

[Note]

Notes : ssc show datastore -storage

• In a datastore configured with multiple LUNs or in a multipath environment, PathIds thatindicate the same DatastoreName are displayed as different datastores.

• Disk volumes (LUNs) for RDM configured with the ssc rdmstorage update command orcollaboration products are not displayed even those are unused.

[Syntax examples]

>ssc show datastore >ssc show datastore -path VC1/DC >ssc show datastore -path VC1/DC/VMServer >ssc show datastore Storage1 >ssc show datastore Storage1 -vm >ssc show datastore Storage1 -template >ssc show datastore -storage -path vc1/datacenter/vms1 >ssc show datastore -storage -vms vms1 -vertical

[Display examples]

>ssc show datastore #DatastoreName,DatastoreSize (GB),DatastoreUsage (GB),DatastoreFree (GB),DatastoreUtilization (%),DataCenterPath,VmsManagerName "NECStorageS500","265.8","261.2","4.5","98","virtual:/192.168.10.220/dataCenterA","192.168.220.142,192.168.220.148" "NECStorageS500","265.8","217.7","48.1","81","virtual:/192.168.10.220/dataCenterB","192.168.220.141"

>ssc show datastore -path "virtual:/192.168.10.220/dataCenterA"

#DatastoreName,DatastoreSize (GB),DatastoreUsage (GB),DatastoreFree (GB),DatastoreUtilization (%),DataCenterPath,VmsManagerName "NECStorageS500","265.8","261.2","4.5","98","virtual:/192.168.10.220/dataCenterA","192.168.220.142,192.168.220.148"

>ssc show datastore NECStorageS500 -path "virtual:/192.168.10.220/dataCenterA"

[Datastore] #DatastoreName,DatastoreSize (GB),DatastoreUsage (GB),DatastoreFree (GB),DatastoreUtilization (%),DataCenterPath,VmsManagerName "NECStorageS500","265.8","261.2","4.5","98","virtual:/192.168.10.220/dataCenterA","192.168.220.142,192.168.220.148"

[Machine] #MachineName,MachineType,Uuid,MacAddress,ProductName,ModelName,ManagedStatus,SummaryStatus,PowerState,HardwareStatus,MaintenanceStatus,RunningStatus,ExecuteStatus,EventPolicyStatus,OperatingSystem,OSVersion,HostName,IPAddress,MachineSubType,Cost,MemorySize (MB),Processor,CPUCount,CPULimit (MB),CPUShare,DiskUsage (GB) "MasterMachine","VMware, Virtual Machine","42043949-9fde-6cb5-297c-bc5cd39

Chapter 3. Command for Controlling

251 SigmaSystemCenter 3.5 ssc Command Reference

Page 262: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

a6de7","00:50:56:84:78:F6","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","","","","","Master VM","0","","","","","","" "MasterVM","VMware, Virtual Machine","42049b63-168e-86d0-83c8-e57319cb622d","00:50:56:84:09:86","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","","","","","-","0","","","","","",""

[Template] #SoftwareName,CreateTime,SoftwareCost,SoftwareType,VMServerName,SoftwareLocation,ImageName,DiskSize (MB),Description "FullCloneTemplate","2010/07/09 15:16:13","1","Template, FullClone","192.168.220.142","NECStorageS500","FullCloneTemplate","1024",""

>ssc show datastore "NECStorageS500" -path "virtual:/192.168.10.220/dataCenterA" -vm

[Machine] #MachineName,MachineType,Uuid,MacAddress,ProductName,ModelName,ManagedStatus,SummaryStatus,PowerState,HardwareStatus,MaintenanceStatus,RunningStatus,ExecuteStatus,EventPolicyStatus,OperatingSystem,OSVersion,HostName,IPAddress,MachineSubType,Cost,MemorySize (MB),Processor,CPUCount,CPULimit (MB),CPUShare,DiskUsage (GB) "MasterMachine","VMware, Virtual Machine","42043949-9fde-6cb5-297c-bc5cd39a6de7","00:50:56:84:78:F6","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","","","","","Master VM","0","","","","","","" "MasterVM","VMware, Virtual Machine","42049b63-168e-86d0-83c8-e57319cb622d","00:50:56:84:09:86","VMware Virtual Machine 7","","Managed","-","Off","-","Off","-","-","-","","","","","-","0","","","","","",""

>ssc show datastore NECStorageS500 -path "virtual:/192.168.10.220/dataCenterA" -template

#SoftwareName,CreateTime,SoftwareCost,SoftwareType,VMServerName,SoftwareLocation,ImageName,DiskSize (MB),Description "FullCloneTemplate","2010/07/09 15:16:13","1","Template, FullClone","192.168.220.142","NECStorageS500","FullCloneTemplate","1024",""

>ssc show datastore Storage1 -vertical

[Datastore-01] DatastoreName : NECStorageS500 DatastoreSize (GB) : 265.8 DatastoreUsage (GB) : 261.2 DatastoreFree (GB) : 4.5 DatastoreUtilization (%) : 98 DataCenterPath : virtual:/192.168.10.220/dataCenterA VmsManagerName : 192.168.220.142,192.168.220.148

[Machine-01] MachineName : MasterMachine MachineType : VMware, Virtual Machine Uuid : 42043949-9fde-6cb5-297c-bc5cd39a6de7 MacAddress : 00:50:56:84:78:F6 ProductName : VMware Virtual Machine 7 : : IPAddress : MachineSubType : MasterVM

Chapter 3. Command for Controlling

252 SigmaSystemCenter 3.5 ssc Command Reference

Page 263: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Cost : 0 MemorySize (MB) : Processor : CPUCount : CPULimit (MB) : CPUShare : DiskUsage (GB) :

[Machine-02] : : :

[Template-01] SoftwareName : FullCloneTemplate CreateTime : 2010/07/09 15:16:13 SoftwareCost : 1 SoftwareType : Template, FullClone VMServerName : 192.168.220.142 SoftwareLocation : NECStorageS500 ImageName : FullCloneTemplate DiskSize (MB) : 1024 Description :

>ssc show datastore -storage -vms vms1 -vertical

[Datastore-01] DatastoreName : iStorage001 LUN : 1 PathId : vmhba1:2:3:4:5 UniqueId : eui.123456789e123456 WWPN : - WWNN : - RemoteHost : - MountPoint : - Size (GB) : 500.0

[Datastore-02] DatastoreName : Storage1 LUN : 2 PathId : vmhba1:3:5:7:9 UniqueId : mpx.vmhba1:C3:T5:L7 WWPN : - WWNN : - RemoteHost : - MountPoint : - Size (GB) : 40.5

[Datastore-03] DatastoreName : iStorage002 LUN : 3 PathId : vmhba2:4:6:8:0 UniqueId : eui.987654321e654321 WWPN : - WWNN : - RemoteHost : - MountPoint : - Size (GB) : 550.6

Chapter 3. Command for Controlling

253 SigmaSystemCenter 3.5 ssc Command Reference

Page 264: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.5.2 Creating DatastoreCreates datastore.

[Syntax]

ssc create datastore DatastoreName VmsName <-lun LUN -hbano HBANo |

-pathid PathId | -uniqueid UniqueId | -folder FolderName -server ServerAddress> [-propertyname=Value value=Value, ...]

[Parameters and Options]

DatastoreName(Required)

Specify a datastore name to create.

VmsName(Required)

Specify the VM server to create the datastore.

-lun LUN Specify a LUN No. of the datastore to create.

-hbano HBANo Specify an HBA No. of the datastore to create.This parameter cannot be specified for a local disk or a virtual machine server towhich HBA is not registered.

-pathid PathId Specify a path Id of the datastore to create.

-uniqueid UniqueId Specify a unique Id of the datastore to create.

-folder FolderName Specify a folder of the datastore to create.(E.g. /nfs_volume)

-server ServerAddress Specify a server with the folder of the datastore to create.

[-property name=Valuevalue=Value, ...]

Change the setting of a construction parameters.When you specify multiple items, separate the data with commas (",").

[Note]

• If a HBA is connected to some storage devices, the datastore cannot be created by specifying "-lun LUN" and "-hbano HBANo".

• When create an NFS datastore, please specify < -folder FolderName -server ServerAddress >.

• The disk volume(LUN) established for RDM by the command or by a compatible product can'tbe used for creating of datastore.

[Syntax examples]

>ssc create datastore DatastoreSan1 vms-1 -lun 0 -hbano 1 >ssc create datastore DatastoreSan1 vms-1 -pathid vmhba0:1:1:0 >ssc create datastore DatastoreSan1 vms-1 -uniqueid "eui.003013840e640001" >ssc create datastore DatastoreSan1 vms-1 -uniqueid "003013840e640001" >ssc create datastore DatastoreSan1 vms-1 -uniqueid "naa.60060160967021004ab70806c311de10" >ssc create datastore NfsDatastore1 esx10.ssc-asc.net -folder /Volume-001 -server 172.26.0.201

3.5.3 Deleting DatastoreDeletes datastore.

[Syntax]

Chapter 3. Command for Controlling

254 SigmaSystemCenter 3.5 ssc Command Reference

Page 265: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc delete datastore DatastoreName VmsName [-nonunmount]

[Parameters and Options]

DatastoreName(Required)

Specify the name of the datastore to delete.

VmsName(Required)

Specify a virtual machine server name to which the datastore to delete is connected.

-nonunmount Unmounting datastore is not executed before removing datastore.The nonunmount is only enabled in VMware environment.

[Note]

• When there are virtual machines and templates in the specified datastore, the datastore cannotbe deleted.

• When the environment is vSphere 5.0 or later, Unmounting datastore is executed beforeremoving datastore.

[Syntax examples]

>ssc delete datastore storage1 vms1

3.5.4 Scanning and Updating Datastore InformationScans and updates the information of the datastore which is connected to a VM server.

[Syntax]

ssc scan datastore <VmsName | -model ModelName>

[Parameters and Options]

VmsName Specify a VM server name of the scan target.

-model ModelName Specify a VM Server model.If this parameter is specified, the system scans virtual machine servers under the VM servermodel.Only VM server model can be specified.

[Syntax examples]

>ssc scan datastore vms-1 >ssc scan datastore -model tenant1/vmsgroup1/esxmodel

3.5.5 Updating Datastore SettingsUpdates datastore settings.

[Syntax]

ssc update datastore DatastoreName [-path Path] [-capacity Value] [-desiredmax Value] [-tag Tag...]

[Parameters and Options]

DatastoreName(Required)

Specify the datastore name for updating.This specification is case sensitive.

[-path Path] Specify a path to the datacenter or the VM server to which the datastore belongs.If you do not specify this option, all VM server in the system is the target.

Chapter 3. Command for Controlling

255 SigmaSystemCenter 3.5 ssc Command Reference

Page 266: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-capacity Value] Updates the upper limit of the number of virtual machines.(0 <= value <= 100000)

[-desiredmax Value] Updates the range of use upper limit. (0 <= value <= 100)

[-tag Tag...] Updates tag. You can specify multiple tags.

• Specify at least one of the -capacity, -desiredmax and -tag options.

• This command doesn't correspond to tags setting of RDM storage.

[Syntax examples]

>ssc update datastore storage1 -path vc1/DataCenter1/VMS1 -capacity 1000>ssc update datastore storage1 -path vc1/DataCenter1/VMS1 -desiredmax 50>ssc update datastore storage1 -path vc1/DataCenter1/VMS1 -tag public>ssc update datastore storage1 -path vc1/DataCenter1/VMS1 -capacity 1000 -desiredmax 50 -tag private VMS1>ssc update datastore storage1 -capacity 1000 -desiredmax 50

3.5.6 Setting the Virtual Machine Creating DatastoreSets the datastore where virtual machines to be created.

[Syntax]

ssc set datastore-setting Path [DatastoreName] [-host HostName] < [-priority Value] [-candidate <true | false >] | [-delete] >

[Parameters and Options]

Path(Required)

Specify the path to the target operations group or host.You can omit View Type ("operations:/")You can specify neither a tenant nor a category for this option.E.g.:When specifying a group name:Category/GroupWhen specifying a model name:Category/Group/ModelWhen specifying a host name:Category/Group/HostWhen specifying a host name (full path):operations:/Category/Group/Host

[DatastoreName] Specify the datastore name for setting.Enter the case-sensitive string.When you specify "-candidate false", this option can be omitted.

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Path.Specify this option if there is a model with the same name as the target host.

[-priority Value] Specify the priority with a number from 1 to 10.

[-candidate < true | false>]

Specify whether the datastore should be set as a destination candidate on which virtualmachines will be created.true: candidatefalse: non-candidate

Chapter 3. Command for Controlling

256 SigmaSystemCenter 3.5 ssc Command Reference

Page 267: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

* When "false" is specified, DatastoreName can be omitted.In such a case, all datastores are excluded from the candidates.

[-delete] Deletes setting.

• Specify at least one of the -priority or -candidate options.

[Syntax examples]

>ssc set datastore-setting category/vmsgroup storage1 -priority 2 -candidate false>ssc set datastore-setting category/vmsgroup storage1 -candidate true>ssc set datastore-setting category/vmsgroup/model storage1 -priority 2>ssc set datastore-setting category/vmsgroup/host1 storage1 -priority 2>ssc set datastore-setting category/vmsgroup storage1 -delete>ssc set datastore-setting category/vmsgroup -candidate false

3.5.7 Displaying Folder/File of DatastoreDisplays a folder/file of the specified datastore.

[Syntax]

ssc datastorefile show -vms Vms -datastore DataStore [-path Path] [-type Type] [-size Size] [-index[start=Start] count=Count]

[Parameters and Options]

-vms Vms(Required)

Specify a virtual machine server name.

-datastore DataStore(Required)

Specify a datastore name.

[-path Path] Specify the path of the folder.

[-type Type] Specify a type of the file.

[-size Size] Specify a size.

[-index [start=Start] count=Count] "start" is optional.When specifing -index, "count" must be specified.

[Syntax examples]

>ssc datastorefile show -vms 192.**.**.** -datastore DS1

3.5.8 Mount DatastoreMounts Datastore.

[Syntax]

ssc mount datastore DatastoreName VmsName

[Parameters and Options]

DatastoreName(Required)

Specify a datastore name to mount datastore.

VmsName(Required)

Specify a virtual machine server namewhich datastore to mount is connected to.

Chapter 3. Command for Controlling

257 SigmaSystemCenter 3.5 ssc Command Reference

Page 268: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc mount datastore DS VMS

3.5.9 Unmount DatastoreUnmounts Datastore.

[Syntax]

ssc unmount datastore DatastoreName VmsName

[Parameters and Options]

DatastoreName(Required)

Specify a datastore name to unmount datastore.

VmsName(Required)

Specify a virtual machine server namewhich datastore to unmount is connected to.

[Syntax examples]

>ssc unmount datastore DS VMS

3.6 Resource Pool3.6.1 Creating Resource Pool

Creates a resource pool.

[Syntax]

ssc resourcepool create <-root GroupName ResourcePoolName vCPU | ParentResourcePoolNameSubResourcePoolName [-resource [overcommit=on] [vm=value] [vcpu=value] [memory=value][datastore=value] [datastore:tag=value] [lun:sizeGB=value] [lun:sizeGB:tag=value]]> [-private[GroupName]] [-desc description]

[Parameters and Options]

-root GroupNameResourcePoolName vCPU

To create a resource pool, specify this parameter.Specify the group of the virtual machine server.GroupName : Specify the path of the group where the resource pool is to becreated. Specify a VM server group.ResourcePoolName : Specify a resource pool name.vCPU :Specify the Number of vCPU or Frequency(MHz) of vCPU.E.g.)When specifying a number, specify 10vpc or 10.When specifying a frequency, specify 300mhz.

ParentResourcePoolNameSubResourcePoolName[-resource [overcommit=on][vm=value][vcpu=value][memory=value]

To divide a sub-pool, specify this parameter.ParentResourcePoolName : Specify a parent resource pool name.SubResourcePoolName : Specify a sub-pool name.-resource : Specify Resource information.You cannot specify leading or trailing spaces in the equal ("=").overcommit=on : To allow overcommitment of resources, specify this option.

Chapter 3. Command for Controlling

258 SigmaSystemCenter 3.5 ssc Command Reference

Page 269: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[datastore=value][datastore:tag=value][lun:sizeGB=value][lun:sizeGB:tag=value]]

vm : Specify the number of virtual machine in value.vcpu : Specify the number of vCPU in value.memory : Specify memory size(MB) in value.datastore : Specify datastore capacity(GB) in value.datastore:tag : Specify datastore tag in tag, and datastore capacity(GB) in value.lun:sizeGB : Specify LUN size(GB) in size, and number of LUN in value.lun:sizeGB:tag : Specify LUN size(GB) in size, LUN tag in tag, and number ofLUN in value.

[-private [GroupName]] To create a dedicated resource pool, specify this option.If you do not specify this option, a shared resource pool is created.Specify a group to which the resource pool is to be allocated for GroupName.(Optional)

[-desc description] Specify the description.

[Syntax examples]

>ssc resourcepool create -root vms/vmsgroup1 resourcepool1 10vpc>ssc resourcepool create -root vms/vmsgroup1 resourcepool1 20>ssc resourcepool create -root vms/vmsgroup1 resourcepool1 300mhz>ssc resourcepool create -root vms/vmsgroup1 resourcepool1 20vpc -private -desc "private resourcepool">ssc resourcepool create -root vms/vmsgroup1 resourcepool1 300mhz -private tenant/tenant1>ssc resourcepool create resourcepool1 subresource1 -private -resource vcpu=2 memory=512 storage=100 vm=5>ssc resourcepool create resourcepool1 subresource1 -resource vcpu=2 vm=5>ssc resourcepool create resourcepool1 subresource1 -private tenant/tenant1>ssc resourcepool create resourcepool1 subresource1 -desc "public resource pool"

3.6.2 Displaying Resource Pool InformationDisplays resource pool information.

[Syntax]

ssc resourcepool show [ResourcePoolName] [-all]

[Parameters and Options]

[ResourcePoolName] Specify the name of the resource pool to display. A sub-pool also can be specified.If you do not specify this option, resource pool names are enumerated.'R' of first character in the line shows Root and 'S' shows Sub.

[-all] To enumerate names of sub-pools, specify this option.

[Syntax examples]

>ssc resourcepool show >ssc resourcepool show -all >ssc resourcepool show rp-gold-tokyo-1 >ssc resourcepool show subResourcePool-A

[Display examples]

Chapter 3. Command for Controlling

259 SigmaSystemCenter 3.5 ssc Command Reference

Page 270: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc resourcepool showR rp-gold-tokyo-1R rp-gold-kobe-1R rp-gold-us-east-1R rp-silver-tokyo-1R rp-silver-kobe-1

>ssc resourcepool show -allR rp-gold-tokyo-1R rp-gold-kobe-1S subResourcePool-AS subResourcePool-BR rp-gold-us-east-1R rp-silver-tokyo-1R rp-silver-kobe-1S subResourcePool-C

>ssc resourcepool show rp-gold-tokyo-1[Base]vCPU: 300MHzType: sharedOvercommit: false

[ResourcePool]#type,capacity,consumed,unused,reserved,actually-usedvm,20,10,10,20,15cpu,170624MHz,50MHz,170574MHz,300000MHz,1440MHzvcpu,100,20,80,50,10memory,2048MB,512MB,1536MB,1024MB,3000MBdatastore,200GB,10GB,190GB,100GB,150GB

[SubResourcePool]#name,vm,vm-reserved,vcpu,vcpu-reserved,memory,memory-reserved,datastore,datastore-reserved,applied-groupsubResourcePool-A,50/600,0,50/500,0,12800/200000,0,200.00/2000.00,0.0,"Tenant1"subResourcePool-B,50/400,0,50/300,0,12800/300000,0,200.00/1000.00,0.0,""

>ssc resourcepool show rp-silver-kobe-1[Base]vCPU: 20vpcType: dedicatedOvercommit: false

[ResourcePool]#type,capacity,consumed,unused,reserved,actually-usedvm,20,10,10,20,15cpu,170624MHz,50MHz,170574MHz,300000MHz,1440MHzvcpu,100,20,80,50,10memory,2048MB,512MB,1536MB,1024MB,3000MBdatastore,200GB,10GB,190GB,100GB,150GB

[SubResourcePool]#name,vm,vm-reserved,vcpu,vcpu-reserved,memory,memory-reserved,datastore,datastore-reserved,applied-group

Chapter 3. Command for Controlling

260 SigmaSystemCenter 3.5 ssc Command Reference

Page 271: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

subResourcePool-C,50/600,0,50/500,0,12800/200000,0,200.00/2000.00,0.0,"Tenant2"

>ssc resourcepool show subResourcePool-A[Base]Parent: rp-gold-tokyo-1Type: dedicatedOvercommit: true

[ResourcePool]#type,capacity,consumed,unused,reserved,actually-usedvm,20,10,10,20,15vcpu,100,20,80,50,10memory,2048MB,512MB,1536MB,1024MB,3000MBdatastore,200GB,10GB,190GB,100GB,150GB

[SubResourcePool]#name,vm,vm-reserved,vcpu,vcpu-reserved,memory,memory-reserved,datastore,datastore-reserved,applied-group

3.6.3 Deleting a Resource PoolDeletes a resource pool.

[Syntax]

ssc resourcepool delete ResourcePoolName

[Parameters and Options]

ResourcePoolName(Required)

Specify a name of resource pool or sub resource pool.

[Syntax examples]

>ssc resourcepool delete ResourcePool1>ssc resourcepool delete SubResourcePool1

3.6.4 Configures the Setting for Monitoring of Resource PoolConfigures the setting for monitoring of resource pool.

[Syntax]

ssc resourcepool set-monitor-setting ResourcePoolName [-s expression] [-d type]

[Parameters and Options]

ResourcePoolName(Required)

Specify a name of resource pool or sub resource pool.

[-s expression] Specify monitoring setting of resource pool, following the format of expression describedbelow.

[-d type] Specify the type of setting which you want to delete, following the format of type describedbelow.If you do not specify the type, all monitoring setting are deleted.

Chapter 3. Command for Controlling

261 SigmaSystemCenter 3.5 ssc Command Reference

Page 272: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

• type : Specify the type of resource for resource pool, following the conversion table describedbelow.

- By linking types of resource with the "+" notation, you can specify multiple resources atsame time.

ex) cpu+memory+datastore

specified value resource type

cpu CPU

vcpu Number of vCPU

memory(mem)

Memory

datastore(disk)

Datastore

vm Number of VM

all all of types

• expression : Specify setting in the format of ''"type=info,warning,critical".

ex)cpu=60,80,100

- Each specified value mean the following.

* type : Specify the type of resource for resource pool, that has been described above

* info : Specify the Info level threshold of monitoring.

* warning : Specify the Warning level threshold of monitoring.

* critical : Specify the Critical level threshold of monitoring.

- Each threshold of monitoring is specified with following format.

* 1 - 10000 : Represents the ratio(%) of the resource capacity.

* 0 : Represents the disabled monitoring.

* d : Represents the default threshold.

* k : Represents the keeping of previous setting.

- When configuring multiple settings at same time, you can specify multiple expression.

[Note]

• If you do not specify some setting, these setting are maintained by previous setting.

[Syntax examples]

>ssc resourcepool set-monitor-setting pool-1 -s all=60,80,100>ssc resourcepool set-monitor-setting pool-1 -s cpu+memory=k,70,90 datastore=d,90,100 vm=0,50,80>ssc resourcepool set-monitor-setting pool-1 -d>ssc resourcepool set-monitor-setting pool-1 -d cpu+datastore

3.6.5 Displays the Setting for Monitoring of Resource PoolDisplays the setting for monitoring of resource pool.

[Syntax]

Chapter 3. Command for Controlling

262 SigmaSystemCenter 3.5 ssc Command Reference

Page 273: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ssc resourcepool show-monitor-setting [ResourcePoolName]

[Parameters and Options]

[ResourcePoolName] Specify a name of resource pool or sub resource pool.If you do not specify the ResourcePool, displays the setting of all resource pools.

• Displays "-" as PoolName and "<Default>" as Type for default setting.

• Displays "(value)" as monitoring threshold which specified to use default setting.

• Displays "-" as monitoring threshold which is disabled.

[Syntax examples]

>ssc resourcepool show-monitor-setting pool-1>ssc resourcepool show-monitor-setting

[Output examples]

>ssc resourcepool show-monitor-setting pool-1#Type,Info,Warning,Critical"<Default>","60","80","100""CPU","50","(80)","100""vCPU","50","75","100""Memory","-","75","95""Storage","70","90","120""VM","60","(80)","95"

>ssc resourcepool show-monitor-setting#PoolName,Type,Info,Warning,Critical"-","<Default>","60","80","100""pool-1","CPU","50","(80)","100""pool-1","vCPU","50","75","100""pool-1","Memory","-","75","95""pool-1","Storage","70","90","120""pool-1","VM","60","(80)","95""pool-2","CPU","-","(80)","95""pool-2","Memory","-","75","95"

[Note]

• Use default setting to resource type which is not configured,.

3.7 Placement Information3.7.1 Configuring Placement Information

Configures the Placement Information for virtual machines.

[Syntax]

ssc vmop set-position GroupName [SourceHostName] [TargetHostName] -key keyword

[Parameters and Options]

GroupName(Required)

Specify a VM group or model to which you intend to configure the Placement Information.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

Chapter 3. Command for Controlling

263 SigmaSystemCenter 3.5 ssc Command Reference

Page 274: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[SourceHostName] Specify a name of a source host to which you intend to configure the Placement Information.Specify a path including a group to which the host belongs.(E.g.: Category/Group/Host, Group/Host)

If you do not specify SourceHostName, set the current position for all hosts in the specifiedgroup by GroupName.

[TargetHostName] Specify a name of a destination host to which you intend to configure the PlacementInformation.Specify a path including a group to which the host belongs.(E.g.: Category/Group/Host, Group/Host)

If you do not specify TargetHostName, set the current position for host which is specified bySourceHostName.

-key keyword(Required)

Specify a name of the Placement Information.

[Note]

• If you do not specify TargetHostName and the source VM is worked on unmanaged host, thePlacement Information will be not created.

• keyword has the following limitations:

- Length : 32 or fewer characters.

- Available characters : Alphabets (a-z, A-Z), numbers (0-9), a hyphen (-), an underscore (_)

[Syntax examples]

>ssc vmop set-position Vm-g/Vm-g-01 -key keyword

>ssc vmop set-position Vm-g/Vm-g-01 Vm-g/vm01 -key keyword

>ssc vmop set-position Vm-g/Vm-g-01 Vm-g/vm01 VmServer-g/Esx-g-01/esx01 -key keyword

3.7.2 Deleting Placement InformationDeletes the Placement Information for virtual machines.

[Syntax]

ssc vmop delete-position GroupName [HostName] -key keyword

[Parameters and Options]

GroupName(Required)

Specify a VM group or model from which you intend to delete the Placement Information.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[HostName] Specify a host name of the virtual machine that you intend to delete the Placement Information.Specify a path including a group to which the host belongs.(E.g.: Category/Group/Host, Group/Host)

If you do not specify HostName, delete all Placement Information belonging to the group specifiedby GroupName.

-key keyword(Required)

Specify a name of the Placement Information.

Chapter 3. Command for Controlling

264 SigmaSystemCenter 3.5 ssc Command Reference

Page 275: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc vmop delete-position Vm-g/Vm-g-01 -key keyword

>ssc vmop delete-position Vm-g/Vm-g-01 Vm-g/vm01 -key keyword

3.7.3 Displaying Placement InformationDisplays the Placement Information setting for virtual machines.

[Syntax]

ssc vmop show-position GroupName [-key keyword]

[Parameters and Options]

GroupName(Required)

Specify a VM group or model whose Placement Information you want to display.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[-key keyword] Specify a name of the Placement Information.If you do not specify keyword, show all keywords that are set for all hosts in the group specified byGroupName.

[Note]

• If one of the following conditions is satisfied, the destination host is displayed as <INVALID>.

- No machine is assigned to the source host (VM)

- No machine is assigned to the destination host (VM server).

- Destination host which contains the VM can not be detected for some reasons. (e.g.: TheVM server which was specified as the destination host was deleted.)

[Syntax examples]

>ssc vmop show-position Vm-g/Vm-g-01

>ssc vmop show-position Vm-g/Vm-g-01 -key keyword

[Output examples]

>ssc vmop show-position Vm-g/Vm-g-01 #Keyword "keyword1" "keyword2" "keyword3"

>ssc vmop show-position Vm-g/Vm-g-01 -key keyword1 #SourceHost,TargetHost "vmhost01","vmshost01" "vmhost02","vmshost01" "vmhost03","vmshost02" "vmhost04","<INVALID>"

Chapter 3. Command for Controlling

265 SigmaSystemCenter 3.5 ssc Command Reference

Page 276: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.7.4 Applying Placement InformationMigrates virtual machines according to the Placement Information.

[Syntax]

ssc vmop apply-position GroupName [TargetHostName] -key keyword

[Parameters and Options]

GroupName(Required)

Specifiy a VM/VM server group or model to which the Placement Information will be applied.Specify a path to the group or model.(E.g.: Category/Group, Group/Model)

[TargetHostName] Specify a name of a target host.Specify a path including a group to which the host belongs.A target host needs to be on running.(E.g.: Category/Group/Host, Group/Host)

If you do not specify the TargetHostName, apply the information to all hosts in the group whichis specified by GroupName.

-key keyword(Required)

Specify a name of the Placement Information.

[Note]

• If you specify the VM group or model as the parameter of GroupName:

- The targets of migration are virtual machines which belong to this group or model.

- TargetHostName needs to be specified in this group or model.

• If you specify the VM server group or model to the parameter of GroupName:

- The target of migration are virtual machines which is running on all hosts in this group ormodel.

- If you specify the TargetHostName, the targets of migration are what meet the followingconditions.

* All virtual machines which are running on this host.

* All virtual machines that this host is specified as their destination host of thePlacement Information.

• Refer to the NEC SigmaSystemCenter Overview Reference Guide "3.12.18. VM PlacementInformation Feature" for details of the Placement Information.

[Syntax examples]

>ssc vmop apply-position Vm-g/Vm-g-01 -key keyword

>ssc vmop apply-position Vm-g/Vm-g-01 Vm-g/vm01 -key keyword

>ssc vmop apply-position VmServer-g/Esx-g-01 -key keyword

>ssc vmop apply-position VmServer-g/Esx-g-01 VmServer-g/Esx-g-01/esx01 -key keyword

Chapter 3. Command for Controlling

266 SigmaSystemCenter 3.5 ssc Command Reference

Page 277: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

3.8 Service3.8.1 Displaying Service Setting

Displays OS services/deamons.

[Syntax]

ssc show osservice <-name Name | -uuid UUID> [-vertical]

[Parameters and Options]

<-name Name | -uuid UUID> Specify a name or UUID to display the services/deamons of a machine.

[-vertical] Specify the format. (item : value)If you do not specify this option, the information is displayed in the CSV format.

3.8.2 Updating Service SettingUpdates OS services/deamons.

[Syntax]

ssc update osservice ServiceName <-name Name | -uuid UUID> -waitforstartup <true | false>

[Parameters and Options]

ServiceName(Required)

Specify the name of a service.

<-name Name | -uuid UUID>(Required)

Specify the name or UUID of a machine.

-waitforstartup <true | false>(Required)

Specifies whether to wait to start the service when the machine starts.

Chapter 3. Command for Controlling

267 SigmaSystemCenter 3.5 ssc Command Reference

Page 278: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Chapter 4. Command for Maintenance

Contents4.1 Operations Log ........................................................................................................................269

4.2 Policy.......................................................................................................................................270

4.3 Maintenance.............................................................................................................................271

4.4 MachineAccessHistory.............................................................................................................279

4.5 Exporting (Backing up)/Importing (Restoring) of SSC Configuration Information ..................281

4.6 Output Report ..........................................................................................................................284

Chapter 4. Command for Maintenance

268 SigmaSystemCenter 3.5 ssc Command Reference

Page 279: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

This chapter explains commands regarding maintenance in SigmaSystemCenter.

4.1 Operations Log4.1.1 Displaying Operations Log

Displays an Operations log.

The maximum number of logs to be displayed is 100 if you do not specify the -all option.

When omitting all the parameters, the latest 100 logs from an execution time to 3 days before aredisplayed.

If you specify -all, all logs in the database are displayed.

[Syntax]

ssc show log [-date [yyyy/mm/dd] [hh:mm:ss]] [-days Number] [-level LogLevel] [-category <user |policy | system>] [-eventnum EventNumber] [-jobid JobID] [-ip IPAddress] [-username UserName] [-all] [-format <csv|json>] [-vertical]

[Parameters and Options]

[-date [yyyy/mm/dd][hh:mm:ss]]

Specify the date and time of the base point from which the logs are started.The maximum number of logs to display is 100.If you do not specify the time (hour, minute, and second), 00:00:00 is specified.If you do not specify the date, the date that executes command is specified.If you do not specify -date, the date that executes command is specified as the base point.This option cannot be specified simultaneously with the -all option.

[-days Number] Specify the number of days of the logs you want to display.A positive number indicates the number of days after the date specified in -date to be thebase point.A negative number indicates the number of days before the date specified in -date to be thebase point.0 is regarded as -1.The default value is "-3".This option cannot be specified simultaneously with the -all option.

[-level LogLevel] Specify a log level.The levels of the logs to be displayed are the specified level and above.You can specify one of the following level:"fatal", "error", "warning", "normal", "detail", or "trace".

[-category <user |policy | system>]

Specify an Event Category.If you do not specify -category, all the Event Categories are specified.The Event Categorires which can be designated are as follows:user : User is designated.policy  : Policy is designated.system : System is designated.

[-eventnumEventNumber]

Specify an EventNumber.EventNumber : Event is designated.This option cannot be specified simultaneously with the -all option or -joid option.

[-jobid JobID] Specify the JobID.

Chapter 4. Command for Maintenance

269 SigmaSystemCenter 3.5 ssc Command Reference

Page 280: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

JobID : JobID is designated.This option cannot be specified simultaneously with the -all option or -eventnum option.

[-ip IPAddress] Specify an IPAddress.You can specify an IP address only when the -category option is "user".This option cannot be specified with -all simultaneously.

[-usernameUserName]

Specify a UserName.You can specify a user name only when the -category option is "user".This option cannot be specified -all simultaneously.

[-all] Displays all Operations logs.

[-format <csv|json>] Specify a fomart.You can specify one of the following fomarts:csv : information is displayed in the CSV format.json : information is displayed in the JSON format.If you do not specify this option, the displaying is separated by spaces.This option cannot be specified with -vertical simultaneously.

[-vertical] Specify format.

[Syntax examples]

>ssc show log >ssc show log –date "2008/10/14 09:00:00" –days –1 >ssc show log –date "2008/10/14" –days –1 –level error >ssc show log -category user system >ssc show log -eventnum SY00002 >ssc show log -jobid 00001 >ssc show log –all >ssc show log -format csv

4.2 Policy4.2.1 Exporting Policy

Exports policy information to an XML file.

[Syntax]

ssc export policy FileName PolicyName[…] [-template]

[Parameters and Options]

FileName(Required)

Specify an XML file name to which you are to output policy information.If you specify -template, specify an XML file name that outputs action template data.If a path of a file name includes a space, you need to surround the name in double quotation marks(").If you do not specify a path, but a file name, a file is created in a folder where the command is run.

PolicyName(Required)

Specify a target policy name.If you specify -template, specify an action template name.

[-template] Outputs an action template data.

Chapter 4. Command for Maintenance

270 SigmaSystemCenter 3.5 ssc Command Reference

Page 281: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax examples]

>ssc export policy C:/work/policy1.xml policyA1 >ssc export policy C:/work/policy2.xml "policy B1" "policy B2" >ssc export policy "C:/Documents and Settings/users/template.xml" template1 template2 -template

4.2.2 Importing PolicyImports policy information from an XML file.

[Syntax]

ssc import policy FileName [-template]

[Parameters and Options]

FileName(Required)

Specify an XML file name from which you intend to import policy information.If you specify -template, specify an XML file name of action template data.If a path of a file name includes a space, you need to surround the name in double quotation marks (").If you specify only a file name, a file in Current Folder of when you run this command becomes atarget.

[-template] Imports an action template data from an XML file.

[Note]

• Do not import the XML file of the policy information which is exported from any other versionsthan this one.

In case of importing the policy information of the different version, even if the commandsucceeds, the policy may not operate properly.

[Syntax examples]

>ssc import policy C:/work/policy1.xml >ssc import policy policy2.xml >ssc import policy "C:/Documents and Settings/users/template.xml" -template

4.3 Maintenance4.3.1 Maintaining Configuration Information

Executes maintenance of the configuration database.

To change the configuration database, we recommend stopping SystemProvisioning.

[Syntax]

ssc maintenance cmdb [-recoverymodel <simple | full>] [-defrag Average] [-shrinkdata]

[-shrinklog] [-all] [-tbl]

[Parameters and Options]

[-recoverymodel <simple| full>]

Configure the recovery model of the database.simple : Simple recovery model (recommended)

Chapter 4. Command for Maintenance

271 SigmaSystemCenter 3.5 ssc Command Reference

Page 282: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

full: Complete recovery model

[-defrag Average] Resolves fragmentation of tables whose fragmentation rates are over the rate specifiedin Average.Specify from 0 to 99 in Average.To execute the resolution to all tables, specify 0.

[-shrinkdata] Compresses size of data files.

[-shrinklog] Compresses size of log files.Specify this option if size of log files exceeds thethreshold value (300 MB or greater).

[-all] Displays the detailed information of database (such as the path of the log file).

[-tbl] This option is enabled if "-all" option is specified.Displays the fragmentation rate of tables.

You cannot specify -recoverymodel, -defrag, -shrinkdata, or -shrinklog at the same time.

If you do not specify an option, information of the configuration database is displayed.

[Syntax examples]

>ssc maintenance cmdb -recoverymodel simple >ssc maintenance cmdb -defrag 0 >ssc maintenance cmdb -defrag 80 >ssc maintenance cmdb -shrinkdata >ssc maintenance cmdb -shrinklog

[Display examples]

• without option

>ssc maintenance cmdb

[Cmdb Information] Datafile Name : PVMINF Allocate Size : 142.19 MB

Secondary Name : pvminf_2 Allocate Size : 40.00 MB

Logfile Name : PVMINF_log Allocate Size : 83.88 MB

RecoveryModeType : Simple

• -all

>ssc maintenance cmdb -all

[Cmdb Information] #---- Database Name : pvminf

Datafile Name : PVMINF Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/PVMINF.mdf Allocate Size : 142.19 MB Unallocated Size : 122.75 MB

Chapter 4. Command for Maintenance

272 SigmaSystemCenter 3.5 ssc Command Reference

Page 283: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Unallocated Ratio : 86.33 %

Secondary Name : pvminf_2 Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/pvminf_2.ndf Allocate Size : 40.00 MB Unallocated Size : 0.44 MB Unallocated Ratio : 1.09 %

Logfile Name : PVMINF_log Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/PVMINF_log.LDF Allocate Size : 83.88 MB Unallocated Size : 75.08 MB Unallocated Ratio : 89.52 %

#---- Database Name : tempdb

Datafile Name : tempdev Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/tempdb.mdf Allocate Size : 2.19 MB Unallocated Size : 0.81 MB Unallocated Ratio : 37.14 %

Logfile Name : templog Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/templog.ldf Allocate Size : 0.50 MB Unallocated Size : 0.25 MB Unallocated Ratio : 49.60 %

RecoveryModeType : Simple

• -all -tbl

>ssc maintenance cmdb -all -tbl

[Cmdb Information] #---- Database Name : pvminf

Datafile Name : PVMINF Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/PVMINF.mdf

Allocate Size : 142.19 MB Unallocated Size : 122.75 MB Unallocated Ratio : 86.33 %

Secondary Name : pvminf_2 Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/pvminf_2.ndf Allocate Size : 40.00 MB Unallocated Size : 0.44 MB Unallocated Ratio : 1.09 %

Chapter 4. Command for Maintenance

273 SigmaSystemCenter 3.5 ssc Command Reference

Page 284: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

Logfile Name : PVMINF_log Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/PVMINF_log.LDF Allocate Size : 83.88 MB Unallocated Size : 75.08 MB Unallocated Ratio : 89.52 %

#---- Database Name : tempdb Datafile Name : tempdev Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/tempdb.mdf Allocate Size : 2.19 MB Unallocated Size : 0.81 MB Unallocated Ratio : 37.14 %

Logfile Name : templog Location : c:/Program Files/Microsoft SQL Server/MSSQL.1/MSSQL/DATA/templog.ldf Allocate Size : 0.50 MB Unallocated Size : 0.25 MB Unallocated Ratio : 49.60 %

RecoveryModeType : Simple [Cmdb Table Fragmentation Average]

Table Name Fragmentation Average --------------------------------------------------------- TBL_EventHistory 99.93 TBL_EventAction 99.23 TBL_Parts 98.87 TBL_ManagementLogHistory 98.50 TBL_PartsGroupRelation 95.51 TBL_DiskPartition 91.67 TBL_PartsGroup 91.30 TBL_DiskVolume 90.00 TBL_Machine 89.61 TBL_ManagerRelation 86.41 TBL_PhysicalGroupRelation 83.33 TBL_Scenario 80.00 TBL_PolicySetting 75.00 TBL_DeployHistory 75.00 TBL_DevicePort 66.67 TBL_PolicyParameters 66.67 TBL_Manager 66.67 TBL_DiskControllerRelation 66.67 TBL_ScenarioRelation 50.00 TBL_PolicyAction 50.00 TBL_DiskController 27.27 TBL_ExtendedParameter 22.22

TBL_Acl 0.00 TBL_InstalledSoftware 0.00 TBL_ComputerSystemProfile 0.00 TBL_AccessControl 0.00 TBL_NetworkDeviceRelation 0.00

Chapter 4. Command for Maintenance

274 SigmaSystemCenter 3.5 ssc Command Reference

Page 285: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

TBL_DatabaseVersion 0.00 TBL_DeviceRouting 0.00 TBL_RoutingRelation 0.00 TBL_ComputerSystemProfileRelation 0.00 TBL_Protocol 0.00 TBL_DomainDefinition 0.00 TBL_SmartGroupCondition 0.00 TBL_VirtualNetworkDefinition 0.00 TBL_NameServerDefinition 0.00 TBL_VolumeGroup 0.00 TBL_Policy 0.00 TBL_MachineSettings 0.00 TBL_GroupRelation 0.00 TBL_Reservation 0.00 TBL_CmdbConvertLog 0.00 TBL_Duplicate 0.00 TBL_VolumeGroupRelation 0.00 TBL_LogicalDiskRelation 0.00 TBL_PolicyRelation 0.00 TBL_PoolMachineRelation 0.00 TBL_DiskVolumeRelation 0.00 TBL_SensorGroup 0.00 TBL_ScenarioImage 0.00 TBL_DiskPartitionRelation 0.00 TBL_Sensor 0.00 TBL_GeneralParameter 0.00 TBL_PhysicalGroup 0.00 TBL_License 0.00 TBL_NetworkDevice 0.00 TBL_Tag 0.00 TBL_LoadBalancerGroup 0.00 TBL_DeviceVlan 0.00 TBL_DeviceVlanRelation 0.00 TBL_ScenarioImageRelation 0.00 TBL_EventActionParameter 0.00 TBL_PortRelation 0.00 TBL_VlanGroup 0.00 TBL_ResourceAllocationBase 0.00 TBL_NicTeaming 0.00 TBL_NicTeamingRelation 0.00 TBL_AclRelation 0.00 TBL_ServerGroup 0.00 TBL_NetworkProfile 0.00 TBL_LoadBalancerGroupRelation 0.00 TBL_LinkAggregation 0.00 TBL_PlacementRestriction 0.00 TBL_ServerDefinition 0.00 TBL_LinkAggregationRelation 0.00 TBL_StorageProfile 0.00 TBL_AccessLink 0.00 TBL_DiskArray 0.00 TBL_IpAddressDefinition 0.00 TBL_MachineAccount 0.00 TBL_UserAccount 0.00

4.3.2 Deleting Distribution HistoryDeletes histories that are before distributing the latest OS image.

Chapter 4. Command for Maintenance

275 SigmaSystemCenter 3.5 ssc Command Reference

Page 286: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Syntax]

ssc delete history <[-all] | [-path Path [-host HostName]]>

[Parameters and Options]

[-all] Targets all machines.

[-path Path] Specify the full path of the target.You can omit View Type ("operations:/").If you omit View Type, the specified path is treated as the path to the Operation view.E.g.:When specifying a group name:Category/GroupWhen specifying a host name:Category/Group/HostWhen specifying a resource machine name:resource:/MachineGroup/Machine-A

[-host HostName] Specify the host name of the target.If you specify this option, specify the operation group for Path.Specify this option if there is a model with the same name as the target host.

[Syntax examples]

>ssc delete history -path Category/Group >ssc delete history -path operation:/Category/Group/Host >ssc delete history -path resource:/MachineGroup/Machine-A

4.3.3 Updating Status of MachinesUpdates the status of the machine as specified.

[Syntax]

ssc set-machine-status mode <-name Machine... | -path Path... | -uuid UUID... | -mac MAC...>

[Parameters and Options]

mode(Required)

Specify the status to be set.Multiple parameters can be specified and combined.Description in brackets () indicates the abbreviation for the parameter.If "+" ("-") is specified at the beginning, it means to be set (reset).If it is not specified, it means to be set.+ : Set the status.- : Reset the status.maint (m) : Set the Maintenance mode.-error (-e) : Reset the job result ("+" is invalid).degrade (d) : Set the degraded status.fault (f) : Set the faulted status.resethw (r) : Reset the degraded status or the faulted status (Both "+" and "-" are invalid).-notifyhw (-n) : Reset change notice of hardware status.("+" is invalid)

Chapter 4. Command for Maintenance

276 SigmaSystemCenter 3.5 ssc Command Reference

Page 287: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

<-nameMachine... | -path Path... | -uuid UUID... | -mac MAC...>(Required)

Specify the target to be set.One of the following must be specified: -name, -path, -uuid, and -mac.Multiple parameters can be specified.-name : Specify the name of the machine.-path : Specify the path to the target.E.g.)When specifying a machine, specify as follows: Operations view:  operations:/Category/Group/Machine Resource view:  resource:/Group/Machine  Group/Machine Virtual view:  virtual:/VC/DC/VMS/VMWhen specifying a group or a rack, specify as follows: Resource view:  resource:/Group/Rack  Group/Rack Operations view:  operations:/Category/GroupYou can omit the View Type ("resource:/").About specification of a path, refer to "1.1.5 About Path and GroupPath Specification (page11)".-uuid : Specify the uuid of the machine.-mac : Specify the primary mac address of the machine.

[Note]

• Specify the -degrade option to reset the degraded status.

• Specify the -fault option to reset the faulted status.

• Specify the resethw option to reset the degraded status or the faulted status.

• The options for the setting / cancellation cannot be specified at the same time.

For example, the resethw option cannot be specified with the fault option. Also, the -maintoption cannot be specified with the +maint option.

• If you omit the View when specifying -path, the specified path is treated as the path to theResource view.

[Syntax examples]

1) If you change the status of a target machine to set the Maintenance mode and fault condition: >ssc set-machine-status +m +f -path resource:/vmsgroup/vms001 >ssc set-machine-status +m +f -path operation:/category1/vmsgroup/model1/vms001

2) If you change the status of a target machine to reset the Maintenance mode and reset job result and clear failure condition: >ssc set-machine-status -m -e r -name machine1 machine2

Chapter 4. Command for Maintenance

277 SigmaSystemCenter 3.5 ssc Command Reference

Page 288: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

4.3.4 Updating Status of DevicesChange the status of a custom object, network resource and a storage resource.

[Syntax]

ssc set-object-status Mode <-name Name | -id Identifier>

[-type <networkdevice | diskarray | diskvolume | storagepool | customobject>]

[Parameters and Options]

Mode(Required)

Specify status to be set.Multiple parameters can be specified and combined.Description in brackets () indicates the abbreviation for the parameter.If "+" ("-") is specified at the beginning, it means to be set (reset).If it is not specified, it means to be set.+ : Set- : Resetdegrade (d) : Set degraded status.fault (f) : Set faulted status.resethw (r) : Reset degraded status or faulted status (Both "+" and "-" are invalid).

<-name Name | -id Identifier> Specify a target to be set.One of the following must be specified: -name and -id.Multiple parameters can be specified.-name : Specify the name of the target.-id : Specify the ID of a custom object.

[-type <networkdevice |diskarray | diskvolume |storagepool | customobject>]

Specify the type of the target.If omitted, "customobject" is specified."networkdevice": physical switch or load balancer"diskarray": disk array"diskvolume": disk volume"diskvolume": disk volume"storagepool": storage pool"customobject": custom object

[Syntax examples]

>ssc set-object-status +fault -name Switch01 >ssc set-object-status -fault -name 192.168.11.101 -type switch >ssc set-object-status resethw -id 192.168.11.101

4.3.5 Deleting Information of DPMDeletes information of DPM.

[Syntax]

ssc dpminformation delete -machine <MachineName... | UUID... | MAC... | Path...> [-force]

[Parameters and Options]

-machine<MachineName... |

Deletes the machine-specific information on the Deployment Manager of a specifiedmachine.(It's possible to designate more than one machine)

Chapter 4. Command for Maintenance

278 SigmaSystemCenter 3.5 ssc Command Reference

Page 289: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

UUID... | MAC... |Path...>(Required)

Specify the target machine name, the UUID, the primary MAC address, or the full path.When specifying the full path, omit View Type("resource:/").If you omit View Type, the specified path is regarded as the path to the Resource view.E.g.When specifying the machine nameMachine1When specifying the full pathresource:/rack1/Group1/Machine1operation:/Category1/Group1/Model1/Machine1virtual:/VC1/DataCenterA/ESX01/VM1When omitting the "-force" optionThe information of a running machine cannot be deleted.The information of a virtual machine cannot be deleted.About specification of a path, refer to "1.1.5 About Path and GroupPath Specification(page 11)".

[-force] Deletes the information of DPM forcedly.

[Syntax examples]

>ssc dpminformation delete -machine machine1 machine2 >ssc dpminformation delete -machine AFFBAA22-5BC0-46dd-9777-AD268A366589 >ssc dpminformation delete -machine FF-A0-B0-5A-35-FF >ssc dpminformation delete -machine resource:/rack1/Group1/Machine1 >ssc dpminformation delete -machine machine1 -force

4.3.6 Encoding of dataEncodes specified data.

[Syntax]

ssc encrypt-string Data

[Parameters and Options]

Data(Required)

Specify the data for encode.

[Syntax examples]

>ssc encrypt-string "Encode data"

4.4 MachineAccessHistory4.4.1 Displaying the Detail Information ofMachineAccessHistory

Displays MachineAccessHistory detail information.

[Syntax]

ssc changehistory show [GroupName | -name MachineName | -uuid UUID] [-ghost] [-rev <REV |REV-REV>] [-latest] [-profile [Type]] [-vertical]

Chapter 4. Command for Maintenance

279 SigmaSystemCenter 3.5 ssc Command Reference

Page 290: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[Parameters and Options]

[GroupName] Specify a group name.The history of the machine running in the specified group is displayed.

[-name MachineName] Specify a machine name.

[-uuid UUID] Specify the UUID of a machine.

[-ghost] With this option specified, the history of the deleted machine is displayed.

[-rev <REV | REV-REV>] Specify a revision of the history.You can specify the specific revision number alone (for example, you specify "0");or you can specify the range of the revision numbers (for example, you specify "0-5").

[-latest] Only the latest edition of the history is output.

[-profile [Type]] Profile information is also acquired.Specify a from the following Types:standard : Displays the CPU and memory information.network : Displays the network information.storage : Displays the storage information.all : Displays all information.If you can omit this option when Standard information.Multiple parameters can be specified.

[-vertical] Specify the format. (item : value)If you do not specify this option, the information is displayed in the CSV format.

[Syntax examples]

>ssc changehistory show >ssc changehistory show -name MachineA -latest >ssc changehistory show -ghost >ssc changehistory show -uuid 30381C00-D797-11DD-0000-001697A70000 -profile

[Note]

• The contents of this command might be changed in the next version.

4.4.2 Deleting MachineAccessHistoryDeletes the MachineAccessHistory.

[Syntax]

ssc changehistory delete <-charged | -old Days | -ghost>

[Parameters and Options]

-charged All histories that are already charged are deleted.

-old Days The history older than the designated number of days is deleted.When specifying this parameter along with "-ghost", all historieswhich correspond to one of conditions are deleted.

-ghost All histories of the eliminated machine are deleted.

[Syntax examples]

Chapter 4. Command for Maintenance

280 SigmaSystemCenter 3.5 ssc Command Reference

Page 291: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

>ssc changehistory delete -charged >ssc changehistory delete -old 3 >ssc changehistory delete -ghost

4.4.3 Setting the Environment Settings ofMachineAccessHistory

Sets operation settings for MachineAccessHistory.

[Syntax]

ssc changehistory set [-manual | -disabled | <-auto | -notuseddelete> [-keepdays Day]]

[Parameters and Options]

-manual MachineAccessHistory is not deleted without an instruction.

-disabled MachineAccessHistory is saved minimally.

-auto Unused MachineAccessHistory is deleted automatically after a certain period of time.

-notuseddelete MachineAccessHistory of deleted machines are deleted automatically after a certain period oftime.

[-keepdays Day] Specify a number of days for which unused MachineAccessHistory is kept automatically.

• Without specifying these options, the current status is displayed.

[Syntax examples]

>ssc changehistory set >ssc changehistory set -manual >ssc changehistory set -disabled >ssc changehistory set -auto >ssc changehistory set -notuseddelete -keepdays 0

4.5 Exporting (Backing up)/Importing (Restoring)of SSC Configuration Information4.5.1 Exporting (Backing up) SSC configuration Information

Exports (Backs up) the SSC configuration information.

[Syntax]

ssc config-export ComponentName [-f filename]

[-d directory] [-o option] [-s]

[Parameters and Options]

ComponentName(Required)

Specify the name of the component.pvm: SystemProvisioningdpm: DeploymentManagersysmon: System Monitor - Performance Monitoring Services(example: ssc config-export pvm dpm)Specify "all" to export all components.(example: ssc config-export all)

Chapter 4. Command for Maintenance

281 SigmaSystemCenter 3.5 ssc Command Reference

Page 292: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

[-f filename] Specify the exporting file name with the .zip extension.If filename contains spaces, it must be enclosed in double quotation marks ( " ).If the existing file is specified, it is overwritten.filename cannot contain directory.If the [-f] option is not specified, the file "MachineName_ComponentName_DateTime.zip" isgenerated automatically.(example: Computer1_PVM_20130625_013015.zip)

[-d directory] Set the directory of the file.If the [-d] option is not specified, the file is stored in the current directory.(example: ssc config-export pvm -d c:/tmp)

[-o option] Select the type of configuration files.db: Databasereg: Registryfile: Configration file(example: ssc config-export pvm -o db file)

[-s] By using this option, the components that are running services can be exported.(example: ssc config-export pvm -s)

[Note]

• Stop all services of the target component. By using the -s option, the configuration can beexported even though the services are running, but the exported files could be inconsistent.

• The clustered environment is not supported.

• This command has the following restrictions on the database.

- Exporting remotely connected databases is not supported.

- SQL Server authentication is not supported.(Windows authentication only)

- PostgreSQL is not supported.

- If the database settings in installation of SystemProvisioning and SystemMonitor –Performance Monitoring Services are different, SystemMonitor – Performance MonitoringServices database export is not supported.

[Syntax examples]

>ssc config-export pvm >ssc config-export pvm -s >ssc config-export all -f all.zip >ssc config-export all -d c:/temp >ssc config-export all -f all.zip -d c:/temp >ssc config-export all -o db file

4.5.2 Importing (Restoring) SSC configuration InformationImports (Restores) the SSC configuration information.

[Syntax]

ssc config-import ComponentName FileName

[-d directory] [-o option] [-b]

[Parameters and Options]

Chapter 4. Command for Maintenance

282 SigmaSystemCenter 3.5 ssc Command Reference

Page 293: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

ComponentName(Required)

Specify the name of the component.pvm: SystemProvisioningdpm: DeploymentManagersysmon: System Monitor - Performance Monitoring Services(example: ssc config-import pvm dpm import.zip)Specify "all" to import all components.(example: ssc config-import all import.zip)

FileName(Required)

Specify the file name with the .zip extension.If filename contains spaces, it must be enclosed in double quotation marks ( " ).

[-d directory] Specify the directory of the file.If filename contains spaces, it must be enclosed in double quotation marks ( " ).If the [-d] option is not specified, the file is stored in the current directory.(example: ssc config-import pvm import.zip -d c:/tmp)

[-o option] Select the type of configuration files.db: Databasereg: Registryfile: Configration file(example: ssc config-import pvm import.zip -o db file)

[-b] Export file for backup is not created before import.This is not recommended option because the configuration file is not restored if import failed.

[Note]

• Importing configuration files exported in a different environment, where the installationdirectory or the version of SQL Server is different from the original environment, is notsupported.

• Stop all services of the target component.

• The clustered environment is not supported.

• If the import process failed, the restore file that has been obtained in advance will be importedto automatically return to the state before import.

- The file name for restoring is constructed by appending "Backup_" to the export file name.If a file with the same name exists, it is overwritten.

- The directory path for the restore file is the same as the specified export file.

- If importing the restore file failed, import the database, configuration files and registrymanually in the restoration file.

* For manually importing the configuration information, refer to the Chapter 10,"Backup and Restoration" in NEC SigmaSystemCenter Configuration Guide.

* This command is 32bit application. For manually importing the registry, use theutility in "C:/Windows/SysWOW64".

- If the import process failed, the definition files that did not exist before the import mayremain.

• This command has the following restrictions on the database.

- Importing remotely connected databases is not supported.

- SQL Server authentication is not supported. (Windows authentication only)

Chapter 4. Command for Maintenance

283 SigmaSystemCenter 3.5 ssc Command Reference

Page 294: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

- PostgreSQL is not supported.

- If the database settings in installation of SystemProvisioning and SystemMonitor –Performance Monitoring Services are different, SystemMonitor – Performance MonitoringServices database import is not supported.

[Syntax examples]

>ssc config-import all import.zip >ssc config-import pvm dpm import.zip >ssc config-import all import.zip -b >ssc config-import all import.zip -d c:/temp >ssc config-import all import.zip -o db file >ssc config-import all import.zip -o db file -d c:/temp

4.6 Output Report4.6.1 Creating Report

Creates a report file.

[Syntax]

ssc create report TargetPath [-definition ReportDefinitionFile] [-output ReportFile] [-startPerformanceStartTime] [-period PerformancePeriod] [-interval PerformanceInterval]

[Parameters and Options]

TargetPath(Required)

Specify the path of the target group / tenant / category / host.

[-definitionReportDefinitionFile]

Specify the name or ID of report definition file.

[-output ReportFile] Specify the output report file name.

[-start PerformanceStartTime] Specify the start time of performance data to output.If omitted, it will be the PerformancePeriod time ago from the current time.Format: [yyyy/mm/dd] hh:mm[:ss]

[-period PerformancePeriod] Specify the period of performance data to output.If omitted, it will be the period from PerformanceStartTime to the current time.If both PerformancePeriod and PerformanceStartTime are omitted, it will be 7days (from 7 days ago to the current time).Format: d | [d.]hh:mm[:ss]

[-interval PerformanceInterval] Specify the time interval between each performance data.If omitted, it will be 15 minutes.Format: d | [d.]hh:mm[:ss]

[Syntax examples]

>ssc create report category/vmsgroup >ssc create report category/vmsgroup -period 10.00:00:00 -interval 00:30 >ssc create report category/vmsgroup -definition rd1.xml -start "2016/1/1 00:00" -interval 00:30

Chapter 4. Command for Maintenance

284 SigmaSystemCenter 3.5 ssc Command Reference

Page 295: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

IndexAadd ipaddress..........................................................83add lb....................................................................145add license..............................................................22add manager........................................................... 29add storage............................................................. 93add vmserver........................................................203add-relate object...................................................198apikey create........................................................ 190apikey delete........................................................ 191apikey show......................................................... 191apikey update....................................................... 191assign diskvolume................................................108assign external-resource.......................................201assign machine....................................................... 33

Cchange-passwd................................................ 24,205changehistory delete.............................................280changehistory set..................................................281changehistory show..............................................279clone machine...................................................... 224collect.....................................................................30config-export........................................................281config-import....................................................... 282create datastore.....................................................254create diskvolume................................................ 102create group............................................................55create host.............................................................. 76create machine..................................................... 208create object......................................................... 197create report......................................................... 284create smartgroup.................................................157create template..................................................... 228create user.............................................................. 23customproperty add..............................................192customproperty delete..........................................193customproperty show........................................... 195

Ddatacenter add...................................................... 203datastorefile show................................................ 257delete datastore.....................................................255delete diskvolume................................................ 107delete group............................................................63delete history........................................................276delete host.............................................................. 79delete ipaddress......................................................84

delete lb................................................................145delete license..........................................................22delete machine..................................................... 222delete object......................................................... 198delete smartgroup.................................................165delete software....................................................... 89delete storage......................................................... 95delete template..................................................... 233delete user.............................................................. 24delete vmserver.................................................... 204delete-relate object............................................... 200dependency add......................................................82dependency create-setting......................................80dependency delete..................................................83dependency delete-setting......................................81dependency show................................................... 83dependency show-setting....................................... 82dependency update-setting.....................................81deploy software......................................................86dpm-location notify................................................75dpminformation delete......................................... 278

Eencrypt-string....................................................... 279evacuate host........................................................226evacuate machine................................................. 206export policy........................................................ 270export smartgroup................................................ 167export template.....................................................234export vm............................................................. 227

Ffirewallprofile add................................................132firewallprofile create............................................131firewallprofile delete............................................132firewallprofile show............................................. 132

Ggroup delete-network........................................... 144group set-network................................................ 143

Hhostprofile create..................................................176

Iimage add............................................................. 235image delete......................................................... 236

285 SigmaSystemCenter 3.5 ssc Command Reference

Page 296: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

image show.......................................................... 237image update........................................................ 236import policy........................................................271import smartgroup................................................168import template.................................................... 234import vm.............................................................228indication register.................................................196indication unregister.............................................196iso mount..............................................................241iso show............................................................... 241iso unmount..........................................................241

Llbgroup create.......................................................146lbgroup delete.......................................................147logicalmachine assign.......................................... 148logicalmachine create-account.............................152logicalmachine create-profile...............................155logicalmachine delete-account.............................153logicalmachine delete-profile...............................156logicalmachine release......................................... 148logicalmachine show............................................149logicalmachine show-account..............................154logicalmachine update-account............................152logicalmachine update-profile............................. 155logicalsoftware add-software................................. 92logicalsoftware create............................................ 90logicalsoftware delete............................................ 91logicalsoftware delete-software............................. 93logicalsoftware show............................................. 91

Mmachine backup..................................................... 45machine chcfg........................................................ 49machine restore...................................................... 46machine-account create..........................................51machine-account delete..........................................53machine-account show...........................................53machine-account update.........................................52machinehistory show............................................. 50maintenance cmdb............................................... 271maintenance machine.............................................48migrate machine...................................................224monitoringprofile add-threshold.......................... 187monitoringprofile create.......................................169monitoringprofile delete.......................................172monitoringprofile delete-threshold...................... 189monitoringprofile export......................................186monitoringprofile import..................................... 186monitoringprofile set............................................175monitoringprofile show........................................172monitoringprofile update..................................... 171

monitoringprofile update-threshold..................... 188mount datastore....................................................257move machine...................................................... 225

Nnetwork add-addresspool..................................... 136network add-firewallsetting................................. 139network add-router...............................................140network add-router-if........................................... 141network add-router-rt........................................... 142network add-static-rt............................................ 138network add-virtualbridge....................................140network add-vlan................................................. 135network apply.......................................................134network create......................................................133network delete......................................................134network delete-addresspool................................. 137network delete-firewallsetting............................. 139network delete-router........................................... 141network delete-router-if....................................... 142network delete-router-rt....................................... 143network delete-static-rt........................................ 138network delete-virtualbridge................................140network delete-vlan..............................................136network show....................................................... 134

Pportgroup create................................................... 124power-control machine.......................................... 44profile create........................................................ 179profile show......................................................... 185

Rrdmstorage show.................................................. 121rdmstorage update................................................ 119reconfigure machine.............................................239recover machine................................................... 205register hardware....................................................47register machine..................................................... 31release diskvolume...............................................109release hba............................................................101release machine......................................................34replace machine..................................................... 74resourcepool create.............................................. 258resourcepool delete.............................................. 261resourcepool set-monitor-setting......................... 261resourcepool show............................................... 259resourcepool show-monitor-setting..................... 263

Sscalein.................................................................... 75

286 SigmaSystemCenter 3.5 ssc Command Reference

Page 297: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

scaleout.................................................................. 75scan datastore....................................................... 255search machine.......................................................50set datastore-setting..............................................256set hba.................................................................. 101set hostprofile.........................................................70set profile............................................................... 64set-machine-status................................................276set-object-status....................................................278show datastore......................................................250show diskarray....................................................... 99show diskarraypath................................................ 96show diskvolume..................................................111show group.............................................................64show host............................................................... 80show lb................................................................. 146show log............................................................... 269show machine.........................................................37show object.......................................................... 198show osservice..................................................... 267show smartgroup..................................................166show software........................................................ 90show storagepool..................................................116show storagetopology.......................................... 121show user............................................................... 24show vlan............................................................. 124snapshot create..................................................... 237snapshot delete..................................................... 238snapshot revert..................................................... 239snapshot show...................................................... 239snapshot update....................................................238startup-collect-mode.............................................. 28sync ldapuser..........................................................25

Ttemplate update.................................................... 231

Uunmount datastore................................................258unregister machine................................................. 32update datastore................................................... 255update diskarray..................................................... 95update diskvolume............................................... 105update environment................................................26update group...........................................................59update host............................................................. 78update machine...................................................... 42update object........................................................ 197update osservice................................................... 267update storagepool............................................... 114update vmproperty............................................... 215update vmserver................................................... 204

Vvirtualnetwork delete........................................... 144vlan create............................................................ 123vlan delete............................................................ 123vm create..............................................................210vmop add-member............................................... 248vmop apply-position............................................ 266vmop apply-rule................................................... 245vmop create-group............................................... 247vmop delete-group............................................... 248vmop delete-position............................................264vmop delete-rule.................................................. 243vmop disable-rule.................................................245vmop enable-rule................................................. 244vmop remove-member......................................... 249vmop set-position.................................................263vmop set-rule....................................................... 242vmop show-group................................................ 249vmop show-position.............................................265vmop show-rule................................................... 245vmop verify-rule.................................................. 247vtn show............................................................... 131vxlan show........................................................... 131

287 SigmaSystemCenter 3.5 ssc Command Reference

Page 298: NEC SigmaSystemCenter 3.6 ssc Command Reference · Contents Chapter 1. About ssc Command ..... 1 1.1 ssc Command.....2

SigmaSystemCenter 3.6ssc Command Reference

SSC0306-doc-0037

August, 2017 1 Edition

NEC Corporation

©NEC Corporation 2003-2017