You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Open-IM-Server/scripts/install
xuexihuang 7a13284b2e
kafka work error ,alertmanager work error (#1455)
1 year ago
..
README.md Large refactoring projects: OpenIM automation, scripting, and openimctl refactoring (#825) 1 year ago
common.sh Large refactoring projects: OpenIM automation, scripting, and openimctl refactoring (#825) 1 year ago
dependency.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
environment.sh kafka work error ,alertmanager work error (#1455) 1 year ago
install-protobuf.sh feat: deployment and design of management backend and monitoring (#1432) 1 year ago
install.sh "Add Prometheus Support with Documentation and Docker Compose Integration to OpenIM" (#1403) 1 year ago
openim-api.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
openim-crontask.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
openim-man.sh docs: add openim cluster helm chart (#1291) 1 year ago
openim-msggateway.sh "Add Prometheus Support with Documentation and Docker Compose Integration to OpenIM" (#1403) 1 year ago
openim-msgtransfer.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
openim-push.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
openim-rpc.sh ☀️ feat: Enhancing OpenIM with Integrated E2E Testing and CI/CD Enhancements (#1359) 1 year ago
openim-tools.sh 🧶 feat: Big job! kubernetes Deployment Design (#1055) 1 year ago
test.sh Formatting adjustments, script removal, and helm template rendering (#1389) 1 year ago

README.md

OpenIM Suite Scripts

The OpenIM Suite represents a comprehensive collection of scripts, each tailored to manage and operate specific services within the OpenIM ecosystem. These scripts offer consistent, reliable, and efficient tools for initializing, controlling, and managing various OpenIM services on a Linux platform.

Features

  • Robustness: Built with Bash's error handling mechanisms (errexit, nounset, and pipefail), ensuring scripts fail fast and provide relevant error messages.
  • Modularity: Each script is dedicated to a particular service, promoting clarity and ease of maintenance.
  • Comprehensive Logging: Integrated logging utilities offer real-time insights into operations, enhancing transparency and debuggability.
  • Systemd Integration: Where applicable, scripts integrate with the systemd service manager, offering standardized service controls like start, stop, restart, and status checks.

Scripts Overview

  1. openim-api: Control interface for the OpenIM API service.
  2. openim-cmdutils: Utility toolkit for common OpenIM command-line operations.
  3. openim-crontask: Manages the OpenIM CronTask service, with both direct and systemctl installation methods.
  4. openim-msggateway: Script to operate the OpenIM Message Gateway service.
  5. openim-msgtransfer: Manages the OpenIM Message Transfer functionalities.
  6. openim-push: Interface for controlling the OpenIM Push Notification service.
  7. openim-rpc-auth: Script dedicated to the OpenIM RPC Authentication service.
  8. openim-rpc-conversation: Manages operations related to the OpenIM RPC Conversation service.
  9. openim-rpc-friend: Control interface for the OpenIM RPC Friend functionalities.
  10. openim-rpc-group: Script for managing the OpenIM RPC Group service.
  11. openim-rpc-msg: Operates the OpenIM RPC Messaging service.
  12. openim-rpc-third: Script dedicated to third-party integrations with OpenIM RPC.
  13. openim-rpc-user: Control interface for OpenIM RPC User operations.

OpenIM Server Installation Script Usage

The scripts within the OpenIM Suite generally adhere to two primary execution methodologies. To illustrate these methodologies, we'll use openim-crontask as a representative example.

  1. Direct Script Execution: Running the script directly, typically for straightforward start/stop operations.

    ./[script-name].sh
    
  2. Function-based Execution: Invoking specific functions within the script for more specialized operations (e.g., install, uninstall).

    ./scripts/install/install.sh [options]
    

Description:
This script is designed to handle the installation, uninstallation, and status checking of OpenIM components on the server. OpenIM is a presumed communication or messaging platform.

Commands:

  • -i, --install:
    Initiate the installation of all OpenIM components.

  • -u, --uninstall:
    Uninstall or remove all OpenIM components from the server.

  • -s, --status:
    Check and report the current operational status of the installed OpenIM components.

  • -h, --help:
    Display the help menu for available commands.

Example Usage:

To install all OpenIM components:

./scripts/install/install.sh -i

or

./scripts/install/install.sh --install

Note: Ensure you have the necessary privileges to execute installation or uninstallation operations. It's generally recommended to take a backup before making major changes.

1. Direct Script Execution

This method involves invoking the script directly, initiating its default behavior. For instance, with openim-crontask, direct execution will start the OpenIM CronTask as a background process.

Example:

./openim-crontask.sh

Upon execution, the script will source any necessary configurations, log the start of the CronTask, and finally run the CronTask in the background. The log messages will provide feedback about the process, ensuring the user is informed of the task's progress.

2. Function-based Execution

This approach is more specialized, enabling users to call specific functions defined within the script. This is particularly useful for tasks like installation, uninstallation, and status checks.

For the openim-crontask script:

  • Installation: It includes building the service, generating configuration files, setting up systemd services, and starting the service.

    ./openim-crontask.sh openim::crontask::install
    
  • Uninstallation: Stops the service, removes associated binaries, configuration files, and systemd service files.

    ./openim-crontask.sh openim::crontask::uninstall
    
  • Status Check: Verifies the running status of the service, checking for active processes and listening ports.

    ./openim-crontask.sh openim::crontask::status
    

It's crucial to familiarize oneself with the available functions within each script. This ensures optimal utilization of the provided tools and a deeper understanding of the underlying operations.

Notes

  • Always ensure you have the correct permissions before executing any script.
  • Environment variables may need to be set or sourced depending on your installation and configuration.