Pillar Axiom CLI tutorial - axiomclu pdscli
| Topic ID: 2736 | |
| Created By: | 2007-NOV-09 16:03:14 [Vitaliy] |
| Updated By: | 2007-NOV-09 18:40:36 [Vitaliy] |
| Status: | Open |
| Severity: | Normal |
| Read Only: | No |
|
8499
2007-NOV-09 16:03:14
|
||||
|
Download CLI tar file to your UNIX workstation
zephir.10GR2-> cd pillar_cli/ zephir.10GR2-> ls -lta total 4180 -rw-r--r-- 1 oracle dba 2128108 Nov 9 13:53 axiomclu-solaris-sparc10.tgz drwxr-xr-x 2 oracle dba 512 Nov 9 13:53 . drwxr-xr-x 4 oracle dba 512 Nov 9 13:52 .. zephir.10GR2-> zephir.10GR2-> gunzip axiomclu-solaris-sparc10.tgz zephir.10GR2-> ls -lta total 22004 drwxr-xr-x 2 oracle dba 512 Nov 9 14:05 . -rw-r--r-- 1 oracle dba 11249152 Nov 9 13:53 axiomclu-solaris-sparc10.tar drwxr-xr-x 4 oracle dba 512 Nov 9 13:52 .. zephir.10GR2-> zephir.10GR2-> tar xvf axiomclu-solaris-sparc10.tar ... ... x ./xml/Accounts/CreateAccountResponse.xml, 922 bytes, 2 tape blocks x ./xml/MCCRequest.xsd, 203525 bytes, 398 tape blocks x ./xml/MCCResponse.xsd, 306754 bytes, 600 tape blocks x ./pdscli, 8336988 bytes, 16284 tape blocks zephir.10GR2->
Create config file
zephir.10GR2-> ./pdscli help environment Pillar Data Systems Command Line Interface Utility (pdscli) Version 020700-003600 Copyright (c) 2003, 2004, 2007 Pillar Data Systems, Inc. All rights reserved Environment Variables: PDS_CONFIG: <not set> PDS_TMPDIR: <not set> PDS_HOST: <not set> PDS_PORT: <not set> PDS_RAWSOCKET: <not set> PDS_TIMEOUT: <not set> PDS_ASYNC: <not set> PDS_USER: <not set> PDS_PASSWORD: <not set> PDS_SESSIONKEY: <not set> PDS_TRACEFILE: <not set> PDS_TRACEITEM: <not set> TMPDIR: <not set> zephir.10GR2-> zephir.10GR2-> ./pdscli help environment > cli.cfg zephir.10GR2-> ## edit config file ## zephir.10GR2-> vi cli.cfg -------- edit as follows ------- PDS_CONFIG=/u01/app/oracle/work/pillar_cli/cli.cfg PDS_HOST=198.206.180.175 PDS_USER=administrator PDS_PASSWORD=secretpass ## create session key and save it in cli.cfg ## zephir.10GR2-> ./pdscli startsession -u administrator -p secretpass -H 198.206.180.175 a5aa78cdf2976afff11b6b9223c611c8 zephir.10GR2-> echo "PDS_SESSIONKEY=a5aa78cdf2976afff11b6b9223c611c8" >> cli.cfg zephir.10GR2-> cat cli.cfg PDS_CONFIG=/u01/app/oracle/work/pillar_cli/cli.cfg PDS_HOST=198.206.180.175 PDS_USER=administrator PDS_PASSWORD=secretpass PDS_SESSIONKEY=a5aa78cdf2976afff11b6b9223c611c8
Examples Of Using The CLI
## NOTE:
## before calling pdscli make sure to:
##
## - set PDS_CONFIG (for example):
##
## PDS_CONFIG=/u01/app/oracle/work/pillar_cli/cli.cfg; export PDS_CONFIG
##
## - create PDS_SESSIONKEY (this should last you for the duration of multiple commands):
##
## zephir.10GR2-> ./pdscli startsession -u administrator -p secretpass -H 198.206.180.175
## a5aa78cdf2976afff11b6b9223c611c8
##
## - modify cli.cfg config file with your current session id (example):
##
## zephir.10GR2-> grep PDS_SESS /u01/app/oracle/work/pillar_cli/cli.cfg
## PDS_SESSIONKEY=a5aa78cdf2976afff11b6b9223c611c8
##
zephir.10GR2-> PDS_CONFIG=/u01/app/oracle/work/pillar_cli/cli.cfg; export PDS_CONFIG
zephir.10GR2-> ./pdscli request GetHostMappingConfigDetails SANHostName=eros
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T15:38:01-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetHostMappingConfigDetailsResponse
HostMappingConfigDetails[1]
LUNMapping[1]
LUNID: ID9837ce02-d21d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-P-C1-L6
MappingInformation
LUNNumber: 6
ExcludePortList
LUNMapping[2]
LUNID: ID183e720b-d21d-b211-8b57-000e0cc45de5
LUNFQN: /Eros-M-C1-L1
MappingInformation
LUNNumber: 1
ExcludePortList
LUNMapping[3]
LUNID: ID0efda12b-d21d-b211-8b57-000e0cc45de5
LUNFQN: /Eros-M-C0-L2
MappingInformation
LUNNumber: 2
ExcludePortList
LUNMapping[4]
LUNID: ID98cbd648-d21d-b211-8b57-000e0cc45de5
LUNFQN: /Eros-M-C1-L3
MappingInformation
LUNNumber: 3
ExcludePortList
LUNMapping[5]
LUNID: ID98a44a50-d21d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-L-AU-L7
MappingInformation
LUNNumber: 7
ExcludePortList
LUNMapping[6]
LUNID: ID9836496f-d21d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-M-AU-L8
MappingInformation
LUNNumber: 8
ExcludePortList
LUNMapping[7]
LUNID: ID98f0b27c-d21d-b211-8b59-000e0cc45de5
LUNFQN: /Eros-A-AU-L10
MappingInformation
LUNNumber: 10
ExcludePortList
LUNMapping[8]
LUNID: ID1821cc9a-d11d-b211-8b59-000e0cc45de5
LUNFQN: /Eros-H-AU-L9
MappingInformation
LUNNumber: 9
ExcludePortList
LUNMapping[9]
LUNID: ID8e51e5b8-d11d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-H-AU-L4
MappingInformation
LUNNumber: 4
ExcludePortList
LUNMapping[10]
LUNID: ID8edd3ecf-d11d-b211-8b57-000e0cc45de5
LUNFQN: /Eros-M-C0-L0
MappingInformation
LUNNumber: 0
ExcludePortList
LUNMapping[11]
LUNID: ID982c63e7-d11d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-P-C0-L5
MappingInformation
LUNNumber: 5
ExcludePortList
zephir.10GR2->
zephir.10GR2-> ./pdscli request GetLUNMappingConfigDetails MappedLUNFQN=/Eros-M-C0-L0
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T15:42:40-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetLUNMappingConfigDetailsResponse
LUNMappingConfigDetails[1]
MappedLUNID: ID8edd3ecf-d11d-b211-8b57-000e0cc45de5
MappedLUNFQN: /Eros-M-C0-L0
HostMapping[1]
SANHostName: eros
MappingInformation
LUNNumber: 0
ExcludePortList
zephir.10GR2->
zephir.10GR2-> ./pdscli request GetAllLUNs > all_luns.txt
zephir.10GR2-> cat all_luns.txt
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T15:46:46-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetAllLUNsResponse
LUNSummary[1]
LUN ID: ID98f0b27c-d21d-b211-8b59-000e0cc45de5
LUNFQN: /Eros-A-AU-L10
LUNName: Eros-A-AU-L10
LUNSerialNumber: 000b080014002056
Mapped: true
Volume Group ID: IDa82ac1e5-d11d-b211-8b27-000e0cc45de5
VolumeGroupFQN: /
SlammerID: ID8a4fc84a-d21d-b211-8b26-000e0cc45de5
SlammerFQN: /Slammer1
InternalActivity
ManagementStatus: Available
Health
Performance: Online
Redundancy: Full
HasPinnedData: false
MediaPlacement
RecommendedAction: KeepMediaPlacement
PriorityBandPlacement[1]
RelativePriority: Archive
PercentInBand: 100.000
PerformanceMetrics
TotalIOsPerSecond: 0.000
ReadIOsPerSecond: 0.000
WriteIOsPerSecond: 0.000
TotalMBPerSecond: 0.000
ReadMBPerSecond: 0.000
WriteMBPerSecond: 0.000
Capacity
CurrentCapacity: 146
Reliability
Redundancy: Standard
LUNSummary[2]
LUN ID: ID8e51e5b8-d11d-b211-8b58-000e0cc45de5
LUNFQN: /Eros-H-AU-L4
LUNName: Eros-H-AU-L4
LUNSerialNumber: 000b08000e002056
Mapped: true
Volume Group ID: IDa82ac1e5-d11d-b211-8b27-000e0cc45de5
VolumeGroupFQN: /
SlammerID: ID8a4fc84a-d21d-b211-8b26-000e0cc45de5
SlammerFQN: /Slammer1
InternalActivity
ManagementStatus: Available
Health
Performance: Online
Redundancy: Full
HasPinnedData: false
MediaPlacement
RecommendedAction: KeepMediaPlacement
PriorityBandPlacement[1]
RelativePriority: High
PercentInBand: 100.000
PerformanceMetrics
TotalIOsPerSecond: 0.000
ReadIOsPerSecond: 0.000
WriteIOsPerSecond: 0.000
TotalMBPerSecond: 0.000
ReadMBPerSecond: 0.000
WriteMBPerSecond: 0.000
Capacity
CurrentCapacity: 8
Reliability
Redundancy: Standard
LUNSummary[3]
LUN ID: ID1821cc9a-d11d-b211-8b59-000e0cc45de5
LUNFQN: /Eros-H-AU-L9
LUNName: Eros-H-AU-L9
LUNSerialNumber: 000b080013002056
Mapped: true
Volume Group ID: IDa82ac1e5-d11d-b211-8b27-000e0cc45de5
VolumeGroupFQN: /
SlammerID: ID8a4fc84a-d21d-b211-8b26-000e0cc45de5
SlammerFQN: /Slammer1
InternalActivity
ManagementStatus: Available
Health
Performance: Online
Redundancy: Full
HasPinnedData: false
MediaPlacement
RecommendedAction: KeepMediaPlacement
PriorityBandPlacement[1]
RelativePriority: High
PercentInBand: 100.000
PerformanceMetrics
TotalIOsPerSecond: 0.000
ReadIOsPerSecond: 0.000
WriteIOsPerSecond: 0.000
TotalMBPerSecond: 0.000
ReadMBPerSecond: 0.000
WriteMBPerSecond: 0.000
Capacity
CurrentCapacity: 8
Reliability
Redundancy: Standard
...
...
...
zephir.10GR2-> ./pdscli request GetAllSlammers
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T15:58:09-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetAllSlammersResponse
SlammerSummary[1]
SlammerID: ID8a4fc84a-d21d-b211-8b26-000e0cc45de5
SlammerFQN: /Slammer1
SlammerName: Slammer1
HardwareComponentStatus: Normal
ServiceType: SAN
InternalActivity
ManagementStatus: Available
ControlUnitSummary[1]
ControlUnitNumber: 0
ControlUnitStatus: Normal
IOPortStatus: Normal
PowerSupplyStatus: Normal
FanStatus: Normal
BatteryStatus: Normal
TemperatureStatus: Normal
ControlUnitWWN: 2008000b08043bd2
ControlUnitSummary[2]
ControlUnitNumber: 1
ControlUnitStatus: Normal
IOPortStatus: Normal
PowerSupplyStatus: Normal
FanStatus: Normal
BatteryStatus: Normal
TemperatureStatus: Normal
ControlUnitWWN: 2009000b08043bda
zephir.10GR2->
zephir.10GR2-> ./pdscli request GetSlammerStatistics ID=/Slammer1
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T15:58:43-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetSlammerStatisticsResponse
SlammerStatistics[1]
Slammer ID: ID8a4fc84a-d21d-b211-8b26-000e0cc45de5
SlammerFQN: /Slammer1
SlammerName: Slammer1
CollectionStartTime: 2007-11-06T17:29:46-08:00
CollectionEndTime: 2007-11-09T15:58:43-08:00
ControlUnit[1]
ControlUnitNumber: 1
NASNetworkInterfaceModule
IPMetrics
TotalPacketsPerSecond: 0.000
PacketsSentPerSecond: 0.000
PacketsReceivedPerSecond: 0.000
SendMBPerSecond: 0.000
ReceiveMBPerSecond: 0.000
TotalBadPacketsSinceActivated: 0
BadPacketsSentSinceActivated: 0
BadPacketsReceivedSinceActivated: 0
LinkAggregationStatus: false
EthernetPortStats[1]
EthernetPortName: PORT0
Duplexing: Half
NegotiatedLinkSpeedInGigabitsPerSecond: 0
EthernetPortStats[2]
EthernetPortName: PORT1
Duplexing: Half
NegotiatedLinkSpeedInGigabitsPerSecond: 0
ControlUnit[2]
ControlUnitNumber: 0
NASNetworkInterfaceModule
IPMetrics
TotalPacketsPerSecond: 0.000
PacketsSentPerSecond: 0.000
PacketsReceivedPerSecond: 0.000
SendMBPerSecond: 0.000
ReceiveMBPerSecond: 0.000
TotalBadPacketsSinceActivated: 0
BadPacketsSentSinceActivated: 0
BadPacketsReceivedSinceActivated: 0
LinkAggregationStatus: false
EthernetPortStats[1]
EthernetPortName: PORT0
Duplexing: Half
NegotiatedLinkSpeedInGigabitsPerSecond: 0
EthernetPortStats[2]
EthernetPortName: PORT1
Duplexing: Half
NegotiatedLinkSpeedInGigabitsPerSecond: 0
zephir.10GR2->
zephir.10GR2-> ./pdscli request GetAllSANHosts
Header
ProtocolVersion: 0.1
SessionKey: 067d512704252e0a345f4950dd3eeec3
Time: 2007-11-09T16:01:19-08:00
ClientData: pdscli
RequestStatus: Succeeded
Error List
GetAllSANHostsResponse
SANHostSummary[1]
SANHostName: eros
NumberOfLUNs: 11
SANHostDriverSummary
Version: 2.0.2
IPAddress: 198.200.180.28
Communicating: true
HPUXAddressing: false
HBAPortSummary[1]
HBAPortName: HBA 0 Port 0
HBAPortWWN: 2100001b320062b0
Connected: true
HBAPortSummary[2]
HBAPortName: HBA 0 Port 1
HBAPortWWN: 2101001b322062b0
Connected: true
zephir.10GR2->
[edited by: Vitaliy at 16:11 (CST) on Nov. 09, 2007]
|
8506
2007-NOV-09 18:07:25
|
||||
|
Hello Vitaliy, Following your GREAT job I will summarize as: 1) Download and unzip pdscli tool; "pdscli will be used to interact with the Pillar storage unit" 2) You setup cli.cfg according to your environment... and the special trick is how to create sessionkey based on host/secret/user; 3) You issued some pdscli commands as: request GetAllLUNs request GetHostMappingConfigDetails SANHostName=eros request GetLUNMappingConfigDetails MappedLUNFQN=/Eros-M-C0-L0 request GetAllSlammers And... by the way... between step (2) and (3) above... did you restart any daemon? Thanks!!! mson77
|
8508
2007-NOV-09 18:34:54
|
||||
|
> And... by the way... between step (2) and (3) above... did you restart any > daemon? > No, no need to restart anything. In fact, you can run pdscli from anywhere - it doesn't have to be on the HOST that is connected to Pillar. As long as you can hit Pillar's pilot via LAN you are all set. I ran pdscli from my Sun Ultra 45 workstation (Solaris 10). - Vitaliy
|
8509
2007-NOV-09 18:38:15
|
||||
|
> No, no need to restart anything. In fact, you can run pdscli from anywhere > - it doesn't have to be on the HOST that is connected to Pillar. As long > as you can hit Pillar's pilot via LAN you are all set. I ran pdscli from > my Sun Ultra 45 workstation (Solaris 10). > > - Vitaliy Thank you Vitaliy! Then PDS should read the cli.cfg file at every command. I guess...! Thank you, mson77
|
8510
2007-NOV-09 18:40:36
|
||||
|
Exactly.