Skip to content

Commit

Permalink
minor language/formatting refactor for v2.18
Browse files Browse the repository at this point in the history 
Signed-off-by: Andrew Jandacek <[email protected]>
  • Loading branch information
@janan07
janan07 committed Nov 27, 2024
1 parent 49e5ae4 commit 01766a0
Show file tree
Hide file tree
Showing 2 changed files with 22 additions and 17 deletions.
24 changes: 14 additions & 10 deletions versioned_docs/version-v2.18.x/user-guide/install-zowe-pswi-acquire.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -4,23 +4,27 @@ As a systems programmer, you can acquire an IBM z/OSMF portable package for your

When you complete the acquisition process, the product software is ready for installation using z/OSMF Deployments.

- **Note**: Before you begin the acquisition process, ensure that you address the z/OSMF requirements.
:::note
Before you begin the acquisition process, ensure that you address the z/OSMF requirements.
:::

The z/OSMF product acquisition process consists of 2 tasks.

1. Download the portable software instance from Zowe downloads and transfer it to the mainframe.
1. Download the portable software instance from Zowe downloads and transfer the instance to the mainframe.
2. Register the portable software instance in z/OSMF.

## Download the Portable Software Instance from Zowe Downloads

The portable software instance is a portable form of a software instance, including the SMP/E CSI data sets, all associated SMP/E-managed target and distribution libraries, non-SMP/E-managed data sets, and meta-data that is required to describe the product software instance.

To acquire the portable software instance, you can download it from the Zowe Downloads page and transfer it to a local z/OSMF host using a file transfer utility, such as FTP.
To acquire the portable software instance, you can download it from the Zowe Downloads page and transfer the instance to a local z/OSMF host using a file transfer utility, such as FTP.

1. Go to [Zowe Downloads](https://www.zowe.org/download.html) and find **Zowe - Portable Software Instance**.
2. Download the latest version of the package to your workstation.
3. Use an file transfer utility such as an FTP client to transfer the single pax file to the mainframe.
4. Execute the JCL to unpack the installation file and restore the individual pax files. Sample JCL follows:
4. Execute the JCL to unpack the installation file and restore the individual pax files.

**Sample JCL:**

```jcl
//USSBATCH EXEC PGM=BPXBATCH
Expand All @@ -32,30 +36,30 @@ To acquire the portable software instance, you can download it from the Zowe Dow
/*
```

1. Customize the sample JCL as follows and then submit for execution:
5. Customize the sample JCL as follows and then submit for execution:

1. Add a JOB statement.
2. Update the USS directory (*yourUSSpaxdirectory*) with the path name where you want to copy the pax file.
3. Update *yourpaxfilename* with the name of the pax file that you want to copy to the mainframe.

:::tip Expected results:
USSBATCH can take several minutes to execute. You will receive a return code of 0 if this job runs correctly.
USSBATCH can take several minutes to execute. You will receive a return code of `0` if this job runs correctly.
:::

After successful execution, the individual pax files are restored and ready for use. Next step is to Register Portable Software Instance in z/OSMF.
After successful execution, the individual pax files are restored and ready for use. The next step is to register the Portable Software Instance in z/OSMF.

## Register Portable Software Instance in z/OSMF

After you have acquired and downloaded the portable software instance to a local z/OSMF host system, you must log in to z/OSMF to register the product software and define the portable software instance to z/OSMF as shown in the following procedure. When you complete these steps, the portable software instance is registered in z/OSMF and ready for installation (deployment).
After you have acquired and downloaded the portable software instance to a local z/OSMF host system, it is necessary to log in to z/OSMF to register the product software and define the portable software instance to z/OSMF as shown in the following procedure. When you complete these steps, the portable software instance is registered in z/OSMF and ready for installation (deployment).

1. Log in to the z/OSMF web interface and select your user ID in the top or bottom right-hand corner to switch between the Desktop Interface and Classic Interface.
2. Complete **either** of the following steps to display the Software Management page:
1. In the Desktop Interface, select **Software Management**.
2. In the Classic Interface, select **Software**, **Software Management**.
3. Select **Portable Software Instances** to define your portable software instance to z/OSMF.
4. Select **Add** from the Actions menu and select **From z/OSMF System**. Then the Add Portable Software Instance page should display.
4. Select **Add** from the Actions menu and select **From z/OSMF System**. The _Add Portable Software Instance_ page should display.
5. Select or type the system name (destination LPAR) and UNIX directory (destination USS directory) where the portable software instance files reside and select **Retrieve**.
6. Enter a name for the new portable software instance. You can also enter an optional description and assign one or more categories that display existing packages.
7. Select **OK**.

Now the new portable software instance is defined to z/OSMF. And the portable software instance is now registered in z/OSMF and ready to install (deploy).
The new portable software instance is now defined to z/OSMF. The portable software instance is registered in z/OSMF and ready to install (deploy).
15 changes: 8 additions & 7 deletions versioned_docs/version-v2.18.x/user-guide/install-zowe-pswi-deployment.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ Before installing, ensure the [z/OSMF requirements](install-zowe-pswi-address-re
## Installing process

1. Display the Deployments table in z/OSMF (**Software ManagementU**, **Deployments**).
2. Define a new deployment by selecting **New** from the Actions menu. The deployment checklist displays, where you can also modify, view, copy, cancel, or remove existing deployments.
2. Define a new deployment by selecting **New** from the Actions menu. The deployment checklist displays where you can also modify, view, copy, cancel, or remove existing deployments.
3. Complete the deployment checklist items as described in _Defining new deployments_ in the IBM documentation. As you complete the deployment checklist, be sure to make the following selections:
1. Specify the properties for this deployment (name, description, and optional category).

Expand All @@ -45,17 +45,18 @@ Before installing, ensure the [z/OSMF requirements](install-zowe-pswi-address-re

**Note:** If the target system for the deployment is in a JES Multi-Access Spool (MAS) and the mount point is only accessible from the target system, add a System Affinity (SYSAFF) to the job card to ensure execution on the system where the zFS resides.

7. Submit the deployment jobs in sequential order, wait for each job to complete, and then select **Refresh** to register job completion in z/OSMF.
7. Submit the deployment jobs in sequential order, wait for each job to complete, and then select **Refresh** to register job completion in z/OSMF.

:::tip Expected results:
You will receive a return code of 0 if this job runs correctly. When all deployment jobs are executed successfully, you have unzipped, renamed and copied the product data sets, updated the CSI data set, and specified the properties for the target software instance.
You will receive a return code of `0` if this job runs correctly. When all deployment jobs are executed successfully, you have unzipped, renamed and copied the product data sets, updated the CSI data set, and specified the properties for the target software instance.
:::

8. Complete **Mount Workflow** to mount the Zowe zFS. Complete both steps in the workflow. Perform the following steps to execute each step individually:
1. Click the title of the step.
2. Select the Perform tab.
2. Select the **Perform** tab.
3. Review the step contents and update the JCL if needed.
4. Select Next.
5. Repeat the previous two steps to complete all items until the Finish option is available.
4. Select **Next**.
5. Repeat the previous two steps to complete all items until the **Finish** option is available.

9. (Optional) To configure your Zowe instance, follow the procedure in [Configuring Zowe with z/OSMF Workflows](configure-zowe-zosmf-workflow.md).

Expand All @@ -70,7 +71,7 @@ The deployment process is complete. The new software instance is defined to z/OS

### Cleanup

If the job execution fails, the deployment process does not perform a full cleanup of the datasets, before attempting it again, make sure the following datasets are deleted:
If the job execution fails, the deployment process does not perform a full cleanup of the datasets, before attempting job execution again, make sure the following datasets are deleted:

```plaintext
{TARGET_HLQ}.D.AZWEAUTH.#
Expand Down

0 comments on commit 01766a0

Please sign in to comment.