Alfresco CE Yükseltme

Alfresco Community Edition Yükseltme

Bu bilgileri, Community Edition’ın bir sürümünden daha yeni bir sürüme yükseltmek, bir Service Pack uygulamak veya arama alt sistemini yükseltmek için kullanın.

Bir yükseltme yapmadan veya Service Pack uygulamadan önce, önerilen yükseltme yolunu ve ön koşullar kontrol listesini kontrol ettiğinizden emin olun. Yükseltmenin bir parçası olarak, Alfresco yükseltmesinin başarılı olduğunu doğrulamanız ve test etmeniz gerekir.

Community Edition’ın önceki sürümlerinden yükseltme yaparken dikkatli olunmalıdır. Yükseltmeden önce gözden geçirilmesi ve planlanması gereken bazı adımlar vardır. Aşağıdaki rehberi inceleyin ve ardından yükseltmenizi planlayın. Özellikle, başlamadan önce aşağıdaki adımların tamamlandığından emin olun:

• Yükseltme sürecine başlamadan önce Alfresco repository’nizin ve veritabanınızın çalışır durumda bir yedeğinin olduğundan emin olun.
• Yükseltmeyi desteklemek için hangi özelleştirme veya kütüphane öğelerinin gözden geçirilmesi ya da güncellenmesi gerektiğini anlamak amacıyla Alfresco Extension Inspector’ı indirin ve çalıştırın.
• Community Release Notes içerisinde yer alan tüm yeni ve kullanım dışı (deprecated) özellikleri inceleyin.
• Yeni desteklenen stack seçeneklerini inceleyin ve yeni dağıtım için gerekli güncellemeleri uygulayın.

Yükseltme Süreci

Desteklenen kurulum yöntemlerinden birini kullanarak önceki bir Community Edition sürümünden yükseltme yapmak için bu prosedürü kullanın. Süreç, Community Edition binary dosyalarının ve yapılandırmasının yeni bir kurulumunu ve repository’nin bir kopyası üzerinde yerinde (in-place) yükseltmeyi içerir.

Binary ve yapılandırmanın yerinde yükseltilmesi önerilmez. Yeni bir kurulum oluşturmak, yükseltme sırasında bir sorun oluşursa orijinal (yükseltilmemiş) sistemin bozulmadan kalmasını ve hemen yeniden başlatılabilmesini sağlar.

Bu adımlar, aşağıdaki ayarlara sahip mevcut bir Community Edition kurulumu (alfresco-v.1) olduğunu varsayar:

1. Yeni Community Edition sürümünü yükleyin.

2. Mevcut instance’ı durdurun.

3. Mevcut repository (alfresco-v.1) ve veritabanının yedeğini alın.

Not: <extension> dizinindeki tüm konfigürasyon override’larını da yedekleyin.

4. Yeni sürümü (alfresco-v.2), mevcut kurulumdan farklı bir dizine kurun.

Örneğin, yeni Alfresco kurulumu aşağıdaki ayarlara sahip olacaktır:

alfresco-global.properties içinde:

dir.root=/alfresco-v.2/alf_data
db.url=url<v.2>

solrcore.properties içinde:

data.dir.root=/alfresco-v.2/solr/myindexes

5. Yeni kurulumun doğru çalıştığını doğrulayın.

• Yeni bir repository ve veritabanı ile (mevcut olan değil) yapılandırın.
• Sunucuyu başlatın ve sistemin doğru çalıştığını doğrulayın.

6. Tüm özelleştirmeleri yeni kuruluma uygulayın.

• Sunucuyu durdurun.
• İstenmeyen uygulamaları kaldırın.
• Uygulamaları düzenleyin.
• Gerekli AMP dosyalarını yükleyin (bkz. Installing an Alfresco Module Package).

Dosyaları doğrudan kopyalamayın. Sadece override ayarlarını kopyalayın; aksi halde yeni sürümdeki extension dosyalarının üzerine yazabilirsiniz.

• Sunucuyu başlatın.
• Başlangıç loglarını izleyerek yükseltme durumunu kontrol edin. Başlangıç sırasında loglarda sorun oluşursa, repository’yi tamamen geri yükleyerek (rollback) düzeltin ve tekrar deneyin.
• Özelleştirmeleri ve konfigürasyonu tamamen test edin.

7. Üretim verilerini geri yükleyin.

• Sunucuyu durdurun.
• Yeni kurulumdaki contentstore dizini altındaki tüm dosya ve klasörleri silin. Ayrıca veritabanını silin.
• Yeni kurulumdaki iki Solr alfrescoModels dizinindeki dosyaları ve iki dizindeki (solr/workspace/ ve solr/archive/) indexleri silin.
• Önceki kurulumdan aldığınız yedekleri (indexler, contentstore dizini, dosyalar ve veritabanı) yeni kuruluma geri yükleyin.
• Sunucuyu başlatın.

Başlangıç sırasında loglarda sorun oluşursa, repository’yi tamamen geri yükleyerek sorunu düzeltin ve tekrar deneyin.

Yükseltilmiş sistemden memnunsanız, eski kurulumu ve repository’yi kaldırın.

Yükseltmeyi Doğrulama

Yükseltmeden sonra aşağıdaki adımları izleyerek yeni kurulumu doğrulayın:

1. Community Edition sunucusunu yeniden başlatın.
2. Konfigürasyon override’larının verileri doğru konumlara yönlendirdiğinden emin olun.
3. Başlangıç loglarını izleyin.
4. Yeni kurulumu boş bir repository ile doğrulayın.
5. Yeni bir repository ile yapılandırın (mevcut olan değil).
6. Veritabanı bağlantı bilgilerini ve veri klasörü konumlarını kontrol edin.
7. Community Edition’ı başlatın ve sistemin doğru çalıştığını doğrulayın.
8. Community Edition’ı kapatın.

Yeni kurulumun tamamen doğrulandığından emin olduktan sonra eski kurulumu ve repository’yi kaldırın.

Opsiyonel Performans Veritabanı Yaması Uygulama

Not: Bu yama büyük sistemlerde saatler sürebilir.

Content Services 7.0, alf_node tablosuna iki ve alf_transaction tablosuna üç indeks ekleyen önerilen bir veritabanı yaması içerir. Bu yama isteğe bağlıdır ancak büyük kurulumlar için performansa ciddi katkı sağlayabilir.

Bu indeksler yükseltme sırasında otomatik uygulanmaz çünkü oluşturulmaları uzun sürebilir. Yükseltme tamamlandıktan sonra manuel olarak çalıştırılmalıdır.

Yamayı uygulamak için, bir admin aşağıdaki Alfresco global property değerini true yapmalıdır:

system.new-node-transaction-indexes.ignored=false

Diğer yamalar gibi, bu yama da yalnızca bir kez çalıştırılır; sonrasında property’yi geri değiştirmenize gerek yoktur.

Bu adım tamamlanana kadar, her başlangıçta alfresco.log dosyasında Schema Validation uyarıları göreceksiniz. Log, yamanın çalıştırılmadığını da belirtecektir:

INFO  [org.alfresco.repo.domain.schema.SchemaBootstrap] [...] Ignoring script patch (post-Hibernate): patch.db-V6.3-add-indexes-node-transaction
...
WARN  [org.alfresco.repo.domain.schema.SchemaBootstrap] [...] Schema validation found ... potential problems, results written to ...

Log4j2 Geçiş Rehberi

Content Services 7.4 sürümünde log4j yerine log4j2 kullanılmaktadır. Daha fazla bilgi için Enterprise dokümantasyonundaki Log4j2 geçiş rehberine bakın.