How To: Create and Manage Reseller Accounts
===========================================

NodeWorx Reseller accounts can be used to allow customers the ability to create their own SiteWorx accounts. 

While Resellers have access to NodeWorx, they do not see any features that are reserved for the Server 
Administrator. For example, they cannot alter Apache service configurations or give themselves shell access.

.. contents::

To Add a Reseller Account
-------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list 
     
#. Click **+** or **Add Reseller**. This opens the Reseller Account Management form

   .. image:: /images/reseller-account-add-form.png
        :alt: reseller account add form

#. Update the required fields. These include: 

   - **Nickname**: The nickname of the reseller. This is used to identify the reseller
   - **E-mail Address**: The e-mail address of the reseller. This is the NodeWorx login and point
     of contact for the reseller
   - **Password/Confirm Password**: The password of the reseller
   - **Language**: The default language of the reseller. The selected language is the
     language that will appear in the interface
   - **Billing Day**: This is the day of each month that the billing cycle starts. This is also the day the 
     bandwidth counter resets each month for the reseller account
   - **Status**: The status of the reseller account
     
     - Reseller accounts marked Inactive will no longer be able to log into NodeWorx
   
   - **Reseller Package Features**: For details about each Reseller Package Features, see 
     :doc:`Reseller Package Overview </nodeworx/account_management/reseller/add-edit-delete-reseller-packages>`
   - **Reseller IP Addresses**: Server IP addresses the reseller is allowed to use 
   
     - If there are no IPs listed, see: :doc:`IP Management Documentation </nodeworx/server_management/networking/overview-managing-addresses-interworx-control-panel>`
   
   - **Database Server**: The database server associated with the reseller
   
#. Click **Save**

To Edit a Reseller Account
--------------------------

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list

#. Click the **Pencil** next to the reseller account. This opens the Reseller Account Management 
   form

   .. image:: /images/reseller-account-add-form.png
      :alt: reseller account add form

#. Modify the desired values 
#. Click **Save**

To Delete a Reseller Account
----------------------------

.. warning::

   When a reseller account is deleted, all of the SiteWorx accounts created under that reseller are transferred 
   to the Server Admin reseller (the master NodeWorx user).

From the Accounts List 
^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list 

#. Select the **Trashcan** next to the reseller account. This opens the Confirm Deletion form 

   .. image:: /images/nw-reseller-delete-confirm.png
      :alt: confirm deletion form 

#. Click **Delete** 

From the With Selected Dropdown
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list 

#. Select the **checkbox** next to the account(s) 

   - Selecting the **checkbox** next to the With Selected dropdown will automatically select all accounts
  
#. Select **Delete** from the With Selected dropdown

   .. image:: /images/nw-reseller-delete-dropdown.png
      :alt: reseller account delete dropdown 

#. Click **Go**. This opens the Confirm Deletion form

   .. image:: /images/nw-reseller-delete-confirm.png
      :alt: confirm deletion form

#. Click **Delete** 

To Manage Reseller Account IP Addresses
---------------------------------------

To Add a New IP Addresss to a Reseller Account
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list 
#. Click the **vertical dots** icon next to the reseller account. This opens an options menu 

   .. image:: /images/nw-reseller-manage-ips-menu.png
      :alt: reseller manage ips menu option

#. Click **Manage IPs**. This opens the Manage IPs page for the reseller account

   .. image:: /images/nw-reseller-ips.png
      :alt: reseller manage ips page

#. Click **Assign More IPs**. This opens the Add an IP Address form 

   .. image:: /images/nw-reseller-add-ips.png
      :alt: reseller add ips form 

#. Select the checkbox next to the desired IP addresses 
#. Click **Save**

To Remove an IP Address from a Reseller Account 
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Log into NodeWorx from the browser (https://ip.ad.dr.ess:2443/nodeworx)
#. In NodeWorx, navigate to **Resellers > Accounts**

   .. image:: /images/nw-reseller.png
      :alt: reseller list 
#. Click the **vertical dots** icon next to the reseller account. This opens an options menu 

   .. image:: /images/nw-reseller-manage-ips-menu.png
      :alt: reseller manage ips menu option

#. Click **Manage IPs**. This opens the Manage IPs page for the reseller account

   .. image:: /images/nw-reseller-ip.png
      :alt: reseller manage ips page

#. Select the checkbox next to the desired IP address
#. Select **Remove** from the With Selected dropdown 
#. Click **Go**. This opens the Confirmation form 

   .. image:: /images/nw-reseller-ip-remove-form.png
      :alt: confirm removal form 

#. Click **Remove**