Register a Provider
Providers are physical servers that host objects and attributes. Once a provider is registered in ECX, cataloging, searching, and reporting can be performed.
Supported provider types are:
- Amazon Web Services (AWS). Supported types include Amazon Simple Storage Service (S3) cloud storage.
- DPX provider. Register a Catalogic DPX™ provider to run DPX specific reports pertaining to nodes, storage, and status.
- EMC storage systems. Supported types include EMC VNX.
- IBM storage systems. Supported types include IBM storage and FlashCopy Manager (FCM).
- LDAP servers. Register an LDAP server to enable LDAP users to be provisioned through a group import. LDAP also supports authentication using the sAMAccountName Windows user naming attribute or an associated e-mail address. Unlike storage systems and VMware servers, LDAP servers are not cataloged.
- NetApp storage systems. Supported types include NetApp 7-Mode and Cluster-Mode.
- Oracle application servers. Supported storage platforms include IBM storage systems running IBM Spectrum™ Virtualize Software version 7.3 and later, including IBM SAN Volume Controller, IBM Storwize, and IBM FlashSystem V9000 systems.
- SMTP hosts. Register an SMTP server to enable email notifications from ECX. Unlike storage systems and VMware servers, SMTP servers are not cataloged.
- VMware servers. Supported types includes vCenter and ESX/ESXi hosts.
Adding a provider requires specifying the user name and password of the provider.
Storage providers can be automatically cataloged after registration. If the Catalog provider resources after registration option is selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider.
Note: For ECX 2.2 and later, ensure that TLS protocol is enabled on the NetApp storage system by setting the tls.enable
option to ON. For TLS to take effect on HTTPS, ensure that the httpd.admin.ssl.enable
option is also set to ON. See Enabling or disabling TLS on NetApp's Support site.
BEFORE YOU BEGIN:
- Create a site to assign to your provider. A site is a user-defined grouping of providers that is generally based on location. See Add a Site.
Note: If an associated provider is unregistered before, during, or after a Copy Data or Use Data job executes, the job fails with a task framework error. If the unregistered providers are re-registered in ECX, new Copy Data or Use Data policies must be defined for the providers.
The following describes the procedures for registering a provider.
- Click the Configure tab.
- In the Provider Browser pane, select DPX .
- Right-click DPX. Then click Register . The Register DPX Provider dialog opens.
- Populate the fields in the dialog:
- Name
- A user-defined name for the DPX server. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select LDAP .
- Right-click LDAP . Then click Register . The Register LDAP Server dialog opens.
- Populate the fields in the dialog:
- Name
- A user-defined name for the LDAP Server. Provider names must be unique.
- Host Address
- The IP address or resolvable logical node name of the LDAP server.
- Port
- The port on which the LDAP server is listening. The typical default port is 389 for non SSL connections or 636 for SSL connections.
- Use SSL
- Enable to establish a secure connection to the LDAP server.
- Bind DN
- The name used for authenticating the connection to the LDAP server. ECX supports simple bind.
- Password
- The password associated with the Bind Distinguished Name.
- Base DN
- The location where users and groups can be found.
- User Filter
- A filter to select only those users under the Base DN that match certain criteria. An example of a valid default user filter is cn={0}.
- To enable authentication using the sAMAccountName Windows user naming attribute, set the User Filter to samaccountname={0}.
- To enable authentication using an e-mail address associated with LDAP, set the User Filter to mail={0}.
- Note that this entry also controls the type of user name that appears in ECX display of users.
- User RDN
- The relative distinguished path for the user. Specify the path where user records can be found. An example of a valid default RDN is:
- cn=Users
- Group RDN
- The relative distinguished path for the group. Specify the path where group records can be found if the group is at a different level than the user path.
- Comment
- Optional description.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
- If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select NetApp .
- Right-click NetApp . Then click Register . The Register NetApp dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the NetApp storage system. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Port
- The communications port of the provider you are adding. Select the Use SSL check box to enable an encrypted Secure Socket Layer connection. The typical default port is 80 for non SSL connections or 443 for SSL connections.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Catalog provider resources after registration
- If selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider. Note that the catalog policy may take considerable time to complete.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
Use the Discover feature to find and register multiple NetApp providers by IP address or a range of IP addresses. For example: 172.27.*, 172.27.100.10-172.27.100.200, or 172.27.100.10.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select NetApp .
- Right-click NetApp . Then click Discover. The Discover NetApp Providers dialog opens.
- Enter an IP address or range of IP addresses associated with your NetApp storage systems in the IP Address field. Enter Simple Network Management Protocol settings such as the community name and protocol version in the SNMP Options fields. The default community name is "public."
- Click Discover. Discovered NetApp providers display.
- Select providers to register along with universal custom parameters such as Site, username, and password. To select individual parameters for each provider, click the parameters in the Custom Parameters field. Select specific Sites, credentials, ports and SSL parameters for each provider. If Catalog provider resources after registration is selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider.
- Click Register. ECX adds the providers to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab.
- In the Provider Browser pane, select SMTP .
- Right-click SMTP . Then click Register . The Register SMTP Server dialog opens.
- Populate the fields in the dialog:
- Name
- A user-defined name for the SMTP server. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Port
- The communications port of the provider you are adding. Select the Use SSL check box to enable an encrypted Secure Socket Layer connection. The typical default port is 25 for non SSL connections or 443 for SSL connections.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Click Email Options to set additional SMTP provider options:
- From Address
- Set the address to be associated with email communications from ECX.
- Subject Prefix
- Set a prefix to add to the email subject lines sent from ECX.
- Timeout (msec)
- Set the email timeout value in milliseconds.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
- If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab.
- In the Provider Browser pane, select VMware .
- Right-click VMware . Then click Register . The Register VMware Server dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the VMware server. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Port
- The communications port of the provider you are adding. Select the Use SSL check box to enable an encrypted Secure Socket Layer connection. The typical default port is 80 for non SSL connections or 443 for SSL connections.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Catalog provider resources after registration
- If selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider. Note that the catalog policy may take considerable time to complete.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
To add credentials to a registered virtual machine, see Add Credentials to a Virtual Machine.
Use the Discover feature to find and register multiple VMware providers by IP address or a range of IP addresses. For example: 172.27.*, 172.27.100.10-172.27.100.200, or 172.27.100.10.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select VMware .
- Right-click VMware . Then click Discover. The Discover VMware Providers dialog opens.
- Enter an IP address or range of IP addresses associated with your VMware providers in the IP Address field.
- Click Discover. Discovered VMware providers display.
- Select providers to register along with universal custom parameters such as Site, username, and password. To select individual parameters for each provider, click the parameters in the Custom Parameters field. Select specific Sites, credentials, ports and SSL parameters for each provider. If Catalog provider resources after registration is selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider.
- Click Register. ECX adds the providers to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
To add credentials to a registered virtual machine, see Add Credentials to a Virtual Machine.
Note: To successfully catalog an IBM FCM provider, you must also register associated vCenters and IBM Storage providers.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select IBM or IBM FCM .
- Right-click IBM or IBM FCM Then click Register . The Register dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the IBM provider. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Catalog provider resources after registration
- If selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider. Note that the catalog policy may take considerable time to complete.
- Note: An automatic IBM FCM catalog job fails if associated IBM Storage and vCenter providers are not registered. Ensure associated resources are registered before the automatic catalog job begins.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
Note: IBM providers utilize port 22 for communication with ECX.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select EMC VNX.
- Right-click EMC VNX. Then click Register . The Register dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the EMC provider. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name.
- Username
- The name used to access the provider.
- Password
- The password associated with the user name.
- Comment
- Optional provider description.
- Catalog provider resources after registration
- If selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider. Note that the catalog policy may take considerable time to complete.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
Use the Discover feature to find and register multiple EMC VNX providers by IP address or a range of IP addresses. For example: 172.27.*, 172.27.100.10-172.27.100.200, or 172.27.100.10.
- Click the Configure tab. On the Views pane, select Providers . The Provider Browser opens.
- In the Provider Browser pane, select EMC VNX.
- Right-click EMC VNX. Then click Discover. The Discover EMC VNX Providers dialog opens.
- Enter an IP address or range of IP addresses associated with your EMC VNX storage systems in the IP Address field.
- Click Discover. Discovered EMC VNX providers display.
- Select providers to register along with universal custom parameters such as Site, username, and password. To select individual parameters for each provider, click the parameters in the Custom Parameters field. Select specific Sites, credentials, ports and SSL parameters for each provider. If Catalog provider resources after registration is selected, ECX creates a high-level catalog policy and automatically catalogs the objects on the provider.
- Click Register. ECX adds the providers to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab.
- In the Provider Browser pane, select Oracle .
- Right-click Oracle . Then click Register . The Register Oracle Server dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the Oracle server. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Host Address
- A resolvable IP address or a resolvable path and machine name. When registering an Oracle RAC cluster, register each node using its physical IP or name. Do not register a virtual name or SCAN (Single Client Access Name).
- Authentication
- ECX connects to the Oracle server as a local operating system user through an SSH key or password. See Identities Overview.
- To use an SSH key, select Key, enter a username and select or create an SSH key.
- To use a password, select Password, then select or create a Local credential.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
- Click the Configure tab.
- In the Provider Browser pane, select AWS .
- Right-click AWS . Then click Register . The Register Amazon Web Services dialog opens.
- Populate the fields in the dialog:
- Site
- A user-defined provider location, created in the Sites view on the Configure tab.
- Name
- A user-defined name for the AWS provider. This can be the same as the host name or it can be a meaningful name that is used within your organization to refer to the provider. Provider names must be unique.
- Region
- Select an associated AWS region.
- Comment
- Optional provider description.
- Access Key
- Select or create your AWS access key. See Identities Overview.
- Click OK. ECX first confirms a network connection and then adds the provider to the database.
If a message appears indicating that the connection is unsuccessful, review your entries. If your entries are correct and the connection is unsuccessful, contact a system administrator to review the connections.
NEXT STEPS:
- Once providers are available in ECX and associated with a site, assign them to a resource pool. See Configure Resource Pools.
- Add credentials to virtual machines in a VMware environment. See Add Credentials to a Virtual Machine.
Catalogic ECX™ 2.4
© 2016 Catalogic Software, Inc. | All rights reserved.
MySupport | Knowledge Base | Trademarks | info@catalogicsoftware.com