Skip to content

Commit 630e888

Browse files
authored
Merge pull request #230 from IBM/feature/documentation
Update customer documentation
2 parents 41444f0 + 7f7b579 commit 630e888

File tree

2 files changed

+36
-12
lines changed

2 files changed

+36
-12
lines changed

packages/gatsby-docs/src/pages/run/running_the_tool.mdx

Lines changed: 25 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,18 +11,32 @@ Warning: Remember that the temporary output folder is wiped when the UI Upgrade
1111
</InlineNotification>
1212

1313
1. Run `chmod -R 777 <output folder>`so that Docker can interact with the temporary output folder. For example, `c:\temp\upgrade` or `/tmp/upgrade`.
14+
15+
1416
2. Run the tool:
15-
- (Windows ™️) `spm-ui-upgrade-helper.bat <version> <input folder> <output folder>`
16-
- (Linux ®️) `./spm-ui-upgrade-helper.sh <version> <input folder> <output folder>`
17-
- Where:
18-
- `<version>` is typically "latest".
19-
- `<input folder>` is the absolute path to the root of your 7.0.11.0 development environment.
20-
- `<output folder>` is the absolute path to your temporary output folder.
21-
2. Open your browser to http://localhost:3000.
22-
3. Press `F1` or `cmd + shift + p`.
23-
4. Type "Run SPM UI Upgrade Helper" and click on the shortcut. The files in `<input folder>` are scanned and the results are placed in `<output folder>`.
24-
5. Wait a few minutes for the tool to finish.
25-
6. Click the `Source Control: Git` button on the left sidebar to inspect the changes.
17+
- (Windows ™️)<br />
18+
Set INPUT_FOLDER=`<INPUT_FOLDER>`<br />
19+
Set OUTPUT_FOLDER=`<OUTPUT_FOLDER>`<br />
20+
Set VERSION=`<VERSION>`
21+
22+
spm-ui-upgrade-helper.bat
23+
24+
- (Linux ®️) <br />
25+
export INPUT_FOLDER=`<INPUT_FOLDER>`<br />
26+
export OUTPUT_FOLDER=`<OUTPUT_FOLDER>`<br />
27+
export VERSION=`<VERSION>`
28+
29+
sh spm-ui-upgrade-helper.sh
30+
31+
VERSION is typically “latest”.<br />
32+
INPUT_FOLDER is the absolute path to the root of your 7.0.11.0 development environment. <br />
33+
OUTPUT_FOLDER is the absolute path to your temporary output folder. <br />
34+
35+
3. Open your browser to http://localhost:8000.
36+
4. Press `F1` or `cmd + shift + p`.
37+
5. Type "Run SPM UI Upgrade Helper" and click on the shortcut. The files in `<input folder>` are scanned and the results are placed in `<output folder>`.
38+
6. Wait a few minutes for the tool to finish.
39+
7. Click the `Source Control: Git` button on the left sidebar to inspect the changes.
2640

2741
![1. Press F1, 2. Type "Run SPM UI Upgrade Helper", 3. Select the shortcut, 4. Wait for the tool to finish, 5. Click "Source Control: Git" to see the output](../../images/upgrade-helper.gif "Running the UI Upgrade Helper tool")
2842

packages/gatsby-docs/src/pages/setup/customer_setup.mdx

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,9 @@ After installation, you must configure Docker Desktop to provide access to certa
3535

3636
## Downloading the tool
3737

38-
1. Run `docker login`.
38+
1. Run `docker login`.
39+
40+
3941
2. Download the batch file or shell script:
4042

4143
(Windows ™️) `curl -L https://raw.githubusercontent.com/IBM/spm-ui-upgrade-helper/main/spm-ui-upgrade-helper.bat -o spm-ui-upgrade-helper.bat`
@@ -44,6 +46,14 @@ After installation, you must configure Docker Desktop to provide access to certa
4446

4547
3. (Linux ®️) Make the shell script executable with `chmod +x spm-ui-upgrade-helper.sh`
4648

49+
50+
4. Download docker-compose.yml file:
51+
52+
(Windows ™️) `curl -L https://raw.githubusercontent.com/IBM/spm-ui-upgrade-helper/main/docker-compose.yml -o docker-compose.yml`
53+
54+
(Linux ®️) `curl -L https://raw.githubusercontent.com/IBM/spm-ui-upgrade-helper/main/docker-compose.yml -o docker-compose.yml`
55+
56+
4757
## Ignoring files
4858

4959
You can ignore any files that you do not want to be affected by the tool by creating a file called `.spm-uiuh-ignore` that contains folders or patterns to ignore.

0 commit comments

Comments
 (0)