

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Integrasikan Stonebranch Universal Controller dengan AWS Mainframe Modernisasi
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization"></a>

*Vaidy Sankaran dan Pablo Alonso Prieto, Amazon Web Services*

*Robert Lemieux dan Huseyin Gomleksizoglu, Cabang Batu*

## Ringkasan
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-summary"></a>

Catatan: AWS Mainframe Modernization Layanan (pengalaman Lingkungan Runtime Terkelola) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan AWS Mainframe Modernization Service (Managed Runtime Environment experience) jelajahi AWS Mainframe Modernization Service (Self-Managed Experience). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat [perubahan AWS Mainframe Modernization ketersediaan](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

Pola ini menjelaskan cara mengintegrasikan [orkestrasi beban kerja Stonebranch Universal Automation Center (UAC) dengan layanan Modernisasi Mainframe](https://www.stonebranch.com/stonebranch-platform/universal-automation-center) [Amazon Web Services (](https://aws.amazon.com/mainframe-modernization/)AWS). Layanan AWS Mainframe Modernisasi memigrasikan dan memodernisasi aplikasi mainframe ke AWS Cloud. Ini menawarkan dua pola: [AWS Mainframe Modernization Replatform](https://aws.amazon.com/mainframe-modernization/patterns/replatform/) dengan teknologi Micro Focus Enterprise dan AWS [Mainframe Modernization Automated Refactor dengan AWS](https://aws.amazon.com/mainframe-modernization/patterns/refactor/?mainframe-blogs.sort-by=item.additionalFields.createdDate&mainframe-blogs.sort-order=desc) Blu Age.  

Stonebranch UAC adalah platform otomatisasi dan orkestrasi TI real-time. UAC dirancang untuk mengotomatiskan dan mengatur pekerjaan, aktivitas, dan alur kerja di seluruh sistem TI hybrid, dari lokal hingga AWS. Klien perusahaan yang menggunakan sistem mainframe beralih ke infrastruktur dan aplikasi modern yang berpusat pada cloud. Alat dan layanan profesional Stonebranch memfasilitasi migrasi penjadwal yang ada dan kemampuan otomatisasi ke AWS Cloud.

Saat memigrasikan atau memodernisasi program mainframe Anda ke AWS Cloud menggunakan layanan AWS Mainframe Modernization, Anda dapat menggunakan integrasi ini untuk mengotomatiskan penjadwalan batch, meningkatkan kelincahan, meningkatkan pemeliharaan, dan mengurangi biaya.

Pola ini memberikan instruksi untuk mengintegrasikan [penjadwal Stonebranch](https://www.stonebranch.com/) dengan aplikasi mainframe yang dimigrasikan ke runtime layanan Modernisasi AWS Mainframe Micro Focus Enterprise. Pola ini untuk arsitek solusi, pengembang, konsultan, spesialis migrasi, dan lainnya yang bekerja dalam migrasi, modernisasi, operasi, atau. DevOps

**Hasil yang ditargetkan**

Pola ini berfokus pada penyediaan hasil target berikut:
+ Kemampuan untuk menjadwalkan, mengotomatiskan, dan menjalankan pekerjaan batch mainframe yang berjalan di layanan AWS Mainframe Modernization (Microfocus runtime) dari Stonebranch Universal Controller.
+ Pantau proses batch aplikasi dari Stonebranch Universal Controller.
+ Start/Restart/Rerun/Stopproses batch secara otomatis atau manual dari Stonebranch Universal Controller.
+ Ambil hasil proses batch AWS Mainframe Modernization.
+ Tangkap CloudWatch log [AWS](https://aws.amazon.com/cloudwatch/) dari pekerjaan batch di Stonebranch Universal Controller.

## Prasyarat dan batasan
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-prereqs"></a>

**Prasyarat**
+ Akun AWS yang aktif
+ Aplikasi Micro Focus [Bankdemo](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo_runtime.zip) dengan file job control language (JCL), dan proses batch yang diterapkan di lingkungan AWS Mainframe Modernization service (Micro Focus runtime)
+ [Pengetahuan dasar tentang cara membangun dan menyebarkan aplikasi mainframe yang berjalan di Micro Focus Enterprise Server](https://www.microfocus.com/media/data-sheet/enterprise_server_ds.pdf)
+ Pengetahuan dasar tentang Stonebranch Universal Controller
+ [Lisensi uji coba Stonebranch (hubungi Stonebranch)](https://www.stonebranch.com/)
+ Instans Windows atau Linux Amazon Elastic Compute Cloud (Amazon EC2) (misalnya, xlarge) dengan minimal empat core, memori 8 GB, dan ruang disk 2 GB
+ Apache Tomcat versi 8.5.x atau 9.0.x
+ Oracle Java Runtime Environment (JRE) atau OpenJDK versi 8 atau 11
+ [Amazon Aurora MySQL — Edisi yang Kompatibel](https://aws.amazon.com/rds/aurora/)
+ [Bucket Amazon Simple Storage Service (Amazon S3](https://aws.amazon.com/s3/)) untuk repositori ekspor
+ [Amazon Elastic File System (Amaon EFS)](https://aws.amazon.com/efs/) untuk koneksi agen Stonebranch Universal Message Service (OMS) untuk ketersediaan tinggi (HA)
+ Stonebranch Universal Controller 7.2 Agen Universal 7.2 File Instalasi
+ [Templat penjadwalan tugas](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) Modernisasi AWS Mainframe (versi rilis terbaru dari file.zip)

**Batasan**
+ Produk dan solusi telah diuji dan kompatibilitas divalidasi hanya dengan OpenJDK 8 dan 11.
+ Template penjadwalan tugas [aws-mainframe-modernization-stonebranch-integrasi](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) hanya akan berfungsi dengan layanan AWS Mainframe Modernization.
+ Template penjadwalan tugas ini hanya akan bekerja pada agen Stonebranch edisi Unix, Linux, atau Windows.
+ Beberapa layanan AWS tidak tersedia di semua Wilayah AWS. Untuk ketersediaan Wilayah, lihat [layanan AWS menurut Wilayah](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/). Untuk titik akhir tertentu, lihat halaman [titik akhir dan kuota Layanan](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html), dan pilih tautan untuk layanan.

## Arsitektur
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-architecture"></a>

**Arsitektur negara sasaran**

Diagram berikut menunjukkan contoh lingkungan AWS yang diperlukan untuk pilot ini.

![Stonebranch UAC berinteraksi dengan lingkungan AWS Mainframe Modernisasi.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/4a7bea37-0a5b-4663-902b-9b051e92f0cb.png)


1. Stonebranch Universal Automation Center (UAC) mencakup dua komponen utama: Universal Controller dan Universal Agents. Stonebranch OMS digunakan sebagai bus pesan antara pengontrol dan agen individu.

1. Stonebranch UAC Database digunakan oleh Universal Controller. Database dapat MySQL, Microsoft SQL Server, Oracle, atau Aurora MySQL — kompatibel.

1. [Layanan Modernisasi AWS Mainframe — Lingkungan runtime Micro Focus dengan aplikasi yang diterapkan. BankDemo ](https://aws.amazon.com/blogs/aws/modernize-your-mainframe-applications-deploy-them-in-the-cloud/) File BankDemo aplikasi akan disimpan dalam ember S3. Bucket ini juga berisi file JCL mainframe.

1. Stonebranch UAC dapat menjalankan fungsi-fungsi berikut untuk batch run:

   1. Mulai pekerjaan batch menggunakan nama file JCL yang ada di bucket S3 yang ditautkan ke layanan modernisasi mainframe AWS.

   1. Dapatkan status pekerjaan batch yang dijalankan.

   1. Tunggu hingga batch job run selesai.

   1. Ambil log dari pekerjaan batch yang dijalankan.

   1. Jalankan kembali pekerjaan batch yang gagal.

   1. Batalkan pekerjaan batch saat pekerjaan sedang berjalan.

1. Stonebranch UAC dapat menjalankan fungsi-fungsi berikut untuk aplikasi:

   1. Mulai Aplikasi

   1. Dapatkan Status Aplikasi

   1. Tunggu hingga Aplikasi dimulai atau dihentikan

   1. Hentikan Aplikasi

   1. Ambil Log operasi Aplikasi

**Konversi pekerjaan Stonebranch**

Diagram berikut mewakili proses konversi pekerjaan Stonebranch selama perjalanan modernisasi. Ini menjelaskan bagaimana jadwal pekerjaan dan definisi tugas diubah menjadi format yang kompatibel yang dapat menjalankan tugas batch AWS Mainframe Modernization.

![Proses dari mainframe ke konversi ke penjadwal pekerjaan di Amazon EC2 dengan file JCL di Amazon S3.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/4d2ed890-f143-455e-8180-4d967b71c494.png)


1. Untuk proses konversi, definisi pekerjaan diekspor dari sistem mainframe yang ada.

1. File JCL dapat diunggah ke bucket S3 untuk aplikasi Modernisasi Mainframe sehingga file JCL ini dapat digunakan oleh layanan AWS Mainframe Modernization.

1. Alat konversi mengonversi definisi pekerjaan yang diekspor ke tugas UAC.

1. Setelah semua definisi tugas dan jadwal pekerjaan dibuat, objek ini akan diimpor ke Universal Controller. Tugas yang dikonversi kemudian menjalankan proses di layanan AWS Mainframe Modernization alih-alih menjalankannya di mainframe.

**Arsitektur UAC Stonebranch**

Diagram arsitektur berikut merupakan active-active-passive model ketersediaan tinggi (HA) Universal Controller. Stonebranch UAC digunakan di beberapa Availability Zone untuk menyediakan ketersediaan tinggi dan mendukung pemulihan bencana (DR).

![Lingkungan multi-AZ dengan DR dan pengontrol, Amazon EFS, Aurora, dan bucket S3 untuk pencadangan.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/3f94b855-c146-4fcb-902c-5d343438a558.png)


*Pengontrol Universal*

Dua server Linux disediakan sebagai Universal Controller. Keduanya terhubung ke endpoint database yang sama. Setiap server memiliki aplikasi Universal Controller dan OMS. Versi terbaru dari Universal Controller digunakan pada saat itu disediakan.

Pengontrol Universal digunakan di webapp Tomcat sebagai ROOT dokumen dan disajikan pada port 80. Penerapan ini memudahkan konfigurasi penyeimbang beban frontend.

HTTP melalui TLS atau HTTPS diaktifkan menggunakan sertifikat wildcard Stonebranch (misalnya,). `https://customer.stonebranch.cloud` Ini mengamankan komunikasi antara browser dan aplikasi.

*OMS*

Agen Universal dan OMS (Layanan Pesan Opswise) berada di setiap server Universal Controller. Semua Agen Universal yang dikerahkan dari ujung pelanggan diatur untuk terhubung ke kedua layanan OMS. OMS bertindak sebagai layanan pesan umum antara Universal Agents dan Universal Controller.

Amazon EFS memasang direktori spool di setiap server. OMS menggunakan direktori spool bersama ini untuk menjaga koneksi dan informasi tugas dari pengontrol dan agen. OMS bekerja dalam mode ketersediaan tinggi. Jika OMS aktif turun, OMS pasif memiliki akses ke semua data, dan melanjutkan operasi aktif secara otomatis. Agen Universal mendeteksi perubahan ini dan secara otomatis terhubung ke OMS aktif baru.

*Basis Data*

Amazon Relational Database Service (Amazon RDS) menampung database UAC, dengan Amazon Aurora MySQL yang kompatibel dengan mesinnya. Amazon RDS membantu dalam mengelola dan menawarkan cadangan terjadwal secara berkala. Kedua instans Universal Controller terhubung ke endpoint database yang sama.

*Penyeimbang beban*

Application Load Balancer diatur untuk setiap instance. Penyeimbang beban mengarahkan lalu lintas ke pengontrol aktif pada saat tertentu. Nama domain instance Anda mengarah ke titik akhir penyeimbang beban masing-masing.

*URLs*

Setiap instance Anda memiliki URL, seperti yang ditunjukkan pada contoh berikut.


| 
| 
| Lingkungan | Instans | 
| --- |--- |
| **Produksi** | `customer.stonebranch.cloud` | 
| **Pengembangan (non-produksi)** | `customerdev.stonebranch.cloud` | 
| **Pengujian (non-produksi)** | `customertest.stonebranch.cloud` | 

**catatan**  
  Nama instans non-produksi dapat diatur berdasarkan kebutuhan Anda.

*Ketersediaan tinggi*

Ketersediaan tinggi (HA) adalah kemampuan sistem untuk beroperasi terus menerus tanpa kegagalan untuk jangka waktu yang ditentukan. Kegagalan tersebut termasuk, namun tidak terbatas pada, penyimpanan, penundaan respons komunikasi server yang disebabkan oleh masalah CPU atau memori, dan konektivitas jaringan.

Untuk memenuhi persyaratan HA:
+ Semua instans EC2, database, dan konfigurasi lainnya dicerminkan di dua Availability Zone terpisah dalam Wilayah AWS yang sama.
+ Pengontrol disediakan melalui Amazon Machine Image (AMI) pada dua server Linux di dua Availability Zones. Misalnya, jika Anda disediakan di Wilayah eu-west-1 Eropa, Anda memiliki Pengontrol Universal di Availability Zone eu-west-1a dan Availability Zone eu-west-1c.
+ Tidak ada pekerjaan yang diizinkan untuk berjalan langsung di server aplikasi dan tidak ada data yang diizinkan untuk disimpan di server ini.
+ Application Load Balancer menjalankan pemeriksaan kesehatan pada setiap Universal Controller untuk mengidentifikasi yang aktif dan mengarahkan lalu lintas ke sana. Jika satu server mengalami masalah, penyeimbang beban secara otomatis mempromosikan Universal Controller pasif ke status aktif. Load balancer kemudian mengidentifikasi instans Universal Controller aktif baru dari pemeriksaan kesehatan dan mulai mengarahkan lalu lintas. Failover terjadi dalam waktu empat menit tanpa kehilangan pekerjaan, dan URL frontend tetap sama.
+ Layanan database yang kompatibel dengan Aurora MySQL menyimpan data Universal Controller. Untuk lingkungan produksi, kluster database dibangun dengan dua instance database di dua Availability Zone yang berbeda dalam satu Wilayah AWS. Kedua Pengontrol Universal menggunakan antarmuka Java Database Connectivity (JDBC) yang menunjuk ke titik akhir cluster database tunggal. Jika satu instance database menimbulkan masalah, titik akhir cluster database secara dinamis menunjuk ke instance sehat. Tidak diperlukan intervensi manual.

*Backup dan bersihkan*

Stonebranch Universal Controller diatur untuk mencadangkan dan membersihkan data lama mengikuti jadwal yang ditunjukkan pada tabel.


| 
| 
| Tipe | Jadwal | 
| --- |--- |
| **Aktivitas** | 7 hari | 
| **Audit** | 90 hari | 
| **Sejarah** | 60 hari | 

Backup data yang lebih lama dari tanggal yang ditampilkan diekspor ke format.xml. dan disimpan dalam sistem file. Setelah proses pencadangan selesai, data lama akan dihapus dari database dan diarsipkan dalam bucket S3 hingga satu tahun untuk instance produksi.

Anda dapat menyesuaikan jadwal ini di antarmuka Universal Controller Anda. Namun, peningkatan kerangka waktu ini dapat menyebabkan waktu henti yang lebih lama selama pemeliharaan.

## Alat
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-tools"></a>

**Layanan AWS**
+ [AWS Mainframe Modernization](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html) adalah platform cloud-native AWS yang membantu Anda memodernisasi aplikasi mainframe ke lingkungan runtime yang dikelola AWS. Ini menyediakan alat dan sumber daya untuk membantu Anda merencanakan dan menerapkan migrasi dan modernisasi.
+ [Amazon Elastic Block Store (Amazon EBS)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AmazonEBS.html) menyediakan volume penyimpanan tingkat blok untuk digunakan bersama dengan instans Amazon EC2 Anda.
+ [Amazon Elastic File System (Amazon EFS)](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html) membantu Anda membuat dan mengonfigurasi sistem file bersama di AWS Cloud.
+ [Amazon Relational Database Service (Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Welcome.html)) membantu Anda menyiapkan, mengoperasikan, dan menskalakan database relasional di AWS Cloud. Pola ini menggunakan Amazon Aurora MySQL-Compatible Edition.
+ [Amazon Simple Storage Service (Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)) adalah layanan penyimpanan objek berbasis cloud yang membantu Anda menyimpan, melindungi, dan mengambil sejumlah data.
+ [Elastic Load Balancing (ELB)](https://docs.aws.amazon.com/elasticloadbalancing/latest/userguide/what-is-load-balancing.html) mendistribusikan lalu lintas aplikasi atau jaringan yang masuk ke beberapa target. Misalnya, Anda dapat mendistribusikan lalu lintas di seluruh instans, kontainer, dan alamat IP Amazon EC2 di satu atau beberapa Availability Zone. Pola ini menggunakan Application Load Balancer.

**Stonebranch**
+ [Universal Automation Center (UAC)](https://stonebranchdocs.atlassian.net/wiki/spaces/SD/pages/239239169/Universal+Automation+Center) adalah sistem produk otomatisasi beban kerja perusahaan. Pola ini menggunakan komponen UAC berikut:
  + [Universal Controller](https://www.stonebranch.com/documentation-universal-controller), aplikasi web Java yang berjalan di wadah web Tomcat, adalah penjadwal pekerjaan perusahaan dan solusi broker otomatisasi beban kerja dari Universal Automation Center. Controller menyajikan antarmuka pengguna untuk membuat, memantau, dan mengkonfigurasi informasi Controller; menangani logika penjadwalan; memproses semua pesan ke dan dari Agen Universal; dan menyinkronkan banyak operasi ketersediaan tinggi Universal Automation Center.
  + [Universal Agent adalah agen](https://www.stonebranch.com/documentation-universal-agent) penjadwalan independen vendor yang berkolaborasi dengan penjadwal pekerjaan yang ada di semua platform komputasi utama, baik warisan maupun terdistribusi. Semua penjadwal yang berjalan diz/Series, i/Series, Unix, Linux, atau Windows didukung.
+ [Universal Agent adalah agen](https://www.stonebranch.com/documentation-universal-agent) penjadwalan independen vendor yang berkolaborasi dengan penjadwal pekerjaan yang ada di semua platform komputasi utama, baik warisan maupun terdistribusi. Semua penjadwal yang berjalan diz/Series, i/Series, Unix, Linux, atau Windows didukung.
+ [Stonebranch aws-mainframe-modernization-stonebranch -integration AWS Mainframe Modernization Universal](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) Extension adalah template integrasi untuk menjalankan, memantau, dan menjalankan kembali pekerjaan batch di platform AWS Mainframe Modernization.

**Kode**

Kode untuk pola ini tersedia di GitHub repositori [aws-mainframe-modernization-stonebranch-integration](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases/).

## Epik
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-epics"></a>

### Instal Pengontrol Universal dan Agen Universal di Amazon EC2
<a name="install-universal-controller-and-universal-agent-on-amazon-ec2"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Unduh file instalasi. | Unduh instalasi dari server Stonebranch. Untuk mendapatkan file instalasi, kontak dengan Stonebranch. | Arsitek awan | 
| Luncurkan instans EC2. | Anda akan membutuhkan sekitar 3 GB ruang ekstra untuk instalasi Universal Controller dan Universal Agent. Jadi sediakan setidaknya 30 GB ruang disk untuk instance.<br />Tambahkan port 8080 ke grup keamanan sehingga dapat diakses. | Arsitek awan | 
| Periksa prasyarat. | Sebelum instalasi, lakukan hal berikut:1. Instal Java seperti yang dijelaskan dalam [Mengunduh Java Runtime Environment](https://www.stonebranch.com/documentation-java-runtime).<pre>$ sudo yum -y update<br />$ sudo yum install java-11-amazon-corretto</pre><br />Pastikan untuk menggunakan salah satu versi JAVA yang didukung. Perintah sebelumnya harus menginstal java-11. Periksa versi Java dan pastikan Anda menggunakan versi 11 sebelum melanjutkan.<br />2. Seperti yang dijelaskan dalam [Menginstal Apache Tomcat](https://www.stonebranch.com/documentation-apache-tomcat), jalankan perintah berikut.<pre>$ sudo yum install tomcat tomcat-admin-webapps<br />$ sudo systemctl enable tomcat<br />$ sudo systemctl start tomcat</pre><br />3. Buat database Amazon Aurora seperti yang dijelaskan dalam [Membuat dan menghubungkan ke cluster DB MySQL Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_GettingStartedAurora.CreatingConnecting.Aurora.html). Gunakan Amazon Aurora Edisi yang kompatibel dengan MySQL.<br />Pilih nama pengguna Master dan kata sandi Master. Simpan nilai default untuk sisa pengaturan. | Administrator cloud, administrator Linux | 
| Instal Pengontrol Universal. | 1. Unggah file `universal-controller-7.2.0.0.tar`**** instalasi ke instans EC2.<br />2. Buka arsip file instalasi ke `temp` folder.<pre>$ tar -xvf universal-controller-7.2.0.0.tar</pre><br />3. Berikan izin menjalankan skrip instalasi.<pre>$ chmod a+x install-controller.sh</pre><br />4. Pasang pengendali. Contoh ini menggunakan perintah berikut untuk menginstal Universal Controller di bawah `/usr/share/tomca` t. Gunakan database Amazon Aurora yang Anda buat di langkah sebelumnya.<pre>$ sudo ./install-controller.sh --tomcat-dir /usr/share/tomcat/ --controller-file universal-controller-7.2.0.0-build.145.war --dbuser admin --dbpass "****" --dbname uc --rdbms mysql --dburl jdbc:mysql://database-2-instance-1.cih63miincgy.us-east-1.rds.amazonaws.com:3306/</pre><br />Baris terakhir dari output skrip harus “Instalasi selesai.”<br />5. Arahkan ke URL berikut di instans EC2.<pre>http://<public_ip>:8080/uc</pre><br />6. Pada layar login, masukkan **ops.admin** di bagian **Nama Pengguna**, dan biarkan bidang **Kata Sandi kosong**.<br />7. Tetapkan kata sandi baru untuk `ops.admin` pengguna. | Arsitek cloud, administrator Linux | 
| Instal Agen Universal. | 1. Unggah file `sb-7.2.0.1-linux-3.10-x86_64.tar.Z` instalasi ke instans EC2.<br />2. Masuk ke instans EC2.<br />3. Buka arsip paket instalasi Agen Universal.<pre>$ zcat sb-7.2.0.1-linux-3.10-x86_64.tar.Z | tar xvf –</pre><br />4. Jalankan perintah berikut.<pre>$ sudo ./unvinst --oms_servers 7878@localhost --oms_autostart yes --python yes</pre><br />5. Buat file PAM.<pre>$ cp /etc/pam.d/login /etc/pam.d/ucmd</pre><br />6. Aktifkan Autostart untuk Agen Universal.<pre>$ /sbin/restorecon -v /etc/rc.d/init.d/ubrokerd</pre> | Administrator cloud, administrator Linux | 
| Tambahkan OMS ke Universal Controller. | 1. Masuk ke Universal Controller dengan `ops.admin` pengguna.<br />2. Pilih menu **Layanan** di sudut kiri atas layar, lalu pilih menu **Server OMS** di **Sistem**<br />3. Di bidang Alamat Server OMS, ketik`localhost`, lalu simpan.<br />4. Anda akan melihat status server OMS sebagai **Terhubung** dan **Status Sesi** sebagai **Operasional**. | Administrator Pengontrol Universal | 

### Impor AWS Mainframe Modernization Universal Extension dan buat tugas
<a name="import-aws-mainframe-modernization-universal-extension-and-create-a-task"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Templat Integrasi Impor. | Untuk langkah ini, Anda memerlukan [AWS Mainframe Modernization](https://github.com/aws-samples/aws-mainframe-modernization-stonebranch-integration/releases) Universal Extension. Pastikan versi rilis terbaru dari file.zip diunduh.1. Masuk ke Universal Controller dengan `ops.admin` pengguna.<br />2. Arahkan ke **Layanan**, **Template Integrasi Impor**.<br />3. Pilih file Integration Template .zip (`aws_mainframe_modernization_stonebranch_extension.zip`), dan pilih **Impor**.<br />**Setelah Template Integrasi diimpor, Anda akan melihat **Tugas Modernisasi AWS Mainframe** di bawah Layanan yang Tersedia.** | Administrator Pengontrol Universal | 
| Aktifkan kredenal yang dapat diselesaikan. | 1. Arahkan ke **Layanan**, Tugas **Modernisasi AWS Mainframe**.<br />2. Di panel kanan, isi bidang yang diperlukan:**Nama**: Tugas Modernisasi Mainframe Baru**Agen**: Pilih satu-satunya agen (AGNT0001).<br />Di bawah **Detail Modernisasi AWS Mainframe**:**Tindakan**: Daftar Lingkungan**AWS Credentials**: Jika Anda memiliki peran AWS Identity and Access Management (IAM) yang ditambahkan ke instans EC2, Anda dapat membiarkan bidang ini kosong. Jika Anda akan menggunakan `AWSAccessKeyID` dan`AWSSecretKey`, pilih ikon **()** di sebelah bidang.<br />Di jendela **Credential Details** yang terbuka, masukkan informasi berikut dan kemudian simpan.**Nama: Kredensial** Modernisasi AWS Mainframe**Pengguna Runtime**: Tulis ID kunci akses AWS di bidang ini.**Kata Sandi Runtime**: Tulis kunci rahasia AWS di bidang ini.**Titik Akhir**:**** Pastikan titik akhir memiliki Wilayah AWS yang benar. Nilai default-nya `https://m2.us-east-1.amazonaws.com`.**Wilayah**: Masuk ke Wilayah layanan Modernisasi AWS Mainframe. Nilai default-nya `us-east-1`.<br />3. Simpan nilai default di bidang lainnya, dan simpan tugas. | Administrator Pengontrol Universal | 
| Luncurkan tugas. | 1. Di bagian atas panel kanan, pilih **Launch Task**.<br />2. Di jendela **Konfirmasi**, pilih **Luncurkan**. Setelah itu, Universal Controller Console akan menampilkan pesan yang mirip dengan pesan berikut.<br />*2022-08-24 10:11:49*<br />*Berhasil meluncurkan tugas Universal “Tugas Modernisasi Mainframe Baru” dengan instance tugas sys\_id 1661291493634146313 E38 OZJY. NC8 DB8*<br />3. Arahkan ke **Instans** Jika Anda tidak melihat tab **Instans**, pilih panah kanan untuk menggulir ke kanan.<br />4. **Buka menu konteks (klik kanan) untuk instance tugas dalam daftar, pilih **Ambil Output**, lalu pilih **Kirim** di Ambil Output**<br />5. Di jendela **Retrieve Output**, Anda akan melihat daftar lingkungan di STDOUT. | Administrator Pengontrol Universal | 

### Uji memulai pekerjaan batch
<a name="test-starting-a-batch-job"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Buat tugas untuk pekerjaan batch. | 1. Arahkan ke **Layanan**, Tugas **Modernisasi AWS Mainframe**.<br />2. Di panel kanan, isi bidang yang diperlukan:**Nama**: Tugas Modernisasi Mainframe Baru**Agen**: Pilih satu-satunya agen (AGNT0001).<br />Di bawah **Detail Modernisasi AWS Mainframe**:**Tindakan**: Mulai Batch (atau Mulai Batch dan Tunggu untuk menjalankan pekerjaan batch dan menunggu hingga tugas selesai di AWS)**AWS Credentials**: Jika Anda memiliki peran IAM yang ditambahkan ke instans EC2, Anda dapat membiarkan bidang ini kosong. Jika Anda akan menggunakan `AWSAccessKeyID` dan`AWSSecretKey`, pilih ikon **()** di sebelah bidang.**Titik Akhir**:**** Pastikan titik akhir memiliki Wilayah AWS yang benar. Nilai default-nya [https://m2.us-east-1.amazonaws.com](https://m2.us-east-1.amazonaws.com).**Wilayah**: Masuk ke Wilayah layanan Modernisasi AWS Mainframe. Nilai default-nya `us-east-1`.**Aplikasi**: Pilih ikon di sebelah bidang **()**, dan pilih **Kirim** di **Refresh Application Choices**. Ini akan terhubung ke layanan AWS Mainframe Modernization dan mengembalikan daftar aplikasi. Sekarang Anda dapat memilih aplikasi dari daftar dropdown. Pilih aplikasi yang ingin Anda jalankan pekerjaan batch.**Nama File JCL**: `RUNHELLO.jcl`**Tunggu Sukses atau Kegagalan**:**** Jika opsi ini dipilih, tugas akan menunggu hingga status pekerjaan batch berhasil atau gagal.**Interval Polling**: Ini adalah jumlah waktu antara setiap polling.**Ambil Log Eksekusi**: Jika dipilih, log akan diambil secara otomatis ketika pekerjaan batch telah selesai.**Format Log**: Ini adalah format log yang akan dicetak. Ini bisa berupa format Teks atau JSON.<br />3. Simpan nilai default di bidang lainnya, dan simpan tugas. | Administrator Pengontrol Universal | 
| Luncurkan tugas. | 1. Di bagian atas panel kanan, pilih **Launch Task**.<br />2. Di jendela **Konfirmasi**, pilih **Luncurkan**. Setelah itu, Universal Controller Console akan menampilkan pesan yang mirip dengan pesan berikut.<br />*2022-08-24 11:11:59*<br />*Berhasil meluncurkan tugas Universal “Batch Mulai Modernisasi Mainframe” dengan instance tugas sys\_id.* <sys id><br />3. Arahkan ke **Instans** Jika Anda tidak melihat tab **Instans**, pilih panah kanan untuk menggulir ke kanan.<br />4. **Buka menu konteks (klik kanan) untuk instance tugas dalam daftar, pilih **Ambil Output**, lalu pilih **Kirim** di Ambil Output**<br />5. Di jendela **Retrieve Output**, Anda akan melihat daftar lingkungan di STDOUT. | Administrator Pengontrol Universal | 

### Buat alur kerja untuk beberapa tugas
<a name="create-a-workflow-for-multiple-tasks"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Salin tugas. | 1. Buka menu konteks (klik kanan) untuk tugas yang ingin Anda buat salinannya, dan pilih **Salin**.<br />2. *Di jendela **Copy AWS Mainframe Modernization Task**, masukkan nama baru berikut untuk tugas baru: Batch Mulai Modernisasi Mainframe -. RUNAWS2*<br />3. *Salin tugas lagi, menggunakan nama berikut: Modernisasi Mainframe Mulai Batch -. RUNAWS3*<br />4. *Salin dengan tugas lagi, menggunakan nama berikut: Modernisasi Mainframe Mulai Batch -. RUNAWS4*<br />5. *Salin tugas terakhir kali, menggunakan nama berikut: Modernisasi Mainframe Mulai Batch - FOOBAR.* | Administrator Pengontrol Universal | 
| Perbarui tugas. | 1. Buka (klik dua kali) Batch Mulai Modernisasi Mainframe RUNAWS2 - tugas, ubah bidang `RUNAWS2.jcl` Nama **File JCL menjadi**, dan simpan.<br />2. *Buka (klik dua kali) Batch Mulai Modernisasi Mainframe RUNAWS3 - tugas, ubah bidang `RUNAWS3.jcl` Nama **File JCL menjadi**, dan simpan.*<br />3. *Buka (klik dua kali) Batch Mulai Modernisasi Mainframe RUNAWS4 - tugas, ubah bidang `RUNAWS4.jcl` Nama **File JCL menjadi**, dan simpan.*<br />4. *Buka (klik dua kali) tugas Batch Mulai Modernisasi Mainframe - FOOBAR, ubah bidang Nama **File JCL menjadi**, dan simpan. `MISSING.jcl`* **Tugas ini akan gagal karena nilai Nama File JCL salah.** | Administrator Pengontrol Universal | 
| Buat alur kerja. | 1. Arahkan ke **Layanan**, **Alur Kerja**.<br />2. Di panel kanan, masukkan **Alur Kerja Modernisasi Mainframe** di bidang **Nama, dan simpan**.<br />3. Di panel kanan, pilih **Edit Alur Kerja**.<br />4. Pada **Tab Editor Alur Kerja**, tombol **Tambahkan Tugas** **(\+)**.<br />5. Di jendela **Task Find**, pilih **Cari** untuk melihat semua tugas di Universal Controller.<br />6. **Klik ikon di samping Modernisasi Mainframe Start Batch Task, dan seret ikon ke tempat kosong di Workflow Editor.**<br />7. Ulangi tindakan yang sama untuk tugas Modernisasi Mainframe lainnya dan letakkan seperti yang ditunjukkan di bagian Informasi *tambahan*.<br />8. Pilih tombol **Connect** **()**, dan hubungkan tugas bersama-sama. Untuk menghubungkan tugas dengan tugas lain, klik di tengah tugas, dan seret ke tugas target.<br />9. Hubungkan tugas seperti yang ditunjukkan di bagian *Informasi tambahan*, dan simpan alur kerja.<br />10. **Klik kanan tempat kosong di Editor Alur Kerja, pilih **Luncurkan Alur Kerja**, lalu pilih OK.** | Administrator Pengontrol Universal | 
| Periksa status alur kerja. | 1. Di menu sebelah kiri, pilih **Aktivitas**<br />2. Di tengah jendela, pilih **Mulai**.<br />Anda akan melihat daftar contoh tugas dalam daftar.<br />3. **Buka (klik dua kali) Alur Kerja Modernisasi Mainframe dalam daftar, atau buka menu konteks (klik kanan) dan pilih Perintah Tugas Alur Kerja, Lihat **Alur Kerja**.**<br />Anda akan melihat tugas seperti yang ditunjukkan di bagian Informasi tambahan. Tugas kedua diharapkan gagal karena Anda menggunakan file JCL yang hilang. | Administrator Pengontrol Univeral | 

### Memecahkan masalah pekerjaan batch yang gagal dan jalankan kembali
<a name="troubleshoot-failed-batch-jobs-and-rerun"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Perbaiki tugas yang gagal dan jalankan kembali. | 1. Buka (klik dua kali) tugas yang gagal untuk melihat kesalahan tugas.<br />2. Anda memiliki dua opsi untuk memperbaiki tugas yang gagal.Perbaiki nama file JCL, dan atur ke`FOOBAR.jcl`.Tambahkan nama file JCL yang benar ke **JCL File Name (Temp)**. Bidang ini akan menimpa bidang **Nama File JCL**.<br />Untuk pilot ini, pilih opsi kedua, dan simpan instance tugas.<br />3. **Di **Workflow Monitor**, buka menu konteks (klik kanan) untuk tugas yang gagal, dan pilih **Command**, Re-run.**<br />4. Setelah itu, semua tugas akan selesai dengan sukses. | Administrator Pengontrol Universal | 

### Buat Mulai Aplikasi dan Hentikan tugas Aplikasi
<a name="create-start-application-and-stop-application-tasks"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Buat tindakan Mulai Aplikasi. | 1. Arahkan ke **Layanan**, Tugas **Modernisasi AWS Mainframe**.<br />2. Di panel kanan, isi bidang yang diperlukan.**Nama**: Modernisasi Mainframe Mulai Aplikasi**Agen**: Pilih satu-satunya agen (AGNT0001)<br />Di bawah **Detail Modernisasi AWS Mainframe**:**Tindakan**:**** Mulai Aplikasi**AWS Credentials**: Jika Anda memiliki peran IAM yang ditambahkan ke instans EC2, Anda dapat membiarkan bidang ini kosong. Jika Anda akan menggunakan `AWSAccessKeyID` dan`AWSSecretKey`, pilih kredensi yang Anda buat sebelumnya.**Titik Akhir**:**** Pastikan titik akhir memiliki Wilayah yang benar. Nilai default-nya `https://m2.us-east-1.amazonaws.com`.**Wilayah**: Masuk ke Wilayah layanan Modernisasi AWS Mainframe. Nilai default-nya `us-east-1`.**Aplikasi**: Pilih ikon di sebelah bidang **()**, dan pilih **Kirim** di **Refresh Application Choices**. Ini akan terhubung ke layanan AWS Mainframe Modernization dan mengembalikan daftar aplikasi. Sekarang Anda dapat memilih aplikasi dari daftar dropdown. Pilih aplikasi yang ingin Anda jalankan pekerjaan batch.**Tunggu Sukses atau Kegagalan**:**** Jika opsi ini dipilih, tugas akan menunggu hingga status pekerjaan batch berhasil atau gagal.**Interval Polling**: Ini adalah jumlah waktu antara setiap polling.**Ambil Log Eksekusi**: Jika dipilih, log akan diambil secara otomatis ketika pekerjaan batch telah selesai.**Format Log:** Ini adalah format log yang akan dicetak. Ini bisa berupa format Teks atau JSON.<br />3. Simpan nilai default di bidang lainnya, dan simpan tugas.<br />4. Sekarang salin tugas ini dan buat tugas untuk Stop Application. **Ubah nama menjadi **Mainframe Moderinization Stop Application**, dan ubah action menjadi Stop Application.** | Administrator Pengontrol Universal | 

### Membuat tugas Batalkan Eksekusi Batch
<a name="create-a-cancel-batch-execution-task"></a>


| Tugas | Deskripsi | Keterampilan yang dibutuhkan | 
| --- | --- | --- | 
| Buat tindakan Batch Batch. | 1. Arahkan ke **Layanan**, Tugas **Modernisasi AWS Mainframe**.<br />2. Di panel kanan, isi bidang yang diperlukan.**Nama**: Modernisasi Mainframe Batalkan Eksekusi Batch**Agen**: Pilih satu-satunya agen (AGNT0001)<br />Di bawah **Detail Modernisasi AWS Mainframe**:**Tindakan**:**** Batalkan Eksekusi Batch**AWS Credentials**: Jika Anda memiliki peran IAM yang ditambahkan ke instans EC2, Anda dapat membiarkan bidang ini kosong. Jika Anda akan menggunakan `AWSAccessKeyID` dan`AWSSecretKey`, pilih kredensi yang Anda buat sebelumnya.**Titik Akhir**:**** Pastikan titik akhir memiliki Wilayah yang benar. Nilai default-nya `https://m2.us-east-1.amazonaws.com`.**Wilayah**: Masuk ke Wilayah layanan Modernisasi AWS Mainframe. Nilai default-nya `us-east-1`.**Aplikasi**: Pilih ikon di sebelah bidang **()**, dan pilih **Kirim** di **Refresh Application Choices**. Ini akan terhubung ke layanan AWS Mainframe Modernization dan mengembalikan daftar aplikasi. Sekarang Anda dapat memilih aplikasi dari daftar dropdown. Pilih aplikasi yang ingin Anda jalankan pekerjaan batch.**Tunggu Sukses atau Kegagalan**:**** Jika opsi ini dipilih, tugas akan menunggu hingga status pekerjaan batch berhasil atau gagal.**Interval Polling**: Ini adalah jumlah waktu antara setiap polling.**Ambil Log Eksekusi**: Jika dipilih, log akan diambil secara otomatis ketika pekerjaan batch telah selesai.**Format Log**: Ini adalah format log yang akan dicetak. Ini bisa berupa format Teks atau JSON.<br />3. Simpan nilai default di bidang lainnya, dan simpan tugas. |  | 

## Sumber daya terkait
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-resources"></a>
+ [Pengontrol Universal](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/overview)
+ [Agen Universal](https://stonebranchdocs.atlassian.net/wiki/spaces/UA77/overview)
+ [Pengaturan LDAP](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794552355/LDAP+Settings)
+ [SALL Single Sign-On](https://stonebranchdocs.atlassian.net/wiki/spaces/UC77/pages/794553130/SAML+Single+Sign-On)
+ [Alat Konversi Xpress](https://www.stonebranch.com/resources/xpress-conversion-windows)

## Informasi tambahan
<a name="integrate-stonebranch-universal-controller-with-aws-mainframe-modernization-additional"></a>

**Ikon di Editor Alur Kerja**

![RUNHELLO tugas di atas, FOOBAR di tengah, dan tugas yang tersisa di tingkat ketiga.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/837430ee-3159-4fe2-8e17-65168294ef1e.png)


**Semua tugas terhubung**

![RUNHELLO terhubung ke FOOBAR, yang terhubung ke tiga tugas yang tersisa.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/fe483348-9a6f-450b-87e6-ceae6b2bdaad.png)


**Status alur kerja**

![Tugas FOOBAR gagal dan tiga tugas lainnya sedang menunggu.](https://docs.aws.amazon.com/id_id/prescriptive-guidance/latest/patterns/images/pattern-img/01c6f9fa-87e6-459a-b694-5e03dd7f7952/images/5ea4e239-fbbe-4fa4-9ffa-b7a9443b7975.png)
