راهنمای رفع خطای نصب اودو ۱۸؛ بررسی ۵ مشکل رایج راه‌اندازی
وقتی اودو اجرا نمی‌شود، از کجا شروع کنیم؟ پنج گروه مشکل در نصب و راه‌اندازی را از محیط اجرا و دیتابیس تا ماژول‌ها و مجوز فایل‌ها، به‌ترتیب بررسی کنید.
برای رفع خطای نصب اودو، اول مشخص کنید اجرا در کدام مرحله متوقف شده است: آماده‌سازی محیط، اتصال به پایگاه داده، باز شدن صفحه یا بارگذاری ماژول. سپس پیام همان مرحله را بررسی کنید. پاک کردن برنامه و نصب دوباره، بدون پیدا کردن علت، ممکن است فقط همان خطا را تکرار کند.
فرض کنید اودو را نصب کرده‌اید، اما مرورگر صفحه‌ای نشان نمی‌دهد. یک نفر پیشنهاد تغییر رمز می‌دهد و دیگری می‌گوید نسخه تازه‌ای دانلود کنید. پیش از هر تغییری، لازم است بدانید سرویس اصلاً اجرا شده یا نه. این راهنما براساس مستندات اودو ۱۸، پنج گروه مشکل و ترتیب بررسی آن‌ها را توضیح می‌دهد؛ پیشنهادهای عیب‌یابی هم باید با شواهد نصب خودتان تطبیق داده شوند.
پیش از عیب‌یابی اودو، روش نصب را مشخص کنید
نام نسخه، سیستم‌عامل و روش نصب را یادداشت کنید. نصب با بسته آماده، اجرا از سورس و استفاده از محیط کانتینری، مسیر یکسانی برای شروع و توقف ندارند. دستور مناسب یک روش را بدون تطبیق روی روش دیگر اجرا نکنید. این مقاله روی بسته آماده و نصب از سورس تمرکز دارد؛ راهنمای قدم‌به‌قدم نصب یا تنظیم یک سرور عمومی نیست.
برای بررسی اولیه، زمان وقوع خطا، آخرین تغییر و متن کامل پیام را نگه دارید. در گزارش فنی، چند خط قبل از خطای نهایی نیز می‌تواند مفید باشد. رمز، کلید دسترسی و اطلاعات مشتریان را پیش از فرستادن گزارش حذف کنید. پیشنهاد ما این است که هر بار یک تغییر انجام دهید و نتیجه‌اش را ثبت کنید؛ تغییر هم‌زمان چند بخش، پیدا کردن علت را سخت می‌کند.
عبارت‌های فارسی خطا در ادامه، معنای پیام‌ها را توضیح می‌دهند؛ متن دقیق گزارش نصب خودتان را برای پیگیری فنی نگه دارید. بررسی را روی دستگاه میزبان و محیط درست انجام دهید. مثال‌های اتصال، نصب محلی با درگاه‌های پیش‌فرض را فرض می‌کنند؛ مقادیر واقعی نصب شما ممکن است متفاوت باشند. این بررسی‌ها روی سرور شما اجرا نشده‌اند.
مشکل اول: پیش‌نیازهای نصب اودو با محیط اجرا هماهنگ نیستند
اگر اجرا از همان ابتدا متوقف می‌شود، محیطی را بررسی کنید که واقعاً برنامه را اجرا می‌کند. وجود چند نسخه پایتون روی یک رایانه می‌تواند باعث شود نسخه ترمینال با محیط سرویس متفاوت باشد.
نسخه‌ها را بخوانید؛ سازگاری را حدس نزنید
مستندات نصب از سورس اودو ۱۸، پایتون ۳٫۱۰ یا بالاتر و پایگاه داده پستگرس‌کیوال نسخه ۱۲ یا بالاتر را ذکر می‌کند. این حداقل‌ها به معنی سازگاری بی‌قیدوشرط با هر ترکیب جدید نیستند. وابستگی‌ها و سیستم‌عامل نیز باید متناسب باشند. فایل وابستگی همان شاخه ۱۸ را مبنا قرار دهید و بسته‌های مربوط به نسخه دیگری از اودو را با آن ترکیب نکنید.
در رفع خطای نصب اودو، پیام‌هایی با معنای «دستور پایتون پیدا نشد» یا «پایتون شناخته نمی‌شود» ابتدا مسیر اجرای پایتون را مطرح می‌کنند. در نصب از سورس، نسخه پایتون و مسیر مفسری را که برنامه با آن اجرا می‌شود مشخص کنید. سپس مسیر ابزار مدیریت بسته‌های پایتون را با همان محیط تطبیق دهید؛ ممکن است کتابخانه را در یک محیط نصب کرده باشید، اما اودو از محیط دیگری اجرا شود.
اگر مفسر اشتباه انتخاب شده، محیط مجازی درست را فعال کنید یا مسیر مفسر تنظیم‌شده برای سرویس را اصلاح کنید؛ نصب یک پایتون دیگر به‌تنهایی کافی نیست. نشانه اصلاح این مرحله، اجرای برنامه با همان مفسر سازگار و عبور از خطای اولیه است. در بسته آماده، محیط همراه سرویس را بررسی کنید و نتیجه پایتون عمومی سیستم را جای آن نگذارید.
برای آزمایش محلی در ویندوز، بسته رسمی یک گزینه است؛ اما مستندات اودو استفاده از بسته ویندوز را برای محیط عملیاتی توصیه نمی‌کند. اگر هدف استفاده روزانه تیم است، انتخاب زیرساخت را جدا از تمرین نصب بررسی کنید. در صفحه میزبانی اودو می‌توانید خدمات مرتبط را ببینید؛ مناسب بودن هر گزینه باید با نیاز و شیوه نگهداری سازمان سنجیده شود.
مشکل دوم: خطای اتصال اودو به دیتابیس
باز نشدن پایگاه داده الزاماً به معنی خراب شدن اطلاعات نیست. ابتدا وضعیت سرویس پستگرس‌کیوال، مقصد اتصال و حساب مورد استفاده را بررسی کنید. برنامه اودو و پایگاه داده دو بخش جدا هستند؛ نصب شدن یکی، اجرای درست دیگری را ثابت نمی‌کند. اگر پیام خطا به اتصال اشاره دارد، پیش از بررسی ماژول فروش یا حسابداری، همین لایه را روشن کنید.
حساب دیتابیس با حساب ورود به اودو فرق دارد
کاربری که در صفحه ورود اودو استفاده می‌کنید، همان حساب اتصال به پستگرس‌کیوال نیست. رمز مدیریت پایگاه داده هم نقش دیگری دارد. تغییر یکی از این رمزها لزوماً مشکل دیگری را حل نمی‌کند. در نصب از سورس، مستندات ساخت حساب جداگانه برای اتصال اودو را توضیح می‌دهد؛ حساب پیش‌فرض مدیریتی پایگاه داده را برای اتصال اودو به کار نبرید.
برای رفع خطای نصب اودو، میان پیام‌هایی با معنای «اتصال رد شد» و «احراز هویت با رمز ناموفق بود» تفاوت بگذارید. در ویندوز، ابزار مدیریت سرویس‌های سیستم و در لینوکس، مدیر سرویس نصب را باز کنید و وضعیت سرویس پایگاه داده را بخوانید. برای نمونه محلی، شماره درگاه پیش‌فرض پایگاه داده ۵۴۳۲ است؛ اگر تغییر کرده، مقدار واقعی را بررسی کنید. پاسخ «سرور اتصال می‌پذیرد» فقط آمادگی سرور را نشان می‌دهد و درست بودن حساب اودو را ثابت نمی‌کند.
اگر سرویس متوقف است، گزارش آن را بخوانید و پس از مشخص شدن علت، سرویس مربوط را راه‌اندازی کنید. اگر دوباره متوقف شد، زمان توقف و پیام تازه را ثبت کنید. برای بررسی حساب اتصال، از ابزار مدیریت پایگاه داده با همان نشانی سرور، نام کاربر و نام دیتابیس تنظیم‌شده برای اودو اتصال آزمایشی بگیرید. رمز را در بخش مخصوص رمز وارد کنید؛ آن را در متن عمومی یا گزارش ارسالی ننویسید.
اگر اتصال آزمایشی با حساب واقعی موفق است اما اودو هنوز خطای احراز هویت دارد، نشانی سرور پایگاه داده، شماره درگاه، نام کاربر و رمز اتصال را در پیکربندی فعال سرویس تطبیق دهید. بعد از اصلاح و راه‌اندازی مجدد کنترل‌شده، اتصال اودو به همان دیتابیس باید برقرار شود و همان خطا در گزارش تازه تکرار نشود.
حذف دیتابیس یا ساخت دوباره اطلاعات، قدم اول بررسی اتصال نیست. ابتدا وضعیت سرویس و حساب را مشخص کنید؛ تغییر رمز ورود کاربر اودو، توقف سرویس پایگاه داده را برطرف نمی‌کند.
مشکل سوم: اودو اجرا می‌شود، اما صفحه باز نمی‌شود
اگر راه‌اندازی بدون توقف آشکار پیش می‌رود ولی صفحه در مرورگر باز نمی‌شود، نشانی و محل اجرا را کنار هم بخوانید. «میزبان محلی» یعنی همان دستگاهی که مرورگر روی آن باز است. اگر اودو روی سرور دیگری اجرا می‌شود، نشانی محلی لپ‌تاپ شما به آن سرور اشاره نخواهد کرد؛ باید نشانی درست دستگاه میزبان را استفاده کنید.
پورت و آدرس را با اجرای واقعی تطبیق دهید
شماره درگاه پیش‌فرض وب اودو ۸۰۶۹ است، اما می‌تواند تغییر کرده باشد. در نصب محلی، نشانی دستگاه میزبان را همراه شماره درگاه تنظیم‌شده بررسی کنید. شماره درگاه را از پیکربندی فعال یا گزارش شروع سرویس بخوانید؛ به عددی که در یک آموزش دیگر دیده‌اید تکیه نکنید. تغییر شماره درگاه بدون بررسی علت، پاسخ عمومی تمام مشکل‌ها نیست.
برای رفع خطای نصب اودو در مواجهه با پیام «اتصال به سرور برقرار نشد»، ابتدا وضعیت سرویس و شماره درگاه فعال را بررسی کنید. در ویندوز، وضعیت سرویس را در ابزار مدیریت سرویس‌ها و اطلاعات درگاه را با ابزار بررسی اتصال‌های شبکه بخوانید. در لینوکس، وضعیت سرویس و فهرست درگاه‌های در حال دریافت اتصال را بررسی کنید. نام یا شناسه برنامه استفاده‌کننده از درگاه باید با اودو تطبیق داشته باشد؛ صرف اشغال بودن درگاه، اجرای اودو را ثابت نمی‌کند.
اگر اودو روی درگاه درست در حال دریافت اتصال نیست، گزارش شروع برنامه را بخوانید. پیام «نشانی از قبل در حال استفاده است» بررسی برنامه صاحب درگاه را لازم می‌کند. اجرای هم‌زمان ناخواسته را برطرف کنید؛ فرایند ناشناس را صرفاً برای آزاد کردن درگاه متوقف نکنید. نشانه رفع این مرحله، باز شدن نشانی درست روی میزبان است. اگر دسترسی محلی برقرار شد ولی دسترسی شبکه نه، تنظیم شبکه را جدا بررسی کنید؛ نیازی به خاموش کردن عمومی دیواره آتش نیست.
اگر صفحه خطای داخلی برنامه می‌بینید، آن را با نرسیدن به سرور یکی نگیرید. زمان درخواست را یادداشت کنید و گزارش مرتبط همان زمان را بخوانید. صرف دیدن یک صفحه سفید، علت مشخصی را ثابت نمی‌کند. برای پیگیری موارد تکرارشونده، خدمات پشتیبانی اودو محل مناسبی برای آشنایی با شیوه رسیدگی و نگهداری است.
مشکل چهارم: خطای نصب ماژول اودو و وابستگی‌های آن
گاهی صفحه ورود باز می‌شود و برنامه پایه کار می‌کند، اما نصب یک افزونه خطا می‌دهد. در این وضعیت، بررسی را به همان افزونه و تغییرهای اخیر محدود کنید. موفق بودن ورود نشان نمی‌دهد تمام ماژول‌های سفارشی هم سازگارند؛ همان‌طور که خطای یک افزونه، به‌تنهایی دلیل خراب بودن کل نصب نیست.
وابستگی پایتون را از وابستگی ماژول جدا کنید
فایل فهرست وابستگی‌ها در سورس اودو، بسته‌های موردنیاز پایتون را مشخص می‌کند. تنظیم مسیر افزونه‌ها نیز محل جست‌وجوی ماژول‌های اودو را تعیین می‌کند. این دو مفهوم را یکی نگیرید. پیام مربوط به نبود کتابخانه پایتون با پیدا نشدن یک ماژول اودو، بررسی متفاوتی می‌خواهد. نام دقیق موردِ پیدا‌نشده و مرحله وقوع خطا را ثبت کنید.
برای رفع خطای نصب اودو در مواجهه با پیام «بسته موردنیاز پیدا نشد»، ابتدا نام بسته درج‌شده در گزارش را بخوانید. اگر کتابخانه پایتون واقعاً کم است، وابستگی معرفی‌شده در فایل نسخه ۱۸ یا مستند افزونه را در همان محیط اجرا نصب کنید. ابزار مدیریت بسته‌های پایتون امکان بررسی ناسازگاری وابستگی بسته‌های نصب‌شده را دارد؛ نتیجه این بررسی به محدود کردن علت کمک می‌کند.
در نصب سورس، نصب وابستگی‌ها باید از فهرست همان نسخه ۱۸ و در محیط مجازی مشخص انجام شود؛ محیط عمومی یک بسته آماده را با این روش تغییر ندهید. اگر موردِ پیدا‌نشده ماژول اودو است، حضور نسخه سازگار آن در پوشه افزونه‌های معرفی‌شده به سرویس و وجود پیش‌نیازهایش را بررسی کنید. نشانه اصلاح، نصب یا بارگذاری موفق همان افزونه در محیط آزمایشی و برنگشتن همان خطاست؛ نبود ناسازگاری کتابخانه‌ها به‌تنهایی سازگاری افزونه را ثابت نمی‌کند.
آزمایش افزونه تازه را ابتدا در محیط جدا انجام دهید. اگر مشکل پس از تغییر سفارشی شروع شده، نسخه قبلی و شرح همان تغییر را در اختیار مسئول فنی بگذارید. اگر هنوز درباره انتخاب ماژول مناسب نیازتان مطمئن نیستید، مشاوره خرید اودو به بررسی نیاز و انتخاب ماژول مربوط است؛ رسیدگی به خطای افزونه را با این تصمیم یکی نگیرید.
مشکل پنجم: خطاهای دسترسی در راه‌اندازی اودو
پیام نداشتن مجوز می‌تواند به فایل، پوشه یا منبع دیگری مربوط باشد. متن خطا و مسیر اشاره‌شده را بخوانید. این مسئله را با دسترسی کاربر به منوهای فروش و انبار یکی نگیرید. خطای سیستم‌عامل هنگام نوشتن فایل، همان محدودیت نقش کاربر در فرم اودو نیست و راهکار متفاوتی دارد.
حساب اجرا و مسیر داده را بررسی کنید
ببینید سرویس با چه حسابی اجرا می‌شود و همان حساب برای عملیات موردنیاز چه دسترسی‌ای دارد. تنظیم پوشه داده، محل نگهداری اطلاعاتی مانند فایل‌های پیوست و نشست‌ها را تعیین می‌کند. اگر محل ذخیره گزارش یا داده تغییر کرده، وجود پوشه و مجوز لازم را بررسی کنید. اجازه دسترسی عمومی به همه پوشه‌ها، اصلاح دقیق مسئله محسوب نمی‌شود.
در رفع خطای نصب اودو، پیام «مجوز دسترسی وجود ندارد» را همراه مسیر فایل بخوانید. در ویندوز، در ویژگی‌های سرویس، حساب اجرای آن را پیدا کنید و دسترسی همان حساب را در ویژگی‌های امنیتی پوشه بررسی کنید. در لینوکس، حساب تنظیم‌شده برای اجرای سرویس را با مالک و مجوزهای پوشه مقایسه کنید. حساب ورود شما به رایانه ممکن است با حساب سرویس متفاوت باشد؛ موفق شدن عملیات با حساب خودتان، کافی نیست.
مسئول سیستم باید دسترسی لازم را فقط برای حساب واقعی سرویس و مسیر موردنیاز اصلاح کند؛ خواندن پیکربندی و نوشتن در مسیر داده، نیاز یکسانی ندارند. پس از اصلاح، همان عملیات قبلی را با حساب سرویس در محیط آزمایشی تکرار کنید؛ مثلاً ذخیره پیوست وقتی خطا مربوط به مسیر فایل‌های پیوست بوده است. موفق شدن همان عملیات و حذف همان پیام از گزارش تازه، معیار بررسی است؛ اجرای دائمی با دسترسی مدیر راه‌حل عمومی نیست.
بعد از رفع مشکلات نصب اودو ۱۸ چه چیزهایی را کنترل کنیم؟
همان سناریویی را که خطا داشت دوباره اجرا کنید و نتیجه را ثبت کنید. باز شدن صفحه اصلی کافی نیست؛ اگر مشکل نصب افزونه بود، همان مرحله را در محیط آزمایشی بررسی کنید. زمان آزمون، تغییر انجام‌شده و خروجی مورد انتظار را بنویسید تا همکار بعدی بداند دقیقاً چه چیزی حل شده است.
برای بررسی بعدی، مشخصات نسخه، روش نصب، پیام کامل و تغییرهای اخیر را کنار هم نگه دارید. اگر تیم شما برای شروع بهره‌برداری آماده می‌شود، خدمات استقرار اودو موضوعاتی فراتر از اجرای برنامه، مانند آماده‌سازی داده و آموزش کاربران، را پوشش می‌دهد. حل یک خطای فنی، به‌تنهایی تأیید آمادگی تمام فرایندهای سازمان نیست.
پرسش‌های متداول درباره خطاهای راه‌اندازی اودو
با هر خطا باید اودو را دوباره نصب کنیم؟
خیر. ابتدا مشخص کنید مشکل در محیط اجرا، ارتباط دیتابیس، آدرس دسترسی یا افزونه است. نصب مجدد بدون تشخیص، شواهد مفید را هم پراکنده می‌کند. برای بررسی نصب خودتان، از طریق تماس با اودوپرو شرح مرحله و پیام خطا را بفرستید؛ اطلاعات ورود و فایل محرمانه را در متن عمومی قرار ندهید.
این راهنما برای همه روش‌های میزبانی قابل اجراست؟
خیر. تمرکز آن روی نصب محلی یا سروری با بسته آماده و سورس است. در میزبانی مدیریت‌شده ممکن است به تنظیمات سیستم‌عامل دسترسی نداشته باشید. در آن حالت، نتیجه بررسی و زمان رخداد را به مسئول زیرساخت بدهید تا مسیر مناسب همان محیط دنبال شود.
منابع و مراجع مقاله
موضوع را در عمل دنبال کنید
دوره‌های آموزشی اودو را ببینید و مسیر یادگیری مناسب خودتان را انتخاب کنید.