Search the Community

Moving an account within KAZOO User Stories I mistakenly added and configured a sub account under the wrong parent account; my “North Carolina” office should be under “East” and not “West.” I want to move a sub account from one home account to another parent account – for example, move my XXX East account from US to Canada? Overview There are two ways to achieve this: Use the Cluster Manager app. In the KAZOO environment. Execute an SSH command at the server level. This is an option available to Global Infrastructure clients who are experienced system administrators. NOTE: This process can be unsafe; it should only be used if an account was created under the wrong account in error, and needs to be moved. USING CLUSTER MANAGER (OPTION 1) Obtain the account ID of the account you want to move from. This ID will referenced as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Open your Accounts app Navigate to the account you want to move to Select the account, and select Overview Copy the account ID String and save it on a notepad From Account: 2. Obtain the account ID of the account you want to move the MOVE_ACCOUNT TO This ID will be referenced as DESTINATION_ACCOUNT from now on. Repeat the steps above and copy to a place that clearly labels this Account ID is the TO: Account ID number. 3. Browse to https://ui.zswitch.net and login using your credentials and the name of your account on our hosted platform (XYZ Parent Account) Open the Apps menu, and select the Cluster Manager app Click the Scripts tab from within the Cluster Manager app Click the Red Button labeled Run Command 4. Type the command below into the command dialog box sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT NOTE: While this process should take less than 5 seconds, you may want to increase the “Abort After” value to about 5 minutes. This should give ample time for the process to resolve before timing out and requiring a restart. 6. Click the Select Servers button 7. From the Cluster drop down, select the name of the cluster where the accounts live that you would like to move (pre, or prod). You do not need to select anything for Zone, or Services 8. Uncheck servers in the Filter Results section, so that you ONLY HAVE ONE server checked NOTE: You MUST select the server that contains your KAZOO applications; a Freeswitch or Database only server will cause this process to fail. To ensure this, you can follow these steps: Filter your server list using kazoo_applications type of servers first. "Select All" to unselect everything. Reselect the first server on the. list. 9. Click NEXT 10. Click Run Tasks Now! to execute the command you typed into the dialog box, on the server that remained checked on the previous page. 11. Watch the "Running/Queued" section of the tasks tab to ensure the task completes. You may need to refresh the list periodically, but clicking the refresh button (2 spinning arrows) at the top of the list. You can also go to the "Completed Logs" section to see that your "Run Command" task completed successfully. 12. Once the task is complete, confirm the account is now moved by re-opening the Accounts Manager app in the UI of your cluster. ADVANCED USERS (OPTION 2) This is an option available to Global Infrastructure clients who are experienced system administrators. Via SSH: Obtain the account ID of the account you want to move, I'll reference this ID as MOVE_ACCOUNT from now on. This can be obtained from the UI via the Accounts Manager app. Obtain the account ID of the account you want to move the MOVE_ACCOUNT under, I will reference this ID as DESTINATION_ACCOUNT from now on. This can also be obtained from the UI via the Accounts Manager app. SSH to one of the servers in your cluster where the account you want to move is assigned, and where kazoo_apps is running. Run the command below: sup crossbar_maintenance move_account MOVE_ACCOUNT DESTINATION_ACCOUNT API Reference Doc: docs.2600hz.com https://docs.2600hz.com/dev/applications/crossbar/doc/accounts/#move-an-account View full File

2600HZ STEP GUIDE – CLUSTER MANAGER -- HOW TO UPGRADE KAZOO APPLICATIONS How to upgrade Kazoo applications using Cluster Manager If you are using proper NAPTR or SRV records, we do not expect any downtime during the upgrade; however please schedule your upgrade during non-peak hours/days to avoid any issues. 1. Open Cluster Manager app from your monster UI panel. Select “Version manager” tab. 2. Select the cluster name (normally “production”). And select upgrade arrow icon. After discovering available versions of the applications, Cluster Manager will display target versions. 3. Select the order of the region / zone. Interactive Upgrade will pause the process after each zone and you will need to click to continue to next zone. If you want to upgrade all zones, you can uncheck the option. The confirmation page will be displayed before the actual upgrade process is started. 4. Click Upgrade Now Once you click on the “Upgrade now” button, upgrade process will be started. You can click the “refresh” icon to update the page, if it is not refreshed automatically. 5. Check the "Completed" to to see the final result of the upgrade Once the upgrade process is completed. The “Running” tasks tab will be empty. But you can check the “Completed” tab to see the final result of the upgrade. After the upgrade, please go through your verification plan. If there is any issue, you can “downgrade” to your previous version by going through the similar process. 2600HZ STEP GUIDE – CLUSTER MANAGER -- HOW TO DOWNGRADE KAZOO APPLICATIONS How to downgrade Kazoo application NOTE Downgrading should be only conducted when your new upgraded application is not working properly. Downgrading to random “old” version of applications will create more issues with the cluster configuration and prolong downtime. 1. Select “Downgrade” under “Version Manager” Tab. 2. Select applications and components you want to downgrade. You can check the current version for each applications / component. Do NOT downgrade to versions which are too old and backward because some of the new modules will not be supported in the old version. Only downgrade to the versions you were running in the previous state. 3. Select the ORDER of the downgrade operation. Check if you want to it to be interactive (pause between zones). 4. Confirm before actual operation. 5. Check the status during the downgrade process. You can click on Refresh button. Once the downgrade process is complete, you can verify that the cluster is in good working condition (UI, SIP, etc.). Related Articles How to move an account within KAZOO API Reference Docs docs.2600hz.com Accounts REST API Reference for Kazoo Crossbar Accounts ####### View full File

Click the link below to download a .pdf Cluster Manager Product Overview 2019-09-26.pdf Carrier Manager Product Overview 2019-09-26.pdf View full File