Skip to content

cloudblue_connector_installation_guide.md

Latest commit

 

History

History
75 lines (61 loc) · 2.08 KB

cloudblue_connector_installation_guide.md

File metadata and controls

75 lines (61 loc) · 2.08 KB
Raw

CloudBlue Connector Installation Guide

Prerequisites

  • Python 3.9 or higher
  • System with systemd (Linux)
  • Administrative (sudo) privileges

Installation Steps

1. Download and Extract the Package

git clone git@github.com:virtuozzo/cloudblue-connector.git
cd cloudblue-connector/

2. Install Python Dependencies

pip3 install -r requirements/requirements.txt

3. Create Required Directories

mkdir -p /etc/cloudblue-connector/
mkdir -p /var/lib/cloudblue-connector
mkdir -p /var/log/cloudblue-connector/

4. Copy Configuration Files

cp connector-logger-example.json /etc/cloudblue-connector/connector-logger.json
cp config-example.yaml /etc/cloudblue-connector/config.yaml

5. Install Connector Files

cp -R connect_processor /usr/lib/python3.9/site-packages/
chmod +x cloudblue-connector-cli
chmod +x cloudblue-connector
cp -R cloudblue-connector-cli /usr/bin/
cp -R cloudblue-connector /usr/bin/
cp cloudblue-connector.service /usr/lib/systemd/system/cloudblue-connector.service

6. Configure Authentication

Choose one of the following methods:

Option A: Using CLI (Recommended for Production)

cloudblue-connector-cli auth set --service cloudblue
cloudblue-connector-cli auth set --service vhi

Option B: Manual Configuration

Edit the config.yaml file in /etc/cloudblue-connector/ if you prefer not to store passwords in the database (recommended for staging environments).

7. Enable and Start the Service

If the manual test was successful, enable and start the service:

systemctl enable cloudblue-connector.service
service cloudblue-connector.service start

Verification

To check if the service is running properly:

systemctl status cloudblue-connector.service

Troubleshooting

  • Check logs in /var/log/cloudblue-connector/ for any errors
  • Ensure all required permissions are set correctly
  • Verify Python dependencies are installed correctly

Support

For additional support or issues, please contact your system administrator or refer to the CloudBlue documentation.