Business Central güncellemesi başarısız oldu: eklenti hatası çözümü
Business Central ortam ya da eklenti güncellemesi başarısız olursa ne yapılır? İşlem günlüğü, Yeniden dene, bağımlılıklar ve uyumsuz eklentinin çıkarılması.
İçindekiler
Business Central online’da bir güncelleme başarısız olduğunda ortam eski sürüme geri döner, kullanıcılar çalışmaya devam eder ve yeni deneme yedi gün sonrasına planlanır. Asıl işiniz nedeni bulmaktır. Neden çoğunlukla ortamda kurulu bir eklentidir, yani size özel yazılmış bir eklenti ya da Microsoft’un Marketplace’inden kurulmuş bir uygulama. Aşağıdaki sıra, önce hatanın hangi güncellemede çıktığını ayırır, sonra işlem günlüğünden nedeni okur ve çözümü seçer.
Yazı Microsoft Learn belgelerine dayanır. Ekranda çıkan hata iletisinin metnini birebir vermiyoruz, çünkü iletiler eklentiye göre değişir. Bunun yerine belirtiyi ve olası nedenini eşleştiriyoruz. Türkçe arayüz iş ortağı uygulamasıyla geldiği için ekran adlarının Türkçe karşılığı sizde farklı görünebilir. Bu yüzden adları Microsoft’un İngilizce arayüzündeki hâliyle de yazıyoruz.
İki ayrı güncelleme türü
Business Central’ta iki farklı güncelleme vardır ve hata iletileri birbirine benzese de çözümleri ayrıdır.
| Güncelleme | Ne güncellenir | Hatayı nerede görürsünüz | İlk adım |
|---|---|---|---|
| Ortam güncellemesi | Business Central’ın kendisi, nisan ve ekimdeki büyük sürüm ya da aylık küçük sürüm | İşlemler (Operations) sayfası ve bildirim e-postası | İşlem ayrıntısını okuyup nedeni bulmak |
| Eklenti güncellemesi | Tek bir uygulama ya da eklenti | Uygulamaları yönet (Manage Apps) sayfasında Güncelleme başarısız (Update failed) eylemi | Yeniden dene (Retry) |
Ortam güncellemesi başarısız olduğunda kullanıcılar etkilenmez, çünkü ortam eski sürüme döner. Güncelleme sürerken ise ortama giriş engellenir ve ekranda “Service is under maintenance” iletisi görünür. Bu yüzden güncellemeyi iş saatlerinden uzak bir tarihe koymak önemlidir. Takvim ve pencere mantığı için güncelleme takvimi yazımıza bakabilirsiniz.
Ortam güncellemesi neden başarısız olur
Microsoft üç grup neden sayar. Birincisi kiracıya özel eklentilerin (PTE) uyumsuzluğudur. İkincisi Marketplace uygulamalarının uyumsuzluğudur. Üçüncüsü Microsoft tarafındaki iç sorunlardır.
Bir güncelleme, ortamın güncelleme penceresi bitmeden tamamlanmazsa da iptal edilir ve yedi gün sonrasına yeniden planlanır. Her ortamın varsayılan güncelleme penceresi yerel saatle 20.00 ile 06.00 arasıdır ve pencere en az altı saat olmalıdır. Güncellemenin süresi ortama göre değişir, bu yüzden Microsoft güncellemeyi ortamın bir gün boyunca erişilemez kalmasının sorun olmayacağı bir tarihe koymanızı önerir.
Güncellemeyi Microsoft planladıysa ve hedef sürüm en son sürüm değilse, sonraki deneme en son sürüme yönlendirilebilir. Güncellemeyi yönetici planladıysa, seçilen sürümün güncelleme dönemi bitmedikçe hedef sürüm değişmez.
İşlem günlüğünden nedeni okuma
Yönetim merkezinin İşlemler bölümü, yönetim merkezinde ya da yönetim API’sinde yapılan işlemlerin günlüğünü tutar. Başarısız bir işlemin ayrıntılı hata iletisine de buradan ulaşırsınız. Günlükte Update environment (ortam güncelleme) ve Environment app update (uygulama güncelleme) türleri bulunur. Kayıtlar 180 gün saklanır.
- Yönetim merkezinde Environments sekmesinden ilgili ortamın adına tıklayın.
- İşlemler sayfasına geçin ve başarısız olan işlemi seçin.
- Operation Details bölmesindeki hata iletisini ve işlem kimliğini (Operation ID) not edin.
- Hata iletisinde adı geçen eklentiyi belirleyin ve bu eklentinin PTE mi yoksa Marketplace uygulaması mı olduğuna bakın.
Microsoft, destek isterken işlem kimliğinin mutlaka verilmesini önerir, çünkü bu kimlik incelemeyi hızlandırır.
Bildirimleri kaçırmamak
Güncellemenin planlandığı, başarılı olduğu ya da başarısız olduğu bilgisi Bildirim alıcıları (Notification recipients) listesindeki adreslere e-postayla gider. Listeye en az bir yönetici adresi girilmelidir. Alıcı yoksa e-posta gönderilmez. Bildirimler no-reply-dynamics365@microsoft.com adresinden geldiği için bu adresin istenmeyen posta klasörüne düşmediğinden emin olun.
Microsoft büyük güncellemeden önce ortamlardaki PTE’leri sonraki sürümle uyumluluk açısından düzenli olarak denetler. Uyumsuzluk bulursa sorunu anlatan bir e-posta alıcılara gider. Bu e-postayı güncelleme tarihinden önce okuyup işlem yapmak, başarısız güncellemeyi baştan önler.
Çözüm: uyumsuz eklentiyi düzeltme
Sorunun hangi eklentiden geldiğine göre izlenecek yol değişir.
Size özel eklenti (PTE) uyumsuzsa. Eklentiyi geliştiren iş ortağı kodu Visual Studio Code’da düzeltir ve yeni büyük sürümü çalıştıran bir sandbox ortamında dener. Deneme başarılı olursa yeni PTE sürümü ortama yüklenir ve Dağıtım zamanlaması (Deployment Schedule) alanı Next major yapılır. Böylece ortam güncellenirken uyumlu sürüm kullanılır. Yüklemeyi Uygulamaları yönet sayfasındaki Install Extension eylemiyle başlatabilirsiniz. Bu sayfa, eklentiyi hemen, sonraki güncelleme penceresinde ya da sonraki küçük veya büyük güncellemede kurma seçeneği sunar.
Marketplace uygulaması uyumsuzsa. Yayıncı yeni bir sürüm çıkarana kadar sizin yapabileceğiniz sınırlıdır. Microsoft’un anlatımına göre yayıncı yeni bir sürüm yüklediğinde Microsoft onu, yayıncının belirttiği en düşük desteklenen sürümden başlayarak tüm büyük ve küçük sürümlere karşı doğrular. Doğrulamayı geçen sürüm, yalnızca geçtiği Business Central sürümlerini çalıştıran ortamlara sunulur. Listede bir güncelleme görünmüyorsa ortamınız henüz o sürümü çalıştırmıyor olabilir.
PTE ile Marketplace uygulaması çakışıyorsa. Bu durumda Marketplace uygulamasının devralabilmesi için PTE’nin şemasını temizlemeniz gerekebilir. Microsoft bu durumu güncelleme yönetimi belgesinde ayrıca anar. İşlemi uygulamayı bilen bir iş ortağıyla yapmanızı öneririz.
Eklenti güncellemesi başarısız olursa
Bir eklentinin güncellemesi başarısız olduğunda Uygulamaları yönet sayfasında Kullanılabilir güncelleme eylemi (Available Update Action) sütununda Güncelleme başarısız eylemi görünür. Bu eylemi seçince App Update Details bölmesi hatanın olası nedenini gösterir.
- Geçici bir sorun olabileceği için önce Yeniden dene eylemini seçin.
- Güncelleme yine başarısız olursa bölmedeki ayrıntıyı ve işlem kimliğini alın.
- Uygulamayı yayımlayan firmaya başvurun. Yayıncının destek bilgisi uygulamanın Marketplace sayfasındadır. Yayıncı Microsoft ise Microsoft desteğine başvurun.
Sonraki güncelleme (Next Update) sütununda Action Required yazıyorsa sorun hata değil bağımlılıktır. Yeni sürüm başka bir uygulamanın kurulmasını ya da güncellenmesini istiyordur. Requirements for App Updates sayfası iki grup gösterir. Update requirements altındaki uygulamalar için Uygulamaları yönet sayfasına dönüp Install update eylemini seçin ve sütunun Up to date olmasını bekleyin. Install requirements altındaki kurulu olmayan uygulamalar yönetim merkezinden kurulamaz. Bunları Business Central içindeki Eklenti yönetimi (Extension Management) sayfasından kurarsınız.
Marketplace uygulamalarının ortam güncellemesiyle ne zaman güncelleneceğini Apps Update Cadence ayarı belirler. Varsayılan değerde uygulamalar yalnızca büyük güncellemelerle güncellenir. Yönetim merkezi yalnızca en yüksek uyumlu sürüme güncellemeyi destekler. Belirli bir sürüme güncelleme için yönetim merkezi API’si gerekir.
Eklentiyi kaldırmak
Eklentiye ihtiyaç yoksa Uygulamaları yönet sayfasındaki Uninstall eylemiyle kaldırabilirsiniz. Microsoft, bu işlemi önce üretim ortamından kopyaladığınız bir sandbox ortamında denemenizi önerir. Kaldırırken uygulama verisini de silme seçeneği vardır. Veri silinirse geri getirmenin tek yolu ortamı bir zaman noktasına geri yüklemektir ve bu geri yükleme 28 günlük bir süreyle sınırlıdır. Kaldırdığınız uygulamaya bağımlı başka uygulamalar varsa onlar da kaldırılır ve ekran bunları onayınıza sunar.
Güncellemeyi hemen yeniden deneme
Sorunu giderdikten sonra ortamın güncelleme tarihini öne çekmeniz gerekir, çünkü yeni deneme kendiliğinden yedi gün sonraya planlanmıştır.
- Ortam ayrıntı sayfasında Update Settings altındaki Next Update için Modify eylemini seçin.
- Schedule Environment Update bölmesinde hedef sürümü seçin ve tarihi bugüne ya da daha erkene ayarlayın.
- Güncellemenin hemen başlamasını istiyorsanız Allow the update to run outside the update window seçeneğini Yes yapın.
- Schedule Update eylemini seçin.
Bugünü seçip güncelleme penceresi geçmişse güncelleme ertesi günün penceresinde başlar. Pencere dışında çalışma seçeneğini kullanırsanız güncelleme pencere sonunda iptal edilmez, ortam da bu sürede erişilemez kalabilir. Bu seçeneği, belirli bir saatte hazır olması gereken ortamlarda kullanmayın. Çalışan bir güncellemeyi durdurmak gerekirse Operation Details bölmesindeki Cancel update düğmesi kullanılır. İptal, ortamı güncelleme öncesi durumuna döndürür ve veritabanının boyutuna göre bir saatten uzun sürebilir.
Beklemenin bedeli
Bir eklenti sorunu çözülmeden bırakılırsa Microsoft güncellemeyi durdurur ve bildirim gönderir. Microsoft’un anlattığı tipik süreçte önce on hafta boyunca e-posta gider, ardından altı hafta kullanıcılara ürün içi uyarı gösterilir, sonra bir ay daha açık bir uyarı çıkar. Bu sürenin sonunda sorunlu eklenti kaldırılmamışsa Microsoft eklentileri zorla kaldırma sürecini başlatır. Microsoft’a göre bu işlem eklentiye ait veriyi silmez ve uyumlu sürüm kurulunca veri yeniden kullanılabilir. Yine de eklenti, uyumlu sürüm kurulana kadar çalışmaz.
Türkiye uyarlaması iş ortağı uygulamalarıyla geldiği için e-belge ve yerel raporlar da bu uygulamalara bağlıdır. Bu nedenle hangi uygulamaların güncellemeye hazır olduğunu güncellemeden önce bilmek gerekir. Genel yapı için Business Central nedir yazısına ve Türkiye uyarlaması sayfasına bakabilirsiniz.
Xen Bilişim’in hizmeti
Aylık destek kapsamında her büyük güncellemeden önce ortamın bir kopyasında güncellemeyi dener, uyumsuz eklentiyi güncelleme gününden önce tespit eder ve gerekirse yayıncıyla yazışırız. Güncelleme başarısız olduğunda işlem günlüğünü okuyup nedeni ve çözümü size yazılı olarak iletiriz. Ayrıntı için uygulama yönetimi ve destek sayfasına bakabilir ya da iletişim sayfasından bize yazabilirsiniz.
Sık sorulan sorular
Business Central güncellemesi başarısız olunca verilerim zarar görür mü?
Microsoft'un anlatımına göre güncelleme başarısız olduğunda ya da iptal edildiğinde ortam özgün uygulama sürümüne geri yüklenir ve kullanıcılar yeniden bağlanabilir. Yeni deneme yedi gün sonrasına kendiliğinden planlanır.
Başarısız güncellemeyi hemen yeniden nasıl denerim?
Sorunun nedenini giderdikten sonra yönetim merkezinde ortamın sonraki güncelleme tarihini bugüne ya da daha erkene çekersiniz. Güncellemenin hemen başlaması için tarihi bugüne ayarlayıp güncelleme penceresi dışında çalışmaya izin verme seçeneğini Evet yapmanız gerekir.
Eklenti güncellemesinde Güncelleme başarısız mesajı görürsem ne yapmalıyım?
Yönetim merkezinde Uygulamaları yönet sayfasında bu eylemi seçip ayrıntı bölmesini okuyun. Hata geçici olabileceği için önce Yeniden dene eylemini kullanın. Sorun sürerse uygulamanın yayıncısına, yayıncı Microsoft ise Microsoft desteğine başvurun ve hata iletisindeki işlem kimliğini iletin.
Güncelleme sorunu çözülmezse Microsoft eklentiyi kaldırır mı?
Evet, zorunlu güncelleme döneminde güncellemenin başarısız olmasına neden olan eklentiler ortamdan kendiliğinden kaldırılabilir. Eklentiye ait veri silinmez ve uyumlu bir sürüm kurulunca yeniden kullanılabilir. Microsoft'a göre uyumlu sürüm yayımlansa bile eklenti her ortama kendiliğinden geri kurulmaz.
Güncelleme bildirimlerini kim alır?
Yönetim merkezindeki Bildirim alıcıları listesindeki e-posta adresleri alır. Listeye en az bir yöneticinin adresinin girilmesi önerilir ve en fazla 100 alıcı eklenebilir. Bildirimler no-reply-dynamics365@microsoft.com adresinden gelir, bu yüzden istenmeyen posta klasörünüzü de kontrol edin.
Kaynaklar
- Microsoft Learn: Güncelleme döngüleri
- Microsoft Learn: Yönetim merkezinde güncellemeleri yönetme
- Microsoft Learn: Uygulamaları yönetme
- Microsoft Learn: Üretim ve sandbox ortamlarını yönetme (işlem günlüğü)
- Microsoft Learn: Kiracıya özel bildirimleri yönetme
- Microsoft Learn: Marketplace uygulamalarını ve kiracıya özel eklentileri güncel tutma
Bu yazı, Microsoft iş uygulamaları hizmetini veren Xen Bilişim ekibi tarafından hazırlanmıştır. Hakkımızda
